Classes
struct	create_section

struct	delete_section

class	has_id
	To be used as a function object to locate sections and topics with a specified ID. More...

class	help_browser
	A help browser widget. More...

struct	help_manager

class	help_menu
	The menu to the left in the help browser, where topics can be navigated through and chosen. More...

class	help_text_area
	The area where the content is shown in the help browser. More...

struct	parse_error
	Thrown when the help system fails to parse something. More...

struct	section
	A section contains topics and sections along with title and ID. More...

class	section_less
	To be used as a function object when sorting section lists on the title. More...

class	string_less

struct	terrain_movement_info

class	terrain_topic_generator

class	text_topic_generator

class	title_less
	To be used as a function object when sorting topic lists on the title. More...

struct	topic
	A topic contains a title, an id and some text. More...

class	topic_generator
	Generate a topic text on the fly. More...

class	topic_text
	The text displayed in a topic. More...

class	unit_topic_generator

Typedefs
typedef std::vector< section * >	section_list

typedef std::list< topic >	topic_list

typedef std::vector< std::vector< std::pair< std::string, unsigned int > > >	table_spec

typedef t_translation::ter_list::const_iterator	ter_iter

typedef std::pair< std::string, std::string >	trait_data

Enumerations
enum	UNIT_DESCRIPTION_TYPE { FULL_DESCRIPTION, NO_DESCRIPTION, NON_REVEALING_DESCRIPTION }

Functions
void	show_unit_description (const unit &u)

void	show_terrain_description (const terrain_type &t)

void	show_unit_description (const unit_type &t)

void	show_help (const std::string &show_topic, int xloc, int yloc)
	Open the help browser, show topic with id show_topic. More...

void	show_unit_help (const std::string &show_topic, bool has_variations, bool hidden, int xloc, int yloc)
	Open the help browser, show unit with id unit_id. More...

void	show_terrain_help (const std::string &show_topic, bool hidden, int xloc, int yloc)
	Open the help browser, show terrain with id terrain_id. More...

void	show_variation_help (const std::string &unit, const std::string &variation, bool hidden, int xloc, int yloc)
	Open the help browser, show the variation of the unit matching. More...

void	show_help (const section &toplevel_sec, const std::string &show_topic, int xloc, int yloc)
	Open a help dialog using a toplevel other than the default. More...

bool	section_is_referenced (const std::string &section_id, const config &cfg)
	Return true if the section with id section_id is referenced from another section in the config, or the toplevel. More...

bool	topic_is_referenced (const std::string &topic_id, const config &cfg)
	Return true if the topic with id topic_id is referenced from another section in the config, or the toplevel. More...

void	parse_config_internal (const config help_cfg, const config section_cfg, section &sec, int level=0)
	Recursive function used by parse_config. More...

section	parse_config (const config *cfg)
	Parse a help config, return the top level section. More...

std::vector< topic >	generate_topics (const bool sort_generated, const std::string &generator)

void	generate_sections (const config *help_cfg, const std::string &generator, section &sec, int level)
	Dispatch generators to their appropriate functions. More...

std::string	generate_topic_text (const std::string &generator, const config *help_cfg, const section &sec, const std::vector< topic > &generated_topics)

std::vector< topic >	generate_time_of_day_topics (const bool)

std::vector< topic >	generate_weapon_special_topics (const bool sort_generated)

std::vector< topic >	generate_ability_topics (const bool sort_generated)

std::vector< topic >	generate_era_topics (const bool sort_generated, const std::string &era_id)

std::vector< topic >	generate_faction_topics (const config &era, const bool sort_generated)

std::vector< topic >	generate_trait_topics (const bool sort_generated)

std::string	make_unit_link (const std::string &type_id)
	return a hyperlink with the unit's name and pointing to the unit page return empty string if this unit is hidden. More...

std::vector< std::string >	make_unit_links_list (const std::vector< std::string > &type_id_list, bool ordered=false)
	return a list of hyperlinks to unit's pages (ordered or not) More...

void	generate_races_sections (const config *help_cfg, section &sec, int level)

void	generate_era_sections (const config *help_cfg, section &sec, int level)

void	generate_terrain_sections (const config *, section &sec, int)

void	generate_unit_sections (const config *, section &sec, int level, const bool, const std::string &race)

std::vector< topic >	generate_unit_topics (const bool sort_generated, const std::string &race)

UNIT_DESCRIPTION_TYPE	description_type (const unit_type &type)
	Return the type of description that should be shown for a unit of the given kind. More...

