forked from kurtchen/Lynx
-
Notifications
You must be signed in to change notification settings - Fork 1
/
Copy pathuserdefs.h
1868 lines (1705 loc) · 75.3 KB
/
userdefs.h
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
/*
* $LynxId: userdefs.h,v 1.358 2021/08/01 18:50:51 tom Exp $
*
* Lynx - Hypertext navigation system
*
* Copyright 1996-2020,2021 Thomas E. Dickey and Lynx Developers Group
* Note: GNU General Public License is not a copyright.
*
* (c) Copyright 1992, 1993, 1994 University of Kansas
* 1995, 1996: GNU General Public License
*/
/*******************************************************************
* There are four sections to this document:
* Section 1. Things you MUST verify. Unix platforms use a configure
* script to provide sensible default values. If your site
* has special requirements, that may not be sufficient.
* For non-Unix platforms (e.g., VMS), there is no
* configure script, so the defaults here are more
* critical.
* Section 1a) VMS specific things
* Section 1b) non-VMS specific things
* Section 1c) ALL Platforms
*
* Section 2. Things you should probably check!
*
* Section 3. Things you should only change after you have a good
* understanding of the program!
*
* Section 4. Things you MUST check only if you plan to use Lynx in
* an anonymous account (allow public access to Lynx)!
*
*/
#ifndef USERDEFS_H
#define USERDEFS_H
/*******************************************************************
* Insure definition of NOT_ASCII, etc. precedes use below.
*/
#ifndef HTUTILS_H
#include <HTUtils.h>
#endif
#ifdef HAVE_CONFIG_H
#include <lynx_cfg.h>
#endif
/*******************************************************************
* Things you must change
* Section 1.
*/
/*******************************************************************
* Things you must change - VMS specific
* Section 1a).
*/
#ifdef VMS
/**************************
* TEMP_SPACE is where Lynx temporary cache files will be placed.
* Temporary files are removed automatically as long as nothing
* goes terribly wrong :) If you include "$USER" in the definition
* (e.g., "device:[dir.$USER]"), Lynx will replace the "$USER" with
* the username of the account which invoked the Lynx image. Such
* directories should already exist, and have protections/ACLs set
* so that only the appropriate user(s) will have read/write access.
* On VMS, "sys$scratch:" defaults to "sys$login:" if it has not been
* defined externally, or you can use "sys$login:" explicitly here.
* If the path has SHELL syntax and includes a tilde (e.g, "~/lynxtmp"),
* Lynx will replace the tilde with the full path for the user's home
* and convert the result to VMS syntax.
* The definition here can be overridden at run time by defining a
* "LYNX_TEMP_SPACE" VMS logical.
*/
#define TEMP_SPACE "sys$scratch:"
/**************************
* LYNX_CFG_FILE is the location and name of the default lynx
* global configuration file. It is sought and processed at
* startup of Lynx, followed by a seek and processing of a
* personal RC file (.lynxrc in the user's HOME directory,
* created if the user saves values in the 'o'ptions menu).
* You also can define the location and name of the global
* configuration file via a VMS logical, "LYNX_CFG", which
* will override the "LYNX_CFG_FILE" definition here. SYS$LOGIN:
* can be used as the device in either or both definitions if
* you want lynx.cfg treated as a personal configuration file.
* You also can use Unix syntax with a '~' for a subdirectory
* of the login directory, (e.g., ~/lynx/lynx.cfg).
* The -cfg command line switch will override these definitions.
* You can pass the compilation default via build.com or descrip.mms.
*
* Note that some implementations of telnet allow passing of
* environment variables, which might be used by unscrupulous
* people to modify the environment in anonymous accounts. When
* making Lynx and Web access publicly available via anonymous
* accounts intended to run Lynx captively, be sure the wrapper
* uses the -cfg switch and specifies the startfile, rather than
* relying on the LYNX_CFG, LYNX_CFG_FILE, or WWW_HOME variables.
*
* Note that any SUFFIX or VIEWER mappings in the configuration
* file will be overridden by any suffix or viewer mappings
* that are established as defaults in src/HTInit.c. You can
* override the src/HTInit.c defaults via the mime.types and
* mailcap files (see the examples in the samples directory).
*/
#ifndef LYNX_CFG_FILE
#define LYNX_CFG_FILE "Lynx_Dir:lynx.cfg"
#endif /* LYNX_CFG_FILE */
#ifndef LYNX_CFG_PATH
#define LYNX_CFG_PATH "Lynx_Dir"
#endif /* LYNX_CFG_PATH */
/**************************
* The EXTENSION_MAP file allows you to map file suffixes to
* mime types.
* The file locations defined here can be overridden in lynx.cfg.
* Mappings in these global and personal files override any SUFFIX
* definitions in lynx.cfg and built-in defaults from src/HTInit.c.
*/
#define GLOBAL_EXTENSION_MAP "Lynx_Dir:mime.types"
#define PERSONAL_EXTENSION_MAP "mime.types"
/**************************
* The MAILCAP file allows you to map file MIME types to
* external viewers.
* The file locations defined here can be overridden in lynx.cfg.
* Mappings in these global and personal files override any VIEWER
* definitions in lynx.cfg and built-in defaults from src/HTInit.c.
*/
#define GLOBAL_MAILCAP "Lynx_Dir:mailcap"
#define PERSONAL_MAILCAP ".mailcap"
/**************************
* XLOADIMAGE_COMMAND will be used as a default in src/HTInit.c
* for viewing image content types when the DECW$DISPLAY logical
* is set. Make it the foreign command for your system's X image
* viewer (commonly, "xv"). It can be anything that will handle GIF,
* TIFF and other popular image formats. Freeware ports of xv for
* VMS are available in the ftp://ftp.wku.edu/vms/unsupported and
* http://www.openvms.digital.com/cd/XV310A/ subdirectories. You
* must also have a "%s" for the filename. The default defined
* here can be overridden in lynx.cfg, or via the global or personal
* mailcap files.
* Make this NULL if you don't have such a viewer or don't want to
* use any default viewers for image types.
*/
#define XLOADIMAGE_COMMAND "xv %s"
/**************************
* SYSTEM_MAIL must be defined here to your mail sending command,
* and SYSTEM_MAIL_FLAGS to appropriate qualifiers. They can be
* changed in lynx.cfg.
*
* The mail command will be spawned as a subprocess of lynx
* and used to send the email, with headers specified in a
* temporary file for PMDF. If you define SYSTEM_MAIL to the
* "generic" MAIL utility for VMS, headers cannot be specified
* via a header file (and thus may not be included), and the
* subject line will be specified by use of the /subject="SUBJECT"
* qualifier.
*
* If your mailer uses another syntax, some hacking of the
* mailform(), mailmsg() and reply_by_mail() functions in
* LYMail.c, and printfile() function in LYPrint.c, may be
* required.
*/
#define SYSTEM_MAIL "PMDF SEND"
#define SYSTEM_MAIL_FLAGS "/headers"
/* #define SYSTEM_MAIL "MAIL" */
/* #define SYSTEM_MAIL_FLAGS "" */
/*************************
* Below is the argument for an sprintf command that will add
* "IN%""ADDRESS""" to the Internet mail address given by the user.
* It is structured for PMDF's IN%"INTERNET_ADDRESS" scheme. The %s
* is replaced with the address given by the user. If you are using
* a different Internet mail transport, change the IN appropriately
* (e.g., to SMTP, MX, or WINS), here or in lynx.cfg.
*/
#define MAIL_ADRS "\"IN%%\"\"%s\"\"\""
/*********************************
* On VMS, CSwing (an XTree emulation for VTxxx terminals) is intended for
* use as the Directory/File Manager (sources, objects, or executables are
* available from ftp://narnia.memst.edu/). CSWING_PATH should be defined
* here or in lynx.cfg to your foreign command for CSwing, with any
* regulatory switches you want included. If not defined, or defined as
* a zero-length string ("") or "none" (case-insensitive), the support
* will be disabled. It will also be disabled if the -nobrowse or
* -selective switches are used, or if the file_url restriction is set.
*
* When enabled, the DIRED_MENU command (normally 'f' or 'F') will invoke
* CSwing, normally with the current default directory as an argument to
* position the user on that node of the directory tree. However, if the
* current document is a local directory listing, or a local file and not
* one of the temporary menu or list files, the associated directory will
* be passed as an argument, to position the user on that node of the tree.
*/
/* #define CSWING_PATH "swing" */
/*********************************
* If USE_FIXED_RECORDS is set to TRUE here and/or in lynx.cfg, Lynx will
* convert 'd'ownloaded binary files to FIXED 512 record format before saving
* them to disk or acting on a DOWNLOADER option. If set to FALSE, the
* headers of such files will indicate that they are Stream_LF with Implied
* Carriage Control, which is incorrect, and can cause downloading software
* to get confused and unhappy. If you do set it FALSE, you can use the
* FIXED512.COM command file, which is included in this distribution, to do
* the conversion externally.
*/
#define USE_FIXED_RECORDS TRUE /* convert binaries to FIXED 512 */
/********************************
* If NO_ANONYMOUS_EMAIL is defined, Lynx will not offer to insert X-From
* and X_Personal_Name lines in the body of email messages. On VMS, the
* actual From and Personal Name (if defined for the account) headers always
* are those of the account running the Lynx image. If the account is not
* the one to which the recipient should reply, you can indicate the alternate
* address and personal name via the X-From and X_Personal_Name entries, but
* the recipient must explicitly send the reply to the X_From address, rather
* than using the VMS REPLY command (which will use the actual From address).
*
* This symbol constant might be defined on Unix for security reasons that
* don't apply on VMS. There is no security reason for defining this on VMS,
* but if you have no anonymous accounts (i.e., the From always will point to
* the actual user's email address, you can define it to avoid the bother of
* X-From and X_Personal_Name offers.
*/
/*#define NO_ANONYMOUS_EMAIL TRUE */
/**************************
* LYNX_LSS_FILE is the location and name of the default lynx
* character style sheet file. It is sought and processed at
* startup of Lynx only if experimental character style code has
* been compiled in, otherwise it will be ignored. Note that use
* of the character style option is _experimental_ AND _unsupported_.
* There is no documentation other than a sample lynx.lss file in
* the samples subdirectory. This code probably won't even work on
* VMS. You can define the location and name of this file via an
* environment variable, "lynx_lss", which will override the definition
* here. You can use '~' to refer to the user's home directory. The
* -lss command line switch will override these definitions.
*/
#ifndef LYNX_LSS_FILE
#define LYNX_LSS_FILE "Lynx_Dir:lynx.lss"
#endif /* LYNX_LSS_FILE */
/*
* FTP_FORMAT uses the same codes as LIST_FORMAT, but applies to files shown
* in an ftp listing.
*/
#define FTP_FORMAT "%d %-16.16t %a %K"
/*******************************************************************
* Things you must change - non-VMS specific
* Section 1b).
*/
#else /* non-VMS: UNIX etc. */
/**************************
* NOTE: This variable is set by the configure script; editing changes will
* be ignored.
*
* LYNX_CFG_FILE is the location and name of the default lynx
* global configuration file. It is sought and processed at
* startup of Lynx, followed by a seek and processing of a
* personal RC file (.lynxrc in the user's HOME directory,
* created if the user saves values in the 'o'ptions menu).
* You also can define the location and name of the global
* configuration file via an environment variable, "LYNX_CFG",
* which will override the "LYNX_CFG_FILE" definition here.
* You can use '~' in either or both definitions if you want
* lynx.cfg treated as a personal configuration file. The
* -cfg command line switch will override these definitions.
* You can pass the compilation default via the Makefile.
*
* If you are building Lynx using the configure script, you should specify
* the default location of the configuration file via that script, since it
* also generates the makefile and install-cfg rules.
*
* Note that many implementations of telnetd allow passing of
* environment variables, which might be used by unscrupulous
* people to modify the environment in anonymous accounts. When
* making Lynx and Web access publicly available via anonymous
* accounts intended to run Lynx captively, be sure the wrapper
* uses the -cfg switch and specifies the startfile, rather than
* relying on the LYNX_CFG, LYNX_CFG_FILE, or WWW_HOME variables.
*
* Note that any SUFFIX or VIEWER mappings in the configuration
* file will be overridden by any suffix or viewer mappings
* that are established as defaults in src/HTInit.c. You can
* override the src/HTInit.c defaults via the mime.types and
* mailcap files (see the examples in the samples directory).
*/
#ifndef HAVE_CONFIG_H
#ifndef LYNX_CFG_FILE
#ifdef DOSPATH
#define LYNX_CFG_PATH "."
#define LYNX_CFG_FILE "./lynx.cfg"
#else
#define LYNX_CFG_PATH "/usr/local/lib"
#define LYNX_CFG_FILE "/usr/local/lib/lynx.cfg"
#endif /* DOSPATH */
#endif /* LYNX_CFG_FILE */
#endif /* HAVE_CONFIG_H */
#ifndef MIME_LIBDIR
#define MIME_LIBDIR "/etc/"
#endif
/**************************
* The EXTENSION_MAP file allows you to map file suffixes to
* mime types.
* The file locations defined here can be overridden in lynx.cfg.
* Mappings in these global and personal files override any SUFFIX
* definitions in lynx.cfg and built-in defaults from src/HTInit.c.
*/
#define GLOBAL_EXTENSION_MAP MIME_LIBDIR "mime.types"
#define PERSONAL_EXTENSION_MAP "~/.mime.types"
/**************************
* The MAILCAP file allows you to map file MIME types to
* external viewers.
* The file locations defined here can be overridden in lynx.cfg.
* Mappings in these global and personal files override any VIEWER
* definitions in lynx.cfg and built-in defaults from src/HTInit.c.
*/
#define GLOBAL_MAILCAP MIME_LIBDIR "mailcap"
#define PERSONAL_MAILCAP "~/.mailcap"
/**************************
* XLOADIMAGE_COMMAND will be used as a default in src/HTInit.c for
* viewing image content types when the DISPLAY environment variable
* is set. Make it the full path and name of the xli (also known as
* xloadimage or xview) command, or other image viewer. It can be
* anything that will handle GIF, TIFF and other popular image formats
* (xli does). The freeware distribution of xli is available in the
* ftp://ftp.x.org/contrib/ subdirectory. The shareware, xv, also is
* suitable. You must also have a "%s" for the filename; "&" for
* background is optional. The default defined here can be overridden
* in lynx.cfg, or via the global or personal mailcap files.
* Make this NULL if you don't have such a viewer or don't want to
* use any default viewers for image types. Note that open is used as
* the default for NeXT, instead of the XLOADIMAGE_COMMAND definition.
*/
#define XLOADIMAGE_COMMAND "xli %s &"
/**************************
* For UNIX systems, SYSTEM_MAIL and SYSTEM_MAIL_FLAGS are set by the
* configure-script.
*/
/**************************
* A place to put temporary files, it is almost always in "/tmp/"
* for UNIX systems. If you include "$USER" in the definition
* (e.g., "/tmp/$USER"), Lynx will replace the "$USER" with the
* username of the account which invoked the Lynx image. Such
* directories should already exist, and have protections/ACLs set
* so that only the appropriate user(s) will have read/write access.
* If the path includes a tilde (e.g, "~" or "~/lynxtmp"), Lynx will
* replace the tilde with the full path for the user's home.
* The definition here can be overridden at run time by setting a
* "LYNX_TEMP_SPACE" environment variable, or (if that is not set)
* the "TMPDIR" (unix), or "TEMP" or "TMP" (Windows,DOS,OS/2)
* variable.
*/
#define TEMP_SPACE "/tmp/"
/********************************
* Comment this line out to disable code that implements command logging
* and scripting.
*/
#define USE_CMD_LOGGING 1
/********************************
* Comment this line out to disable code that randomizes the names given to
* temporary files.
*/
#define USE_RAND_TEMPNAME 1
/********************************
* Comment this line out to let the user enter his/her email address
* when sending a message. There should be no need to do this unless
* your mailer agent does not put in the From: field for you. (If your
* mailer agent does not automatically put in the From: field, you should
* upgrade, because anonymous mail makes it far too easy for a user to
* spoof someone else's email address.)
*/
/*#define NO_ANONYMOUS_EMAIL TRUE */
/********************************
* LIST_FORMAT defines the display for local files when LONG_LIST
* is defined in the Makefile. The default set here can be changed
* in lynx.cfg.
*
* The percent items in the list are interpreted as follows:
*
* %p Unix-style permission bits
* %l link count
* %o owner of file
* %g group of file
* %d date of last modification
* %a anchor pointing to file or directory
* %A as above but don't show symbolic links
* %t type of file (description derived from MIME type)
* %T MIME type as known by Lynx (from mime.types or default)
* %k size of file in Kilobytes
* %K as above but omit size for directories
* %s size of file in bytes
*
* Anything between the percent and the letter is passed on to sprintf.
* A double percent yields a literal percent on output. Other characters
* are passed through literally.
*
* If you want only the filename: " %a"
*
* If you want a brief output: " %4K %-12.12d %a"
*
* For the Unix "ls -l" format: " %p %4l %-8.8o %-8.8g %7s %-12.12d %a"
*/
#ifdef DOSPATH
#define LIST_FORMAT " %4K %-12.12d %a"
#else
#define LIST_FORMAT " %p %4l %-8.8o %-8.8g %7s %-12.12d %a"
#endif
/*
* FTP_FORMAT uses the same codes as LIST_FORMAT, but applies to files shown
* in an ftp listing.
*/
#define FTP_FORMAT "%d %-16.16t %a %K"
/*
* If NO_FORCED_CORE_DUMP is set to TRUE, Lynx will not force
* core dumps via abort() calls on fatal errors or assert()
* calls to check potentially fatal errors. The default defined
* here can be changed in lynx.cfg, and the compilation or
* configuration default can be toggled via the -core command
* line switch.
*/
#define NO_FORCED_CORE_DUMP FALSE
/**************************
* LYNX_LSS_FILE is the location and name of the default lynx
* character style sheet file. It is sought and processed at
* startup of Lynx only if experimental character style code
* has been compiled in, otherwise it will be ignored. Note
* that use of the character style option is _experimental_ AND
* _unsupported_. There is no documentation other than a sample
* lynx.lss file in the samples subdirectory. You also can
* define the location and name of this file via environment
* variables "LYNX_LSS" or "lynx_lss" which will override the
* "LYNX_LSS_FILE" definition here. You can use '~' in either or
* both definitions to refer to the user's home directory. The
* -lss command line switch will override these definitions.
*/
#ifndef LYNX_LSS_FILE
#ifdef DOSPATH
#define LYNX_LSS_FILE "lynx.lss"
#else
#define LYNX_LSS_FILE "/usr/local/lib/lynx.lss"
#endif
#endif /* LYNX_LSS_FILE */
#endif /* VMS OR UNIX */
/*************************************************************
* Section 1c) Every platform must change or verify these
*
*/
/*****************************
* STARTFILE is the default starting URL if none is specified
* on the command line or via a WWW_HOME environment variable;
* Lynx will refuse to start without a starting URL of some kind.
* STARTFILE can be remote, e.g., http://www.w3.org/default.html ,
* or local, e.g., file://localhost/PATH_TO/FILENAME ,
* where PATH_TO is replaced with the complete path to FILENAME
* using Unix shell syntax and including the device on VMS.
*
* Normally we expect you will connect to a remote site, e.g., the Lynx starting
* site:
*/
#ifndef HOMEPAGE_URL
#define HOMEPAGE_URL "https://lynx.invisible-island.net/"
#endif
#define STARTFILE HOMEPAGE_URL
/*
* As an alternative, you may want to use a local URL. A good choice for this
* is the user's home directory:
*#define STARTFILE "file://localhost/~/"
*
* Your choice of STARTFILE should reflect your site's needs, and be a URL that
* you can connect to reliably. Otherwise users will become confused and think
* that they cannot run Lynx.
*/
/*****************************
* HELPFILE must be defined as a URL and must have a
* complete path if local:
* file://localhost/PATH_TO/lynx_help/lynx_help_main.html
* Replace PATH_TO with the path to the lynx_help subdirectory
* for this distribution (use SHELL syntax including the device
* on VMS systems).
* The default HELPFILE is:
* https://lynx.invisible-island.net/lynx_help/lynx_help_main.html
* This should be changed here or in lynx.cfg to the local path.
* The definition here can be overridden at run time by defining a
* "LYNX_HELPFILE" environment variable.
*/
#define HELPFILE "https://lynx.invisible-island.net/lynx_help/lynx_help_main.html"
/* #define HELPFILE "file://localhost/PATH_TO/lynx_help/lynx_help_main.html" */
/*****************************
* DEFAULT_INDEX_FILE is the default file retrieved when the
* user presses the 'I' key when viewing any document.
* An index to your CWIS can be placed here or a document containing
* pointers to lots of interesting places on the web.
*/
#define DEFAULT_INDEX_FILE "http://scout.wisc.edu/"
/*****************************
* If USE_TRACE_LOG is set FALSE, then when TRACE mode is invoked the
* syserr messages will not be directed to a log file named Lynx.trace
* in the account's HOME directory. The default defined here can be
* toggled via the -tlog command line switch. Also, it is set FALSE
* automatically when Lynx is executed in an anonymous or validation
* account (if indicated via the -anonymous or -validate command line
* switches, or via the check for the ANONYMOUS_USER, defined below).
* When FALSE, the TRACE_LOG command (normally ';') cannot be used to
* examine the Lynx Trace Log during the current session. If left
* TRUE, but you wish to use command line piping of stderr to a file
* you specify, include the -tlog toggle on the command line. Note
* that once TRACE mode is turned on during a session and stderr is
* directed to the log, all stderr messages will continue going to
* the log, even if TRACE mode is turned off via the TOGGLE_TRACE
* (Control-T) command.
*/
#define USE_TRACE_LOG TRUE
/*******************************
* If GOTOBUFFER is set to TRUE here or in lynx.cfg the last entered
* goto URL, if any, will be offered as a default for reuse or editing
* when the 'g'oto command is entered. All previously used goto URLs
* can be accessed for reuse or editing via a circular buffer invoked
* with the Up-Arrow or Down-Arrow keys after entering the 'g'oto
* command, whether or not a default is offered.
*/
#define GOTOBUFFER FALSE
/*****************************
* If FTP_PASSIVE is set to TRUE here or in lynx.cfg, ftp transfers will
* be done in passive mode.
* Note: if passive transfers fail, lynx falls back to active mode, and
* vice versa if active transfers fail at first.
*/
#define FTP_PASSIVE TRUE
/*****************************
* JUMPFILE is the default local file checked for shortcut URLs when
* the user presses the 'J' (JUMP) key. The user will be prompted for
* a shortcut entry (analogously to 'g'oto), and can enter one
* or use '?' for a list of the shortcuts with associated links to
* their actual URLs. See the sample jumps files in the samples
* subdirectory. Make sure your jumps file includes a '?' shortcut
* for a file://localhost URL to itself:
*
* <dt>?<dd><a href="file://localhost/path/jumps.html">This Shortcut List</a>
*
* If not defined here or in lynx.cfg, the JUMP command will invoke
* the NO_JUMPFILE status line message (see LYMessages_en.h). The prompt
* associated with the default jumps file is defined as JUMP_PROMPT in
* LYMessages_en.h and can be modified in lynx.cfg. Additional, alternate
* jumps files can be defined and mapped to keystrokes, and alternate
* prompts can be set for them, in lynx.cfg, but at least one default
* jumps file and associated prompt should be established before adding
* others.
*
* On VMS, use Unix SHELL syntax (including a lead slash) to define it.
*
* Do not include "file://localhost" in the definition.
*/
/* #define JUMPFILE "/Lynx_Dir/jumps.html" */
/*******************************
* If JUMPBUFFER is set to TRUE here or in lynx.cfg the last entered
* jump shortcut, if any, will be offered as a default for reuse or
* editing when the JUMP command is entered. All previously used
* shortcuts can be accessed for reuse or editing via a circular buffer
* invoked with the Up-Arrow or Down-Arrow keys after entering the JUMP
* command, whether or not a default is offered. If you have multiple
* jumps files and corresponding key mappings, each will have its own
* circular buffer.
*/
#define JUMPBUFFER FALSE
/********************************
* If PERMIT_GOTO_FROM_JUMP is defined, then a : or / in a jump target
* will be treated as a full or partial URL (to be resolved versus the
* startfile), and will be handled analogously to a 'g'oto command.
* Such "random URLs" will be entered in the circular buffer for goto
* URLs, not the buffer for jump targets (shortcuts). If the target
* is the single character ':', it will be treated equivalently to an
* Up-Arrow or Down-Arrow following a 'g'oto command, for accessing the
* circular buffer of goto URLs.
*/
/* #define PERMIT_GOTO_FROM_JUMP */
/*****************************
* If LYNX_HOST_NAME is defined here and/or in lynx.cfg, it will be
* treated as an alias for the local host name in checks for URLs on
* the local host (e.g., when the -localhost switch is set), and this
* host name, "localhost", and HTHostName (the fully qualified domain
* name of the system on which Lynx is running) will all be passed as
* local. A different definition in lynx.cfg will override this one.
*/
/* #define LYNX_HOST_NAME "localhost" */
/*********************
* LOCAL_DOMAIN is used for a tail match with the ut_host element of
* the utmp or utmpx structure on systems with utmp capabilities, to
* determine if a user is local to your campus or organization when
* handling -restrictions=inside_foo or outside_foo settings for ftp,
* news, telnet/tn3270 and rlogin URLs. An "inside" user is assumed
* if your system does not have utmp capabilities. CHANGE THIS here
* or in lynx.cfg.
*/
#define LOCAL_DOMAIN "localdomain"
/********************************
* The DEFAULT_CACHE_SIZE specifies the number of WWW documents to be
* cached in memory at one time.
*
* This so-called cache size (actually, number) may be modified in lynx.cfg
* and or with the command line argument -cache=NUMBER The minimum allowed
* value is 2, for the current document and at least one to fetch, and there
* is no absolute maximum number of cached documents. On Unix, and VMS not
* compiled with VAXC, whenever the number is exceeded the least recently
* displayed document will be removed from memory.
*
* On VMS compiled with VAXC, the DEFAULT_VIRTUAL_MEMORY_SIZE specifies the
* amount (bytes) of virtual memory that can be allocated and not yet be freed
* before previous documents are removed from memory. If the values for both
* the DEFAULT_CACHE_SIZE and DEFAULT_VIRTUAL_MEMORY_SIZE are exceeded, then
* least recently displayed documents will be freed until one or the other
* value is no longer exceeded. The value can be modified in lynx.cfg.
*
* The Unix and VMS but not VAXC implementations use the C library malloc's
* and calloc's for memory allocation, and procedures for taking the actual
* amount of cache into account still need to be developed. They use only
* the DEFAULT_CACHE_SIZE value, and that specifies the absolute maximum
* number of documents to cache (rather than the maximum number only if
* DEFAULT_VIRTUAL_MEMORY_SIZE has been exceeded, as with VAXC/VAX).
*/
#define DEFAULT_CACHE_SIZE 10
#if defined(VMS) && defined(VAXC) && !defined(__DECC)
#define DEFAULT_VIRTUAL_MEMORY_SIZE 512000
#endif /* VMS && VAXC && !__DECC */
/********************************
* If ALWAYS_RESUBMIT_POSTS is set TRUE, Lynx always will resubmit forms
* with method POST, dumping any cache from a previous submission of the
* form, including when the document returned by that form is sought with
* the PREV_DOC command or via the history list. Lynx always resubmits
* forms with method POST when a submit button or a submitting text input
* is activated, but normally retrieves the previously returned document
* if it had links which you activated, and then go back with the PREV_DOC
* command or via the history list.
*
* The default defined here can be changed in lynx.cfg, and can be toggled
* via the -resubmit_posts command line switch.
*/
#define ALWAYS_RESUBMIT_POSTS FALSE
/********************************
* CHARACTER_SET defines the default character set, i.e., that assumed
* to be installed on the user's terminal. It determines which characters
* or strings will be used to represent 8-bit character entities within
* HTML. New character sets may be defined as explained in the README
* files of the src/chrtrans directory in the Lynx source code distribution.
* For Asian (CJK) character sets, it also determines how Kanji code will
* be handled. The default defined here can be changed in lynx.cfg, and
* via the 'o'ptions menu. The 'o'ptions menu setting will be stored in
* the user's RC file whenever those settings are saved, and thereafter
* will be used as the default. Also see lynx.cfg for information about
* the -raw switch and LYK_RAW_TOGGLE command.
*
* Since Lynx now supports a wide range of platforms it may be useful
* to note that cpXXX codepages used by IBM PC compatible computers,
* and windows-xxxx used by native MS-Windows apps.
*
* Recognized character sets include:
*
* string for 'O'ptions Menu MIME name
* =========================== =========
* 7 bit approximations (US-ASCII) us-ascii
* Western (ISO-8859-1) iso-8859-1
* Western (cp850) cp850
* Western (windows-1252) windows-1252
* IBM PC US codepage (cp437) cp437
* DEC Multinational dec-mcs
* Macintosh (8 bit) macintosh
* NeXT character set next
* HP Roman8 hp-roman8
* Chinese euc-cn
* Japanese (EUC-JP) euc-jp
* Japanese (Shift_JIS) shift_jis
* Korean euc-kr
* Taipei (Big5) big5
* Vietnamese (VISCII) viscii
* Eastern European (ISO-8859-2) iso-8859-2
* Eastern European (cp852) cp852
* Eastern European (windows-1250) windows-1250
* Latin 3 (ISO-8859-3) iso-8859-3
* Latin 4 (ISO-8859-4) iso-8859-4
* Baltic Rim (cp775) cp775
* Baltic Rim (windows-1257) windows-1257
* Cyrillic (ISO-8859-5) iso-8859-5
* Cyrillic (cp866) cp866
* Cyrillic (windows-1251) windows-1251
* Cyrillic (KOI8-R) koi8-r
* Arabic (ISO-8859-6) iso-8859-6
* Arabic (cp864) cp864
* Arabic (windows-1256) windows-1256
* Greek (ISO-8859-7) iso-8859-7
* Greek (cp737) cp737
* Greek2 (cp869) cp869
* Greek (windows-1253) windows-1253
* Hebrew (ISO-8859-8) iso-8859-8
* Hebrew (cp862) cp862
* Hebrew (windows-1255) windows-1255
* Turkish (ISO-8859-9) iso-8859-9
* ISO-8859-10 iso-8859-10
* Ukrainian Cyrillic (cp866u) cp866u
* Ukrainian Cyrillic (KOI8-U) koi8-u
* UNICODE (UTF-8) utf-8
* RFC 1345 w/o Intro mnemonic+ascii+0
* RFC 1345 Mnemonic mnemonic
* Transparent x-transparent
*/
#define CHARACTER_SET "iso-8859-1"
/*****************************
* PREFERRED_LANGUAGE is the language in MIME notation (e.g., "en",
* "fr") which will be indicated by Lynx in its Accept-Language headers
* as the preferred language. If available, the document will be
* transmitted in that language. This definition can be overridden via
* lynx.cfg. Users also can change it via the 'o'ptions menu and save
* that preference in their RC file. This may be a comma-separated list
* of languages in decreasing preference.
*/
#define PREFERRED_LANGUAGE "en"
/*****************************
* PREFERRED_CHARSET specifies the character set in MIME notation (e.g.,
* "ISO-8859-2", "ISO-8859-5") which Lynx will indicate you prefer in
* requests to http servers using an Accept-Charsets header.
* This definition can be overridden via lynx.cfg. Users also can change it
* via the 'o'ptions menu and save that preference in their RC file.
* The value should NOT include "ISO-8859-1" or "US-ASCII", since those
* values are always assumed by default.
* If a file in that character set is available, the server will send it.
* If no Accept-Charset header is present, the default is that any
* character set is acceptable. If an Accept-Charset header is present,
* and if the server cannot send a response which is acceptable
* according to the Accept-Charset header, then the server SHOULD send
* an error response with the 406 (not acceptable) status code, though
* the sending of an unacceptable response is also allowed. (RFC2068)
*/
#define PREFERRED_CHARSET ""
/*****************************
* If MULTI_BOOKMARK_SUPPORT is set to MBM_STANDARD or MBM_ADVANCED, and
* BLOCK_MULTI_BOOKMARKS (see below) is FALSE, and sub-bookmarks exist, all
* bookmark operations will first prompt the user to select an active
* sub-bookmark file or the default bookmark file. MBM_OFF is the default so
* that one (the default) bookmark file will be available initially. The
* default set here can be overridden in lynx.cfg. The user can turn on
* multiple bookmark support via the 'o'ptions menu, and can save that choice as
* the startup default via the .lynxrc file. When on, the setting can be
* STANDARD or ADVANCED. If support is set to the latter, and the user mode
* also is ADVANCED, the VIEW_BOOKMARK command will invoke a status line prompt
* at which the user can enter the letter token (A - Z) of the desired bookmark,
* or '=' to get a menu of available bookmark files. The menu always is
* presented in NOVICE or INTERMEDIATE mode, or if the support is set to
* STANDARD. No prompting or menu display occurs if only one (the startup
* default) bookmark file has been defined (define additional ones via the
* 'o'ptions menu). The startup default, however set, can be overridden on the
* command line via the -restrictions=multibook or the -anonymous or -validate
* switches.
*/
#ifndef MULTI_BOOKMARK_SUPPORT
#define MULTI_BOOKMARK_SUPPORT MBM_OFF
#endif /* MULTI_BOOKMARK_SUPPORT */
/*****************************
* If BLOCK_MULTI_BOOKMARKS is set TRUE, multiple bookmark support will
* be forced off, and cannot be toggled on via the 'o'ptions menu. This
* compilation setting can be overridden via lynx.cfg.
*/
#ifndef BLOCK_MULTI_BOOKMARKS
#define BLOCK_MULTI_BOOKMARKS FALSE
#endif /* BLOCK_MULTI_BOOKMARKS */
/********************************
* URL_DOMAIN_PREFIXES and URL_DOMAIN_SUFFIXES are strings which will be
* prepended (together with a scheme://) and appended to the first element
* of command line or 'g'oto arguments which are not complete URLs and
* cannot be opened as a local file (file://localhost/string). Both
* can be comma-separated lists. Each prefix must end with a dot, each
* suffix must begin with a dot, and either may contain other dots (e.g.,
* .co.jp). The default lists are defined here, and can be changed
* in lynx.cfg. Each prefix will be used with each suffix, in order,
* until a valid Internet host is created, based on a successful DNS
* lookup (e.g., foo will be tested as www.foo.com and then www.foo.edu
* etc.). The first element can include a :port and/or /path which will
* be restored with the expanded host (e.g., wfbr:8002/dir/lynx will
* become http://www.wfbr.edu:8002/dir/lynx). The prefixes will not be
* used if the first element ends in a dot (or has a dot before the
* :port or /path), and similarly the suffixes will not be used if the
* the first element begins with a dot (e.g., .nyu.edu will become
* http://www.nyu.edu without testing www.nyu.com). Lynx will try to
* guess the scheme based on the first field of the expanded host name,
* and use "http://" as the default (e.g., gopher.wfbr.edu or gopher.wfbr.
* will be made gopher://gopher.wfbr.edu).
*/
#define URL_DOMAIN_PREFIXES "www."
#define URL_DOMAIN_SUFFIXES ".com,.edu,.net,.org"
/********************************
* If LIST_NEWS_NUMBERS is set TRUE, Lynx will use an ordered list
* and include the numbers of articles in news listings, instead of
* using an unordered list.
*
* The default defined here can be changed in lynx.cfg.
*/
#define LIST_NEWS_NUMBERS FALSE
/********************************
* If LIST_NEWS_DATES is set TRUE, Lynx will include the dates of
* articles in news listings. The dates always are included in the
* articles, themselves.
*
* The default defined here can be changed in lynx.cfg.
*/
#define LIST_NEWS_DATES FALSE
/*************************
* Set NEWS_POSTING to FALSE if you do not want to support posting to
* news groups via Lynx. If left TRUE, Lynx will use its news gateway to
* post new messages or followups to news groups, using the URL schemes
* described in the "Supported URL" section of the online 'h'elp. The
* posts will be attempted via the nntp server specified in the URL, or
* if none was specified, via the NNTPSERVER configuration or environment
* variable. Links with these URLs for posting or sending followups are
* created by the news gateway when reading group listings or articles
* from nntp servers if the server indicates that it permits posting.
* The setting here can be changed in lynx.cfg.
*/
#define NEWS_POSTING TRUE
/*************************
* Define LYNX_SIG_FILE to the name of a file containing a signature which
* can be appended to email messages and news postings or followups. The
* user will be prompted whether to append it. It is sought in the home
* directory. If it is in a subdirectory, begin it with a dot-slash
* (e.g., ./lynx/.lynxsig). The definition here can be changed in lynx.cfg.
*/
#define LYNX_SIG_FILE ".lynxsig"
/********************************
* BIBP_GLOBAL_SERVER is the default global server for bibp: links, used
* when a local bibhost or document-specified citehost is unavailable.
*/
#define BIBP_GLOBAL_SERVER "http://usin.org/"
/********************************
* If USE_SELECT_POPUPS is set FALSE, Lynx will present a vertical list
* of radio buttons for the OPTIONs in SELECT blocks which lack the
* MULTIPLE attribute, instead of using a popup menu. Note that if
* the MULTIPLE attribute is present in the SELECT start tag, Lynx
* always will create a vertical list of checkboxes for the OPTIONs.
*
* The default defined here can be changed in lynx.cfg. It can be
* set and saved via the 'o'ptions menu to override the compilation
* and configuration defaults, and the default always can be toggled
* via the -popup command line switch.
*/
#define USE_SELECT_POPUPS TRUE
/********************************
* If COLLAPSE_BR_TAGS is set FALSE, Lynx will not collapse serial
* BR tags. If set TRUE, two or more concurrent BRs will be collapsed
* into a single blank line. Note that the valid way to insert extra
* blank lines in HTML is via a PRE block with only newlines in the
* block.
*
* The default defined here can be changed in lynx.cfg.
*/
#define COLLAPSE_BR_TAGS TRUE
/********************************
* If SET_COOKIES is set FALSE, Lynx will ignore Set-Cookie headers
* in http server replies.
*
* The default defined here can be changed in lynx.cfg, and can be toggled
* via the -cookies command line switch.
*/
#define SET_COOKIES TRUE
/********************************
* If SEND_USERAGENT is set FALSE, Lynx will not send a user-agent string.
* You can override this in the 'O'ptions menu.
*/
#define SEND_USERAGENT TRUE
/*******************************
* If ACCEPT_ALL_COOKIES is set TRUE, and SET_COOKIES is TRUE, Lynx will
* accept all cookies.
*
* The default defined here can be changed in lynx.cfg, and .lynxrc, or
* toggled via the -accept_all_cookies command line switch.
*/
#define ACCEPT_ALL_COOKIES FALSE
/****************************************************************
* Section 2. Things that you probably want to change or review
*
*/
/*****************************
* The following three definitions set the number of seconds for
* pauses following status line messages that would otherwise be
* replaced immediately, and are more important than the unpaused
* progress messages. Those set by INFOSECS are also basically
* progress messages (e.g., that a prompted input has been canceled)
* and should have the shortest pause. Those set by MESSAGESECS are
* informational (e.g., that a function is disabled) and should have
* a pause of intermediate duration. Those set by ALERTSECS typically
* report a serious problem and should be paused long enough to read
* whenever they appear (typically unexpectedly). The default values
* defined here can be modified via lynx.cfg, should longer pauses be
* desired for braille-based access to Lynx.
*/
#define INFOSECS 1
#define MESSAGESECS 2
#define ALERTSECS 3
#define DEBUGSECS 0
#define REPLAYSECS 0
/******************************
* SHOW_COLOR controls whether the program displays in color by default.
*/
#ifdef COLOR_CURSES
#define SHOW_COLOR TRUE
#else
#define SHOW_COLOR FALSE
#endif
/******************************
* SHOW_CURSOR controls whether or not the cursor is hidden or appears
* over the current link, or current option in select popup windows.
* Showing the cursor is handy if you are a sighted user with a poor
* terminal that can't do bold and reverse video at the same time or
* at all. It also can be useful to blind users, as an alternative
* or supplement to setting LINKS_AND_FIELDS_ARE_NUMBERED or
* LINKS_ARE_NUMBERED.
*
* The default defined here can be changed in lynx.cfg. It can be
* set and saved via the 'o'ptions menu to override the compilation
* and configuration defaults, and the default always can be toggled
* via the -show_cursor command line switch.
*/
#define SHOW_CURSOR FALSE
/******************************
* UNDERLINE_LINKS controls whether links are underlined by default, or shown
* in bold. Normally this default is set from the configure script.
*/
#ifndef HAVE_CONFIG_H
#define UNDERLINE_LINKS FALSE
#endif
/******************************
* VERBOSE_IMAGES controls whether or not Lynx replaces the [LINK], [INLINE]
* and [IMAGE] comments (for images without ALT) with filenames of these
* images. This is extremely useful because now we can determine immediately
* what images are just decorations (button.gif, line.gif) and what images are
* important.
*
* The default defined here can be changed in lynx.cfg.
*/
#define VERBOSE_IMAGES TRUE
/******************************
* BOXVERT and BOXHORI control the layout of popup menus. Set to 0 if your