The Battle for Wesnoth  1.17.0-dev
help_impl.hpp
Go to the documentation of this file.
1 /*
2  Copyright (C) 2003 - 2021
3  by David White <dave@whitevine.net>
4  Part of the Battle for Wesnoth Project https://www.wesnoth.org/
5 
6  This program is free software; you can redistribute it and/or modify
7  it under the terms of the GNU General Public License as published by
8  the Free Software Foundation; either version 2 of the License, or
9  (at your option) any later version.
10  This program is distributed in the hope that it will be useful,
11  but WITHOUT ANY WARRANTY.
12 
13  See the COPYING file for more details.
14 */
15 
16 /**
17  * Note:
18  * Prior to the creation of this file, all the code associated to the help
19  * browser existed in a single file src/help.cpp, including all of the
20  * widgets, topic generators, and implementation details. This totaled
21  * ~4000 lines of code.
22  *
23  * I have split it all up now, so that the gui aspects are separated from
24  * the content, the "front facing" part which the rest of the code base
25  * interacts with is in src/help/help.?pp, and the topic generators are
26  * separated. The remaining "guts" are here. It is implemented in a static
27  * singleton pattern, using "extern"'d variables, simply for ease of translation
28  * from the previous state. It would probably be a good idea to rewrite this
29  * guy as a proper C++ object. Feel free to do so, or to adopt some other
30  * design pattern.
31  */
32 
33 #pragma once
34 
35 #include "color.hpp"
36 #include "exceptions.hpp" // for error
37 #include "font/constants.hpp"
38 #include "gettext.hpp"
39 #include <optional>
40 #include <cstring>
41 #include <list> // for list
42 #include <memory>
43 #include <ostream> // for operator<<, stringstream, etc
44 #include <sstream>
45 #include <string> // for string, allocator, etc
46 #include <utility> // for pair, make_pair
47 #include <vector> // for vector, etc
48 #include <boost/logic/tribool.hpp>
49 
50 class game_config_view;
51 class config;
52 class unit_type;
53 class terrain_type_data;
54 
55 namespace help {
56 
57 /**
58  * Generate the help contents from the configurations given to the manager.
59  */
60 void generate_contents();
61 
62 
63 /** Generate a topic text on the fly. */
65 {
66 public:
67  topic_generator() = default;
68  virtual std::string operator()() const = 0;
69  virtual ~topic_generator() {}
70 };
71 
73  std::string text_;
74 public:
75  text_topic_generator(const std::string& t): text_(t) {}
76  virtual std::string operator()() const { return text_; }
77 };
78 
79 /**
80  * The text displayed in a topic. It is generated on the fly with the information contained in generator_
81  */
83 {
84  mutable std::vector< std::string > parsed_text_;
85  mutable std::shared_ptr<topic_generator> generator_;
86 public:
87  topic_text() = default;
88  ~topic_text() = default;
89 
90  topic_text(const std::string& t):
91  parsed_text_(),
92  generator_(std::make_shared<text_topic_generator>(t))
93  {
94  }
95 
96  explicit topic_text(std::shared_ptr<topic_generator> g):
97  parsed_text_(),
98  generator_(g)
99  {
100  }
101 
102  topic_text(const topic_text& t) = default;
103  topic_text(topic_text&& t) = default;
104  topic_text& operator=(topic_text&& t) = default;
105  topic_text& operator=(const topic_text& t) = default;
106  topic_text& operator=(std::shared_ptr<topic_generator> g);
107 
108  const std::vector<std::string>& parsed_text() const;
109 };
110 
111 /** A topic contains a title, an id and some text. */
112 struct topic
113 {
114  topic() :
115  title(),
116  id(),
117  text()
118  {
119  }
120 
121  topic(const std::string &_title, const std::string &_id) :
122  title(_title),
123  id(_id),
124  text()
125  {
126  }
127 
128  topic(const std::string &_title, const std::string &_id, const std::string &_text)
129  : title(_title), id(_id), text(_text) {}
130  topic(const std::string &_title, const std::string &_id, std::shared_ptr<topic_generator> g)
131  : title(_title), id(_id), text(g) {}
132  /** Two topics are equal if their IDs are equal. */
133  bool operator==(const topic &) const;
134  bool operator!=(const topic &t) const { return !operator==(t); }
135  /** Comparison on the ID. */
136  bool operator<(const topic &) const;
137  std::string title, id;
138  mutable topic_text text;
139 };
140 
141 struct section;
142 typedef std::list<section> section_list;
143 typedef std::list<topic> topic_list;
144 
145 /** A section contains topics and sections along with title and ID. */
146 struct section {
148  title(""),
149  id(""),
150  topics(),
151  sections()
152  {
153  }
154 
155  /** Two sections are equal if their IDs are equal. */
156  bool operator==(const section &) const;
157  /** Comparison on the ID. */
158  bool operator<(const section &) const;
159 
160  /** Allocate memory for and add the section. */
161  void add_section(const section &s);
162 
163  void clear();
164  std::string title, id;
165  topic_list topics;
166  section_list sections;
167 };
168 
169 
170 /**
171  * To be used as a function object to locate sections and topics with a specified ID.
172  */
173 class has_id
174 {
175 public:
176  has_id(const std::string &id) : id_(id) {}
177  bool operator()(const topic &t) { return t.id == id_; }
178  bool operator()(const section &s) { return s.id == id_; }
179  bool operator()(const section *s) { return s != nullptr && s->id == id_; }
180 private:
181  const std::string id_;
182 };
183 
184 /** To be used as a function object when sorting topic lists on the title. */
186 {
187 public:
188  bool operator()(const topic &t1, const topic &t2) {
189  return translation::compare(t1.title, t2.title) < 0; }
190 };
191 
192 /** To be used as a function object when sorting section lists on the title. */
194 {
195 public:
196  bool operator()(const section& s1, const section& s2) {
197  return translation::compare(s1.title, s2.title) < 0; }
198 };
199 
201 {
202 public:
203  bool operator() (const std::string &s1, const std::string &s2) const {
204  return translation::compare(s1, s2) < 0;
205  }
206 };
207 
208 /** Thrown when the help system fails to parse something. */
209 struct parse_error : public game::error
210 {
211  parse_error(const std::string& msg) : game::error(msg) {}
212 };
213 
214 // Generator stuff below. Maybe move to a separate file? This one is
215 // getting crowded. Dunno if much more is needed though so I'll wait and
216 // see.
217 
218 /** Dispatch generators to their appropriate functions. */
219 void generate_sections(const config *help_cfg, const std::string &generator, section &sec, int level);
220 std::vector<topic> generate_topics(const bool sort_topics,const std::string &generator);
221 std::string generate_topic_text(const std::string &generator, const config *help_cfg,
222 const section &sec, const std::vector<topic>& generated_topics);
223 std::string generate_contents_links(const std::string& section_name, const config *help_cfg);
224 std::string generate_contents_links(const section &sec, const std::vector<topic>& topics);
225 
226 /**
227  * return a hyperlink with the unit's name and pointing to the unit page
228  * return empty string if this unit is hidden. If not yet discovered add the (?) suffix
229  */
230 std::string make_unit_link(const std::string& type_id);
231 /** return a list of hyperlinks to unit's pages (ordered or not) */
232 std::vector<std::string> make_unit_links_list(
233  const std::vector<std::string>& type_id_list, bool ordered = false);
234 
235 void generate_races_sections(const config *help_cfg, section &sec, int level);
236 void generate_terrain_sections(section &sec, int level);
237 std::vector<topic> generate_unit_topics(const bool, const std::string& race);
238 void generate_unit_sections(const config *help_cfg, section &sec, int level, const bool, const std::string& race);
241  /** Ignore this unit for documentation purposes. */
243  /**
244  * Although the unit itself is hidden, traits reachable via this unit are not hidden.
245  *
246  * This is a bug workaround - traits are defined by WML macros, and therefore the help
247  * system has to use a place where that macro is instanciated to provide the documentation.
248  * None of the normal unit types has the "loyal" trait, but there is a hidden unit which
249  * does, purely to support the help system.
250  */
252 };
253 /**
254  * Return the type of description that should be shown for a unit of
255  * the given kind. This method is intended to filter out information
256  * about units that should not be shown, for example due to not being
257  * encountered.
258  */
260 std::vector<topic> generate_ability_topics(const bool);
261 std::vector<topic> generate_time_of_day_topics(const bool);
262 std::vector<topic> generate_weapon_special_topics(const bool);
263 
264 void generate_era_sections(const config *help_cfg, section &sec, int level);
265 std::vector<topic> generate_faction_topics(const config &, const bool);
266 std::vector<topic> generate_era_topics(const bool, const std::string & era_id);
267 std::vector<topic> generate_trait_topics(const bool);
268 
269 /**
270  * Parse a help config, return the top level section. Return an empty
271  * section if cfg is nullptr.
272  */
273 section parse_config(const config *cfg);
274 /** Recursive function used by parse_config. */
275 void parse_config_internal(const config *help_cfg, const config *section_cfg,
276  section &sec, int level=0);
277 
278 /**
279  * Return true if the section with id section_id is referenced from
280  * another section in the config, or the toplevel.
281  */
282 bool section_is_referenced(const std::string &section_id, const config &cfg);
283 /**
284  * Return true if the topic with id topic_id is referenced from
285  * another section in the config, or the toplevel.
286  */
287 bool topic_is_referenced(const std::string &topic_id, const config &cfg);
288 
289 /**
290  * Search for the topic with the specified identifier in the section
291  * and its subsections. Return the found topic, or nullptr if none could
292  * be found.
293  */
294 const topic *find_topic(const section &sec, const std::string &id);
295 
296 /**
297  * Search for the section with the specified identifier in the section
298  * and its subsections. Return the found section or nullptr if none could
299  * be found.
300  */
301 const section *find_section(const section &sec, const std::string &id);
302 section *find_section(section &sec, const std::string &id);
303 
304 /**
305  * Parse a text string. Return a vector with the different parts of the
306  * text. Each markup item is a separate part while the text between
307  * markups are separate parts.
308  */
309 std::vector<std::string> parse_text(const std::string &text);
310 
311 /**
312  * Convert the contents to wml attributes, surrounded within
313  * [element_name]...[/element_name]. Return the resulting WML.
314  */
315 std::string convert_to_wml(const std::string &element_name, const std::string &contents);
316 
317 /**
318  * Return the color the string represents. Return font::NORMAL_COLOR if
319  * the string is empty or can't be matched against any other color.
320  */
321 color_t string_to_color(const std::string &s);
322 
323 /** Make a best effort to word wrap s. All parts are less than width. */
324 std::vector<std::string> split_in_width(const std::string &s, const int font_size, const unsigned width);
325 
326 std::string remove_first_space(const std::string& text);
327 
328 /** Prepend all chars with meaning inside attributes with a backslash. */
329 std::string escape(const std::string &s);
330 
331 /** Return the first word in s, not removing any spaces in the start of it. */
332 std::string get_first_word(const std::string &s);
333 
334 /** Load the appropriate terrain types data to use */
335 std::shared_ptr<terrain_type_data> load_terrain_types_data();
336 
337 extern const game_config_view *game_cfg;
338 // The default toplevel.
340 // All sections and topics not referenced from the default toplevel.
342 
343 extern int last_num_encountered_units;
345 extern boost::tribool last_debug_state;
346 
347 extern std::vector<std::string> empty_string_vector;
348 extern const int max_section_level;
349 extern const int title_size;
350 extern const int title2_size;
351 extern const int box_width;
352 extern const int normal_font_size;
353 extern const unsigned max_history;
354 extern const std::string topic_img;
355 extern const std::string closed_section_img;
356 extern const std::string open_section_img;
357 // The topic to open by default when opening the help dialog.
358 extern const std::string default_show_topic;
359 extern const std::string unknown_unit_topic;
360 extern const std::string unit_prefix;
361 extern const std::string terrain_prefix;
362 extern const std::string race_prefix;
363 extern const std::string faction_prefix;
364 extern const std::string era_prefix;
365 extern const std::string variation_prefix;
366 extern const std::string ability_prefix;
367 
368 // id starting with '.' are hidden
369 std::string hidden_symbol(bool hidden = true);
370 
371 bool is_visible_id(const std::string &id);
372 
373 /**
374  * Return true if the id is valid for user defined topics and
375  * sections. Some IDs are special, such as toplevel and may not be
376  * be defined in the config.
377  */
378 bool is_valid_id(const std::string &id);
379 
380  // Helpers for making generation of topics easier.
381 
382 inline std::string make_link(const std::string& text, const std::string& dst)
383  {
384  // some sorting done on list of links may rely on the fact that text is first
385  return "<ref>text='" + help::escape(text) + "' dst='" + help::escape(dst) + "'</ref>";
386  }
387 
388 inline std::string jump_to(const unsigned pos)
389  {
390  std::stringstream ss;
391  ss << "<jump>to=" << pos << "</jump>";
392  return ss.str();
393  }
394 
395 inline std::string jump(const unsigned amount)
396  {
397  std::stringstream ss;
398  ss << "<jump>amount=" << amount << "</jump>";
399  return ss.str();
400  }
401 
402 inline std::string bold(const std::string &s)
403  {
404  std::stringstream ss;
405  ss << "<bold>text='" << help::escape(s) << "'</bold>";
406  return ss.str();
407  }
408 
409 // A string to be displayed and its width.
410 typedef std::pair< std::string, unsigned > item;
411 
412 typedef std::vector<std::vector<help::item>> table_spec;
413 // Create a table using the table specs. Return markup with jumps
414 // that create a table. The table spec contains a vector with
415 // vectors with pairs. The pairs are the markup string that should
416 // be in a cell, and the width of that cell.
417 std::string generate_table(const table_spec &tab, const unsigned int spacing=font::relative_size(20));
418 
419 // Return the width for the image with filename.
420 unsigned image_width(const std::string &filename);
421 
422 // Add to the vector v an help::item for the string s, preceded by the given image if any.
423 void push_tab_pair(std::vector<help::item> &v, const std::string &s, const std::optional<std::string> &image = {}, unsigned padding = 0);
424 
425 } // end namespace help
std::string jump_to(const unsigned pos)
Definition: help_impl.hpp:388
const std::string ability_prefix
Definition: help_impl.cpp:96
section parse_config(const config *cfg)
Parse a help config, return the top level section.
Definition: help_impl.cpp:306
std::string id
Definition: help_impl.hpp:164
Ignore this unit for documentation purposes.
Definition: help_impl.hpp:242
std::string make_unit_link(const std::string &type_id)
return a hyperlink with the unit&#39;s name and pointing to the unit page return empty string if this uni...
Definition: help_impl.cpp:787
const std::string open_section_img
Definition: help_impl.cpp:86
std::vector< topic > generate_trait_topics(const bool sort_generated)
Definition: help_impl.cpp:724
const std::string unit_prefix
Definition: help_impl.cpp:90
void push_tab_pair(std::vector< help::item > &v, const std::string &s, const std::optional< std::string > &image, unsigned padding)
Definition: help_impl.cpp:1559
std::vector< topic > generate_unit_topics(const bool sort_generated, const std::string &race)
Definition: help_impl.cpp:976
const std::string era_prefix
Definition: help_impl.cpp:94
const std::string topic_img
Definition: help_impl.cpp:84
topic_text(const std::string &t)
Definition: help_impl.hpp:90
const int title_size
Definition: help_impl.cpp:79
bool operator()(const section &s)
Definition: help_impl.hpp:178
const std::string closed_section_img
Definition: help_impl.cpp:85
std::string remove_first_space(const std::string &text)
Definition: help_impl.cpp:1420
A section contains topics and sections along with title and ID.
Definition: help_impl.hpp:146
const std::string unknown_unit_topic
Definition: help_impl.cpp:89
const std::string race_prefix
Definition: help_impl.cpp:92
std::string generate_topic_text(const std::string &generator, const config *help_cfg, const section &sec, const std::vector< topic > &generated_topics)
Definition: help_impl.cpp:364
virtual std::string operator()() const
Definition: help_impl.hpp:76
static l_noret error(LoadState *S, const char *why)
Definition: lundump.cpp:40
topic(const std::string &_title, const std::string &_id, const std::string &_text)
Definition: help_impl.hpp:128
int compare(const std::string &s1, const std::string &s2)
Case-sensitive lexicographical comparison.
Definition: gettext.cpp:498
boost::tribool last_debug_state
Definition: help_impl.cpp:75
int relative_size(int size)
Definition: constants.hpp:30
Thrown when the help system fails to parse something.
Definition: help_impl.hpp:209
parse_error(const std::string &msg)
Definition: help_impl.hpp:211
void clear(const std::string &key)
Definition: general.cpp:186
topic_text(std::shared_ptr< topic_generator > g)
Definition: help_impl.hpp:96
std::vector< std::string > empty_string_vector
Definition: help_impl.cpp:77
Although the unit itself is hidden, traits reachable via this unit are not hidden.
Definition: help_impl.hpp:251
text_topic_generator(const std::string &t)
Definition: help_impl.hpp:75
const std::string id_
Definition: help_impl.hpp:181
STL namespace.
static void msg(const char *act, debug_info &i, const char *to="", const char *result="")
Definition: debugger.cpp:110
const int normal_font_size
Definition: help_impl.cpp:82
unsigned image_width(const std::string &filename)
Definition: help_impl.cpp:1549
const std::string terrain_prefix
Definition: help_impl.cpp:91
int last_num_encountered_terrains
Definition: help_impl.cpp:74
std::list< section > section_list
Definition: help_impl.hpp:141
color_t string_to_color(const std::string &cmp_str)
Return the color the string represents.
Definition: help_impl.cpp:1377
bool is_visible_id(const std::string &id)
Definition: help_impl.cpp:1519
std::vector< topic > generate_weapon_special_topics(const bool sort_generated)
Definition: help_impl.cpp:450
std::vector< std::string > make_unit_links_list(const std::vector< std::string > &type_id_list, bool ordered)
return a list of hyperlinks to unit&#39;s pages (ordered or not)
Definition: help_impl.cpp:813
std::string bold(const std::string &s)
Definition: help_impl.hpp:402
A single unit type that the player may recruit.
Definition: types.hpp:45
void generate_sections(const config *help_cfg, const std::string &generator, section &sec, int level)
Dispatch generators to their appropriate functions.
Definition: help_impl.cpp:345
help::section hidden_sections
Definition: help_impl.cpp:71
section_list sections
Definition: help_impl.hpp:166
Contains the database of all known terrain types, both those defined explicitly by WML [terrain_type]...
Definition: type_data.hpp:40
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.
Definition: help_impl.cpp:1232
std::string id
Definition: help_impl.hpp:137
To be used as a function object to locate sections and topics with a specified ID.
Definition: help_impl.hpp:173
The text displayed in a topic.
Definition: help_impl.hpp:82
std::string generate_table(const table_spec &tab, const unsigned int spacing)
Definition: help_impl.cpp:1573
std::vector< std::vector< help::item > > table_spec
Definition: help_impl.hpp:412
std::string hidden_symbol(bool hidden)
Definition: help_impl.cpp:1515
std::shared_ptr< terrain_type_data > load_terrain_types_data()
Load the appropriate terrain types data to use.
Definition: help_impl.cpp:1622
bool operator()(const topic &t1, const topic &t2)
Definition: help_impl.hpp:188
std::string title
Definition: help_impl.hpp:164
std::vector< topic > generate_era_topics(const bool sort_generated, const std::string &era_id)
Definition: help_impl.cpp:613
UNIT_DESCRIPTION_TYPE
Definition: help_impl.hpp:239
std::vector< topic > generate_faction_topics(const config &era, const bool sort_generated)
Definition: help_impl.cpp:649
std::vector< std::string > parsed_text_
Definition: help_impl.hpp:84
std::list< topic > topic_list
Definition: help_impl.hpp:143
std::shared_ptr< topic_generator > generator_
Definition: help_impl.hpp:85
void parse_config_internal(const config *help_cfg, const config *section_cfg, section &sec, int level)
Recursive function used by parse_config.
Definition: help_impl.cpp:201
bool operator!=(const topic &t) const
Definition: help_impl.hpp:134
const int box_width
Definition: help_impl.cpp:81
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...
Definition: help_impl.cpp:153
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...
Definition: help_impl.cpp:177
void generate_unit_sections(const config *, section &sec, int, const bool, const std::string &race)
Definition: help_impl.cpp:943
To be used as a function object when sorting section lists on the title.
Definition: help_impl.hpp:193
std::string id
Text to match against addon_info.tags()
Definition: manager.cpp:215
const std::string variation_prefix
Definition: help_impl.cpp:95
void generate_terrain_sections(section &sec, int)
Definition: help_impl.cpp:891
int last_num_encountered_units
Definition: help_impl.cpp:73
bool operator()(const section *s)
Definition: help_impl.hpp:179
std::string make_link(const std::string &text, const std::string &dst)
Definition: help_impl.hpp:382
bool operator==(const config &a, const config &b)
Definition: config.cpp:1475
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].
Definition: help_impl.cpp:1326
static map_location::DIRECTION s
double g
Definition: astarsearch.cpp:65
static bool operator<(const placing_info &a, const placing_info &b)
Definition: game_state.cpp:140
const game_config_view * game_cfg
Definition: help_impl.cpp:67
void generate_races_sections(const config *help_cfg, section &sec, int level)
Definition: help_impl.cpp:828
rng * generator
This generator is automatically synced during synced context.
Definition: random.cpp:61
std::string escape(const std::string &s)
Prepend all chars with meaning inside attributes with a backslash.
Definition: help_impl.cpp:1616
std::vector< std::string > parse_text(const std::string &text)
Parse a text string.
Definition: help_impl.cpp:1253
const unsigned max_history
Definition: help_impl.cpp:83
std::vector< topic > generate_time_of_day_topics(const bool)
Definition: help_impl.cpp:403
std::string generate_contents_links(const std::string &section_name, config const *help_cfg)
Definition: help_impl.cpp:1127
const std::string faction_prefix
Definition: help_impl.cpp:93
std::string jump(const unsigned amount)
Definition: help_impl.hpp:395
has_id(const std::string &id)
Definition: help_impl.hpp:176
const std::string default_show_topic
Definition: help_impl.cpp:88
double t
Definition: astarsearch.cpp:65
void generate_contents()
Generate the help contents from the configurations given to the manager.
Definition: help_impl.cpp:1454
Base class for all the errors encountered by the engine.
Definition: exceptions.hpp:28
std::vector< topic > generate_topics(const bool sort_generated, const std::string &generator)
Definition: help_impl.cpp:316
virtual std::string operator()() const =0
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.
Definition: help_impl.cpp:1216
topic(const std::string &_title, const std::string &_id, std::shared_ptr< topic_generator > g)
Definition: help_impl.hpp:130
Functions to load and save images from/to disk.
Generate a topic text on the fly.
Definition: help_impl.hpp:64
bool operator()(const topic &t)
Definition: help_impl.hpp:177
const int title2_size
Definition: help_impl.cpp:80
A topic contains a title, an id and some text.
Definition: help_impl.hpp:112
Definition: help.cpp:57
virtual ~topic_generator()
Definition: help_impl.hpp:69
std::string title
Definition: help_impl.hpp:137
topic(const std::string &_title, const std::string &_id)
Definition: help_impl.hpp:121
bool is_valid_id(const std::string &id)
Return true if the id is valid for user defined topics and sections.
Definition: help_impl.cpp:1528
A config object defines a single node in a WML file, with access to child nodes.
Definition: config.hpp:61
std::string get_first_word(const std::string &s)
Return the first word in s, not removing any spaces in the start of it.
Definition: help_impl.cpp:1428
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. ...
Definition: help_impl.cpp:1107
std::vector< topic > generate_ability_topics(const bool sort_generated)
Definition: help_impl.cpp:547
void generate_era_sections(const config *help_cfg, section &sec, int level)
Definition: help_impl.cpp:868
const int max_section_level
Definition: help_impl.cpp:78
bool operator()(const section &s1, const section &s2)
Definition: help_impl.hpp:196
To be used as a function object when sorting topic lists on the title.
Definition: help_impl.hpp:185
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.
Definition: help_impl.cpp:1401
topic_list topics
Definition: help_impl.hpp:165
topic_text text
Definition: help_impl.hpp:138
std::pair< std::string, unsigned > item
Definition: help_impl.hpp:410
help::section default_toplevel
Definition: help_impl.cpp:69