std::string	generate_contents_links (const std::string &section_name, config const *help_cfg)

std::string	generate_contents_links (const section &sec, const std::vector< topic > &topics)

const topic *	find_topic (const section &sec, const std::string &id)
	Search for the topic with the specified identifier in the section and its subsections. More...

const section *	find_section (const section &sec, const std::string &id)
	Search for the section with the specified identifier in the section and its subsections. More...

std::vector< std::string >	parse_text (const std::string &text)
	Parse a text string. More...

std::string	convert_to_wml (const std::string &element_name, const std::string &contents)
	Convert the contents to wml attributes, surrounded within [element_name]...[/element_name]. More...

color_t	string_to_color (const std::string &s)
	Return the color the string represents. More...

std::vector< std::string >	split_in_width (const std::string &s, const int font_size, const unsigned width)
	Make a best effort to word wrap s. All parts are less than width. More...

std::string	remove_first_space (const std::string &text)

std::string	get_first_word (const std::string &s)
	Return the first word in s, not removing any spaces in the start of it. More...

void	generate_contents ()
	Generate the help contents from the configurations given to the manager. More...

std::string	hidden_symbol (bool hidden)

bool	is_visible_id (const std::string &id)

bool	is_valid_id (const std::string &id)
	Return true if the id is valid for user defined topics and sections. More...

unsigned	image_width (const std::string &filename)

void	push_tab_pair (std::vector< std::pair< std::string, unsigned int >> &v, const std::string &s)

std::string	generate_table (const table_spec &tab, const unsigned int spacing)

std::string	escape (const std::string &s)
	Prepend all chars with meaning inside attributes with a backslash. More...

ter_data_cache	load_terrain_types_data ()
	Load the appropriate terrain types data to use. More...

std::string	make_link (const std::string &text, const std::string &dst)

std::string	jump_to (const unsigned pos)

std::string	jump (const unsigned amount)

std::string	bold (const std::string &s)

static std::string	best_str (bool best)

static std::string	print_behavior_description (ter_iter start, ter_iter end, const ter_data_cache &tdata, bool first_level=true, bool begin_best=true)

static void	print_trait_list (std::stringstream &ss, const std::vector< trait_data > &l)

Variables
config	dummy_cfg

const config *	game_cfg = nullptr

help::section	default_toplevel

help::section	hidden_sections

int	last_num_encountered_units = -1

int	last_num_encountered_terrains = -1

boost::tribool	last_debug_state = boost::indeterminate

std::vector< std::string >	empty_string_vector

const int	max_section_level = 15

const int	title_size = font::SIZE_LARGE

const int	title2_size = font::SIZE_15

const int	box_width = 2

const int	normal_font_size = font::SIZE_NORMAL

const unsigned	max_history = 100

const std::string	topic_img = "help/topic.png"

const std::string	closed_section_img = "help/closed_section.png"

const std::string	open_section_img = "help/open_section.png"

const std::string	default_show_topic = "..introduction"

const std::string	unknown_unit_topic = ".unknown_unit"

const std::string	unit_prefix = "unit_"

const std::string	terrain_prefix = "terrain_"

const std::string	race_prefix = "race_"

const std::string	faction_prefix = "faction_"

const std::string	era_prefix = "era_"

const std::string	variation_prefix = "variation_"

const std::string	ability_prefix = "ability_"

Typedef Documentation

◆ section_list

typedef std::vector<section *> help::section_list

Definition at line 59 of file help_impl.hpp.

◆ table_spec

typedef std::vector<std::vector<std::pair<std::string, unsigned int > > > help::table_spec

Definition at line 386 of file help_impl.hpp.

◆ ter_iter

typedef t_translation::ter_list::const_iterator help::ter_iter

Definition at line 68 of file help_topic_generators.cpp.

◆ topic_list

typedef std::list<topic> help::topic_list

Definition at line 140 of file help_impl.hpp.

◆ trait_data

typedef std::pair<std::string, std::string> help::trait_data

Definition at line 235 of file help_topic_generators.cpp.

Enumeration Type Documentation

◆ UNIT_DESCRIPTION_TYPE

enum help::UNIT_DESCRIPTION_TYPE

Enumerator
FULL_DESCRIPTION
NO_DESCRIPTION
NON_REVEALING_DESCRIPTION

Definition at line 249 of file help_impl.hpp.

Function Documentation

◆ best_str()

