"SfR Fresh" - the SfR Freeware/Shareware Archive

Member "Lynx/lynx_doc/docs/README.defines" of archive lynx.zip:


As a special service "SfR Fresh" has tried to format the requested source page into HTML format using source code syntax highlighting with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file. That can be also achieved for any archive member file by clicking within an archive contents listing on the first character of the file(path) respectively on the according byte size field.
    1 This file lists preprocessor macros (symbols) which are tested in the
    2 code (typically with ifdef).
    3 
    4 Does not include
    5 - symbols defined and documented in userdefs.h
    6 - symbols expected to be set by compiler to indicate system type or
    7   compiler features
    8 - many symbols set and used only in connection with the ./configure
    9   mechanism - the full and current list can be found in config.hin
   10   (as a template) or, after running ./configure, in lynx_cfg.h.
   11 - most symbols and macros defined in the source code
   12 
   13 ***Not complete.***
   14 
   15 A. Symbols primarily to enable compilation on specific systems
   16 ==============================================================
   17 See also under B for things needed by some systems.
   18 
   19 # if you have an SVR4 system with the "type any key" problem, try defining
   20 #
   21 # -DSVR4_BSDSELECT
   22 
   23 # Old Data General systems may need this in their SITE_LYDEFS
   24 # for their inet_addr(host) calls.
   25 #
   26 # -DDGUX_OLD
   27 
   28 ---
   29 Ports have been added for Win32 (95/NT) and 386 DOS computers with a
   30 packet driver.  I created four new defines to accomplish this.
   31 	_WINDOWS Defined for Win32 specific code (Mostly TCP related)
   32 	DJGPP    Defined for 386 specific code (Mostly TCP related)
   33 	DOSPATH  Defined for any DOS'ish computer
   34 	NOSIGHUP Defined for computers not supporting sighup signal calls.
   35 -- Wayne Buttles lynx-port@fdisk.com
   36 
   37 Added for 8+3 filesystems (DOS):
   38 	FNAMES_8_3  also defined in userdefs.h if __DJGPP__
   39 
   40 * incorporate changes for win32 by Hiroyuki Senshu <senshu@shonai-cit.ac.jp>
   41   (SH) from
   42     ftp://crab.it.osha.sut.ac.jp/pub/Win32/develope/senshu/Lynx/
   43   Most changes are ifdef'd
   44     #define _WIN_CC=    .... for Windows C Compiler
   45     #define CJK_EX      .... CJK EXtension
   46     #define SH_EX       .... Senshu Hiroyuki EXtension
   47     #define WIN_EX      .... Windows EXtension
   48 
   49 
   50 B. Symbols to enable or disable specific features, mostly
   51 =========================================================
   52 Note that some of these may be only usable on some system types,
   53 most were originally for UNIX.
   54 
   55 Network related, specific protocols
   56 -----------------------------------
   57 # -DSOCKS          For making a SOCKSified lynx.
   58        			see comments in makefile.in
   59 # -DSHORTENED_RBIND  For a SOCKSified lynx with the short version of Rbind.
   60                		see comments in makefile.in
   61 
   62 Related to DirEd code - probably only usable for UNIX or similar
   63 ----------------------------------------------------------------
   64 # -DDIRED_SUPPORT  (see INSTALLATION, Section II-1c)
   65 # -DOK_GZIP        (see INSTALLATION, Section II-1c)
   66 # -DOK_OVERRIDE    (see INSTALLATION, Section II-1c)
   67 # -DOK_PERMIT      (see INSTALLATION, Section II-1c)
   68 # -DOK_TAR         (see INSTALLATION, Section II-1c)
   69 # -DOK_UUDECODE    (see INSTALLATION, Section II-1c)
   70 # -DOK_ZIP         (see INSTALLATION, Section II-1c)
   71 # -DOK_INSTALL     to enable dired menu "Install" function
   72 # -DARCHIVE_ONLY   (see INSTALLATION, Section II-1c)
   73 # -DNO_CHANGE_EXECUTE_PERMS (see INSTALLATION, Section II-1c)
   74 # -DCANT_EDIT_UNWRITABLE_FILES (see LYEdit.c - always in effect for VMS)
   75 
   76 Related to formatting of local directory listings
   77 -------------------------------------------------
   78 # -DLONG_LIST      (see INSTALLATION, Section II-1c)
   79 # -DNO_PARENT_DIR_REFERENCE (see INSTALLATION, Section II-1c)
   80 
   81 Related to screen display
   82 -------------------------
   83 Using curses or ncurses library:
   84 # -DNCURSES        (see INSTALLATION, Section II-1c)
   85 # -DFANCY_CURSES   whether curses lib supports more than very basic stuff
   86                    for UNIX handled by ./configure, for VMS defined in code
   87 # -DNO_KEYPAD (old) or HAVE_KEYPAD (new)   whether curses lib uses keypad().
   88                    for UNIX handled by ./configure, may be set in HTUtils.h
   89 # -DCOLOR_CURSES    whether curses lib supports color (in the right way).
   90                    for UNIX handled by ./configure
   91 # -DUSE_COLOR_STYLE (see INSTALLATION, Section II-1c) needs SVr4 curses
   92 # -DUNDERLINE_LINKS  Define if you want links underlined instead of bold.
   93 # -DHP_TERMINAL    For DIM workaround to REVERSE problems on HP terminals.
   94 # -DNO_SIZECHANGE (old) or HAVE_SIZECHANGE (new) whether using code to detect
   95                    new size after size changes of the terminal (window).
   96                    for UNIX handled by ./configure, may be set in HTUtils.h
   97 # -DUSE_SCROLLBAR  supports scrollbar when built with ncurses
   98 # -DWIDEC_CURSES   whether curses lib supports wide/multibyte characters.
   99 
  100 Using slang library:
  101 # -DUSE_SLANG      (see INSTALLATION, Section II-1c)
  102 # -DSLANG_MBCS_HACK prevent cutoff lines when using UTF8 console (slang only)
  103 Both:
  104 # -DREVERSE_CLEAR_SCREEN_PROBLEM
  105 # 	if you have the reverse clear screen problem of some SUN4 systems, or
  106 # 	to work around some other "garbage on the screen" problems
  107 
  108 Other general
  109 -------------
  110 # -DEXP_ASCII_CTYPES use POSIX locale for toupper/tolower/isupper
  111 # -DIGNORE_CTRL_C  Define if Control-C shouldn't exit lynx.
  112 # -DINACTIVE_INPUT_STYLE_VH  Different style for showing inactive text fields
  113 # -DMISC_EXP       Enable some truly experimental stuff
  114 # -DNO_DUMP_WITH_BACKSPACES Disables -with_backspaces code
  115 # -DNO_RULES	   Disables code for CERN-style rules files
  116 # -DUSE_VASPRINT   Use vasprintf() function
  117 
  118 Untested
  119 --------
  120 # -DNO_EXTENDED_HTMLDTD	Disable some "SortaSGML" code, see SGML.c
  121 # -DWIND_DOWN_STACK Aggressive handling of end tags for "TagSoup", SGML.c
  122 
  123 C. Secondary symbols
  124 ====================
  125 Some macros that are not primary, i.e. they are normally automatically
  126 set or unset in the code based on other macros (including those from
  127 ./configure), but it may be sometimes useful to set them differently.
  128 They may directly affect several source files.  Filenames show where
  129 they are set.  Normally installers shouldn't have to care about these
  130 symbols.
  131 
  132 COOKIE_FILE		LYMain.c	default cookie file in HOME dir
  133 SHOW_WHEREIS_TARGETS	LYCurses.h	whereis search highlighting
  134 USE_KEYMAPS		LYCurses.h	use of .lynx-keymaps files
  135 
  136 D. Symbols defined locally to modify some behavior
  137 ==================================================
  138 Defined in the source files to which they apply.  Only filenames are listed,
  139 the files would have to be read and edited anyway to change the definition.
  140 Normally installers shouldn't have to care about any of these symbols.
  141 
  142 ADVANCED_INFO				LYShowInfo.c
  143 ALLOW_PROXY_HEAD			LYUtils.c
  144 CHECK_FREE_MEM				GridText.c
  145 CLEAN_URLS				HTParse.c
  146 DEBUG_HOSTENT				HTTCP.c
  147 DEBUG_HOSTENT_CHILD			HTTCP.c
  148 DEFAULT_INVCHECK_BV			LYCookie.c
  149 DUPLICATE_ANCHOR_NAME_WORKAROUND	HTAnchor.c
  150 EXTENDED_OPTION_LOGIC			LYMain.c
  151 EXTENDED_STARTFILE_RECALL		LYMain.c
  152 OPTNAME_ALLOW_DASHES			LYMain.c
  153 OVERLAP					HTNews.c
  154 RESTRICT_NM_ALLOW_DASHES		LYUtils.c
  155 SOCKET_DEBUG_TRACE			HTTCP.c
  156 TRADITIONAL_SUFFIXES			HTInit.c
  157 USE_XHDR				HTNews.c
  158 max_cookies_buffer			LYCookie.c
  159 max_cookies_domain			LYCookie.c
  160 max_cookies_global			LYCookie.c
  161 reverse_mailcap				HTInit.c