mirror of
https://github.com/MidnightCommander/mc
synced 2024-12-24 13:26:52 +03:00
758ab591d8
Mostly \file and \brief tag added. Signed-off-by: Mikhail S. Pobolovets <styx.mp@gmail.com>
49 lines
1.8 KiB
C
49 lines
1.8 KiB
C
|
|
/** \file help.h
|
|
* \brief Header: hypertext file browser
|
|
*
|
|
* Implements the hypertext file viewer.
|
|
* The hypertext file is a file that may have one or more nodes. Each
|
|
* node ends with a ^D character and starts with a bracket, then the
|
|
* name of the node and then a closing bracket. Right after the closing
|
|
* bracket a newline is placed. This newline is not to be displayed by
|
|
* the help viewer and must be skipped - its sole purpose is to faciliate
|
|
* the work of the people managing the help file template (xnc.hlp) .
|
|
*
|
|
* Links in the hypertext file are specified like this: the text that
|
|
* will be highlighted should have a leading ^A, then it comes the
|
|
* text, then a ^B indicating that highlighting is done, then the name
|
|
* of the node you want to link to and then a ^C.
|
|
*
|
|
* The file must contain a ^D at the beginning and at the end of the
|
|
* file or the program will not be able to detect the end of file.
|
|
*
|
|
* Lazyness/widgeting attack: This file does use the dialog manager
|
|
* and uses mainly the dialog to achieve the help work. there is only
|
|
* one specialized widget and it's only used to forward the mouse messages
|
|
* to the appropiate routine.
|
|
*
|
|
* This file is included by help.c and man2hlp.c
|
|
*/
|
|
|
|
#ifndef MC_HELP_H
|
|
#define MC_HELP_H
|
|
|
|
#define HELP_TEXT_WIDTH 58
|
|
|
|
/* Markers used in the help files */
|
|
#define CHAR_LINK_START '\01' /* Ctrl-A */
|
|
#define CHAR_LINK_POINTER '\02' /* Ctrl-B */
|
|
#define CHAR_LINK_END '\03' /* Ctrl-C */
|
|
#define CHAR_NODE_END '\04' /* Ctrl-D */
|
|
#define CHAR_ALTERNATE '\05' /* Ctrl-E */
|
|
#define CHAR_NORMAL '\06' /* Ctrl-F */
|
|
#define CHAR_VERSION '\07' /* Ctrl-G */
|
|
#define CHAR_FONT_BOLD '\010' /* Ctrl-H */
|
|
#define CHAR_FONT_NORMAL '\013' /* Ctrl-K */
|
|
#define CHAR_FONT_ITALIC '\024' /* Ctrl-T */
|
|
|
|
void interactive_display (const char *filename, const char *node);
|
|
|
|
#endif
|