static std::string help::best_str ( bool best )

static

Definition at line 61 of file help_topic_generators.cpp.

References _().

Referenced by print_behavior_description().

◆ bold()

std::string help::bold ( const std::string & s )

inline

Definition at line 379 of file help_impl.hpp.

References escape().

Referenced by help::help_text_area::handle_format_cfg(), help::unit_topic_generator::push_header(), and help::help_text_area::set_items().

◆ convert_to_wml()

std::string help::convert_to_wml	(	const std::string &	element_name,
		const std::string &	contents
	)

Convert the contents to wml attributes, surrounded within [element_name]...[/element_name].

Return the resulting WML.

Definition at line 1246 of file help_impl.cpp.

References c, and wfl::msg().

Referenced by parse_text().

◆ description_type()

UNIT_DESCRIPTION_TYPE help::description_type ( const unit_type & type )

Return the type of description that should be shown for a unit of the given kind.

This method is intended to filter out information about units that should not be shown, for example due to not being encountered.

Definition at line 1004 of file help_impl.cpp.

References game_config::debug, preferences::encountered_units(), FULL_DESCRIPTION, unit_type::id(), hotkey::is_scope_active(), NO_DESCRIPTION, hotkey::SCOPE_EDITOR, and preferences::show_all_units_in_help().

Referenced by generate_ability_topics(), generate_races_sections(), generate_trait_topics(), generate_unit_topics(), generate_weapon_special_topics(), make_unit_link(), and help::unit_topic_generator::operator()().

◆ escape()

std::string help::escape ( const std::string & s )

Prepend all chars with meaning inside attributes with a backslash.

Definition at line 1528 of file help_impl.cpp.

References utils::escape().

Referenced by bold(), make_link(), and help::unit_topic_generator::operator()().

◆ find_section()

const section * help::find_section	(	const section &	sec,
		const std::string &	id
	)

Search for the section with the specified identifier in the section and its subsections.

Return the found section or nullptr if none could be found.

Definition at line 1157 of file help_impl.cpp.

References s, and help::section::sections.

Referenced by generate_contents().

◆ find_topic()

const topic * help::find_topic	(	const section &	sec,
		const std::string &	id
	)

Search for the topic with the specified identifier in the section and its subsections.

Return the found topic, or nullptr if none could be found.

Definition at line 1140 of file help_impl.cpp.

References help::section::sections, t, and help::section::topics.

Referenced by generate_contents(), help::help_browser::handle_event(), help::help_text_area::handle_ref_cfg(), help::help_menu::process(), and help::help_browser::show_topic().

◆ generate_ability_topics()

std::vector< topic > help::generate_ability_topics ( const bool sort_generated )

Definition at line 488 of file help_impl.cpp.

References _(), a, unit_type::abilities_metadata(), unit_type::adv_abilities_metadata(), description_type(), FULL_DESCRIPTION, unit_type::hide_help(), unit_type::id(), make_link(), sort(), unit_type::type_name(), unit_type_data::types(), font::unicode_bullet, and unit_types.

Referenced by generate_topics().

◆ generate_contents()

void help::generate_contents ( )

Generate the help contents from the configurations given to the manager.

Definition at line 1374 of file help_impl.cpp.

References config::add_child(), config::child(), config::child_range(), help::section::clear(), config::clear_children(), dummy_cfg, e, find_section(), find_topic(), help::section::id, game::error::message, wfl::msg(), parse_config(), section_is_referenced(), and topic_is_referenced().

Referenced by show_help().

◆ generate_contents_links() [1/2]

std::string help::generate_contents_links	(	const std::string &	section_name,
		config const *	help_cfg
	)

Definition at line 1018 of file help_impl.cpp.

References config::find_child(), is_visible_id(), make_link(), utils::quoted_split(), sort(), t, and font::unicode_bullet.

Referenced by generate_topic_text(), and help::parse_error::parse_error().

◆ generate_contents_links() [2/2]

std::string help::generate_contents_links	(	const section &	sec,
		const std::vector< topic > &	topics
	)

Definition at line 1056 of file help_impl.cpp.

References is_visible_id(), make_link(), s, help::section::sections, t, and font::unicode_bullet.

◆ generate_era_sections()

void help::generate_era_sections	(	const config *	help_cfg,
		section &	sec,
		int	level
	)

Definition at line 809 of file help_impl.cpp.

References help::section::add_section(), config::child_range(), DBG_HP, config::debug(), preferences::era(), and parse_config_internal().

Referenced by generate_sections().

◆ generate_era_topics()

std::vector< topic > help::generate_era_topics	(	const bool	sort_generated,
		const std::string &	era_id
	)

Definition at line 554 of file help_impl.cpp.

References _(), config_attribute_value::empty(), preferences::era(), config::find_child(), generate_faction_topics(), make_link(), sort(), t, config_attribute_value::t_str(), and font::unicode_bullet.

Referenced by generate_topics().

◆ generate_faction_topics()

std::vector< topic > help::generate_faction_topics	(	const config &	era,
		const bool	sort_generated
	)

Definition at line 590 of file help_impl.cpp.

References _(), unit_type::alignment_description(), config::child_range(), DBG_HP, config_attribute_value::empty(), f, unit_type_data::find(), unit_type_data::find_race(), unit_type::genders(), unit_type::HELP_INDEXED, make_link(), make_unit_links_list(), name(), unit_type::race_id(), sort(), utils::split(), t, config_attribute_value::t_str(), font::unicode_bullet, and unit_types.

Referenced by generate_era_topics().

◆ generate_races_sections()

void help::generate_races_sections	(	const config *	help_cfg,
		section &	sec,
		int	level
	)

Definition at line 769 of file help_impl.cpp.

References _(), help::section::add_section(), description_type(), unit_type_data::find_race(), FULL_DESCRIPTION, hidden_symbol(), unit_type::hide_help(), i, parse_config_internal(), unit_type::race_id(), unit_type_data::types(), and unit_types.

Referenced by generate_sections(), and help::parse_error::parse_error().

◆ generate_sections()

void help::generate_sections	(	const config *	help_cfg,
		const std::string &	generator,
		section &	sec,
		int	level
	)

Dispatch generators to their appropriate functions.

Definition at line 291 of file help_impl.cpp.

References DBG_HP, generate_era_sections(), generate_races_sections(), generate_terrain_sections(), generate_unit_sections(), utils::split(), utils::STRIP_SPACES, and WRN_HP.

Referenced by parse_config_internal(), and help::parse_error::parse_error().

◆ generate_table()

std::string help::generate_table	(	const table_spec &	tab,
		const unsigned int	spacing
	)

Definition at line 1485 of file help_impl.cpp.

References i, and jump_to().

Referenced by help::unit_topic_generator::operator()().

◆ generate_terrain_sections()

void help::generate_terrain_sections	(	const config *	,
		section &	sec,
		int
	)

◆ generate_time_of_day_topics()

std::vector< topic > help::generate_time_of_day_topics ( const bool )

Definition at line 359 of file help_impl.cpp.

References _(), jump(), jump_to(), make_link(), tod_manager::times(), and resources::tod_manager.

Referenced by generate_topics().

◆ generate_topic_text()

std::string help::generate_topic_text	(	const std::string &	generator,
		const config *	help_cfg,
		const section &	sec,
		const std::vector< topic > &	generated_topics
	)

Definition at line 310 of file help_impl.cpp.

References generate_contents_links(), and utils::split().

Referenced by parse_config_internal(), and help::parse_error::parse_error().

◆ generate_topics()

std::vector< topic > help::generate_topics	(	const bool	sort_generated,
		const std::string &	generator
	)

Definition at line 262 of file help_impl.cpp.

References generate_ability_topics(), generate_era_topics(), generate_time_of_day_topics(), generate_trait_topics(), generate_unit_topics(), generate_weapon_special_topics(), utils::split(), utils::STRIP_SPACES, and WRN_HP.

Referenced by parse_config_internal(), and help::parse_error::parse_error().

◆ generate_trait_topics()

std::vector< topic > help::generate_trait_topics ( const bool sort_generated )

Definition at line 666 of file help_impl.cpp.

References _(), a, description_type(), unit_type_data::find_race(), FULL_DESCRIPTION, i, name(), unit_type::possible_traits(), unit_type::race_id(), sort(), unit_type_data::traits(), unit_type_data::types(), and unit_types.

Referenced by generate_topics().

◆ generate_unit_sections()

void help::generate_unit_sections	(	const config *	,
		section &	sec,
		int	level,
		const bool	,
		const std::string &	race
	)

◆ generate_unit_topics()

std::vector< topic > help::generate_unit_topics	(	const bool	sort_generated,
		const std::string &	race
	)

Definition at line 918 of file help_impl.cpp.

References _(), unit_type::alignment_description(), description_type(), unit_type_data::find_race(), FULL_DESCRIPTION, unit_type::genders(), hidden_symbol(), unit_type::hide_help(), i, unit_type::id(), make_link(), unit_type::race_id(), unit_type::show_variations_in_help(), sort(), help::topic::text, unit_type::type_name(), unit_type_data::types(), font::unicode_bullet, and unit_types.

Referenced by generate_topics(), and help::parse_error::parse_error().

◆ generate_weapon_special_topics()

std::vector< topic > help::generate_weapon_special_topics ( const bool sort_generated )

Definition at line 391 of file help_impl.cpp.

References _(), unit_type::attacks(), config::child_range(), description_type(), FULL_DESCRIPTION, unit_type::hide_help(), i, unit_type::id(), make_link(), unit_type::modification_advancements(), s, unit_type::show_variations_in_help(), sort(), unit_type::type_name(), unit_type_data::types(), font::unicode_bullet, and unit_types.

Referenced by generate_topics().

◆ get_first_word()

std::string help::get_first_word ( const std::string & s )

Return the first word in s, not removing any spaces in the start of it.

Definition at line 1348 of file help_impl.cpp.

References ucs4::iterator_base< string_type, update_implementation >::end(), font::is_cjk_char(), s, and unicode_cast().

Referenced by help::help_text_area::add_text_item().

◆ hidden_symbol()

std::string help::hidden_symbol ( bool hidden )

Definition at line 1438 of file help_impl.cpp.

Referenced by generate_races_sections(), generate_terrain_sections(), generate_unit_sections(), generate_unit_topics(), is_valid_id(), show_terrain_help(), help::help_browser::show_topic(), show_unit_help(), and show_variation_help().

◆ image_width()

unsigned help::image_width ( const std::string & filename )

Definition at line 1470 of file help_impl.cpp.

References image::get_image().

Referenced by help::unit_topic_generator::operator()().

◆ is_valid_id()

bool help::is_valid_id ( const std::string & id )

Return true if the id is valid for user defined topics and sections.

Some IDs are special, such as toplevel and may not be be defined in the config.

Definition at line 1449 of file help_impl.cpp.

References translation::compare(), hidden_symbol(), and unit_prefix.

Referenced by parse_config_internal().

◆ is_visible_id()

bool help::is_visible_id ( const std::string & id )

Definition at line 1442 of file help_impl.cpp.

Referenced by generate_contents_links(), and help::help_menu::update_visible_items().

◆ jump()

std::string help::jump ( const unsigned amount )

inline

Definition at line 372 of file help_impl.hpp.

Referenced by generate_time_of_day_topics(), help::unit_topic_generator::operator()(), and help::help_text_area::set_items().

◆ jump_to()

std::string help::jump_to ( const unsigned pos )

inline

Definition at line 365 of file help_impl.hpp.

Referenced by generate_table(), generate_time_of_day_topics(), and help::help_text_area::handle_jump_cfg().

◆ load_terrain_types_data()

ter_data_cache help::load_terrain_types_data ( )

Load the appropriate terrain types data to use.

Definition at line 1534 of file help_impl.cpp.

References game_config_manager::get(), display::get_disp_context(), display::get_singleton(), display_context::map(), gamemap::tdata(), and game_config_manager::terrain_types().

Referenced by generate_terrain_sections(), gui2::get_mp_tooltip(), help::terrain_topic_generator::operator()(), and help::unit_topic_generator::operator()().

◆ make_link()

std::string help::make_link	(	const std::string &	text,
		const std::string &	dst
	)

inline

Definition at line 359 of file help_impl.hpp.

References escape().

Referenced by generate_ability_topics(), generate_contents_links(), generate_era_topics(), generate_faction_topics(), generate_time_of_day_topics(), generate_unit_topics(), generate_weapon_special_topics(), make_unit_link(), help::terrain_topic_generator::operator()(), help::unit_topic_generator::operator()(), and print_trait_list().

◆ make_unit_link()

std::string help::make_unit_link ( const std::string & type_id )

return a hyperlink with the unit's name and pointing to the unit page return empty string if this unit is hidden.

If not yet discovered add the (?) suffix

Definition at line 728 of file help_impl.cpp.

References description_type(), unit_type_data::find(), FULL_DESCRIPTION, unit_type::HELP_INDEXED, unit_type::hide_help(), unit_type::id(), make_link(), name(), unit_type::show_variations_in_help(), unit_type::type_name(), unit_types, and unknown_unit_topic.

Referenced by make_unit_links_list(), and help::parse_error::parse_error().

◆ make_unit_links_list()

std::vector< std::string > help::make_unit_links_list	(	const std::vector< std::string > &	type_id_list,
		bool	ordered
	)

return a list of hyperlinks to unit's pages (ordered or not)

Definition at line 754 of file help_impl.cpp.

References make_unit_link(), and sort().

Referenced by generate_faction_topics(), and help::parse_error::parse_error().

◆ parse_config()

section help::parse_config ( const config * cfg )

Parse a help config, return the top level section.

Return an empty section if cfg is nullptr.

Definition at line 252 of file help_impl.cpp.

References config::child(), and parse_config_internal().

Referenced by generate_contents(), and terrain_builder::parse_global_config().

◆ parse_config_internal()

void help::parse_config_internal	(	const config *	help_cfg,
		const config *	section_cfg,
		section &	sec,
		int	level
	)

Recursive function used by parse_config.

Definition at line 145 of file help_impl.cpp.

References help::section::add_section(), config::find_child(), generate_sections(), generate_topic_text(), generate_topics(), help::topic::id, help::section::id, is_valid_id(), help::section::level, game_config::images::level, utils::quoted_split(), help::section::sections, sort(), help::section::title, and help::section::topics.

Referenced by generate_era_sections(), generate_races_sections(), and parse_config().

◆ parse_text()

std::vector< std::string > help::parse_text ( const std::string & text )

Parse a text string.

Return a vector with the different parts of the text. Each markup item is a separate part while the text between markups are separate parts.

Definition at line 1173 of file help_impl.cpp.

References c, convert_to_wml(), wfl::msg(), desktop::notifications::OTHER, and s.

Referenced by help::topic_text::parsed_text().

◆ print_behavior_description()

static std::string help::print_behavior_description	(	ter_iter	start,
		ter_iter	end,
		const ter_data_cache &	tdata,
		bool	first_level = `true`,
		bool	begin_best = `true`
	)

static

Definition at line 70 of file help_topic_generators.cpp.

References best_str(), terrain_type::editor_name(), t_string::empty(), i, t_translation::MINUS, names, t_translation::PLUS, and s.

Referenced by help::terrain_topic_generator::operator()().

◆ print_trait_list()

static void help::print_trait_list	(	std::stringstream &	ss,
		const std::vector< trait_data > &	l
	)

static

Definition at line 238 of file help_topic_generators.cpp.

References i, and make_link().

Referenced by help::unit_topic_generator::operator()().

◆ push_tab_pair()

void help::push_tab_pair	(	std::vector< std::pair< std::string, unsigned int >> &	v,
		const std::string &	s
	)

Definition at line 1480 of file help_impl.cpp.

References font::line_width().

Referenced by help::unit_topic_generator::operator()().

◆ remove_first_space()

std::string help::remove_first_space ( const std::string & text )

Definition at line 1340 of file help_impl.cpp.

Referenced by help::help_text_area::add_text_item().

◆ section_is_referenced()

bool help::section_is_referenced	(	const std::string &	section_id,
		const config &	cfg
	)

Return true if the section with id section_id is referenced from another section in the config, or the toplevel.

Definition at line 97 of file help_impl.cpp.

References config::child(), config::child_range(), gui2::event::find(), and utils::quoted_split().

Referenced by generate_contents().

◆ show_help() [1/2]

void help::show_help	(	const std::string &	show_topic,
		int	xloc,
		int	yloc
	)

Open the help browser, show topic with id show_topic.

Open the help browser.

If show_topic is the empty string, the default topic will be shown.

The help browser will have the topic with id show_topic open if it is not the empty string. The default topic will be shown if show_topic is the empty string.

Definition at line 116 of file help.cpp.

References default_toplevel.

Referenced by tooltips::click(), gui2::dialogs::addon_connect::help_button_callback(), game_lua_kernel::intf_open_help(), gui2::dialogs::title_screen::pre_show(), editor::editor_controller::save_map(), events::menu_handler::set_gui(), gui2::dialogs::unit_advance::show_help(), gui2::dialogs::unit_recruit::show_help(), gui2::dialogs::unit_recall::show_help(), events::menu_handler::show_help(), editor::editor_controller::show_help(), gui2::dialogs::addon_manager::show_help(), show_terrain_help(), show_unit_help(), show_variation_help(), and editor::editor_controller::unit_description().