Syncronizing doc with sources

This commit is contained in:
Alexander S. Aganichev 2001-11-23 09:51:06 +00:00
parent 260ac3c634
commit 029014ab20
2 changed files with 438 additions and 160 deletions

View File

@ -82,8 +82,6 @@ void gareafile::ReadSquishFile(char* path, char* file, char* options, char* orig
case CRC_AREASBBS: case CRC_AREASBBS:
strcpy(buf2, val); strcpy(buf2, val);
MakePathname(buf2, path, buf2); MakePathname(buf2, path, buf2);
if(striinc("/NOCHK", options) or striinc("-NOCHK", options))
strcat(buf2, " /NOCHK");
ReadAreasBBS(buf2); ReadAreasBBS(buf2);
break; break;
case CRC_NETAREA: case CRC_NETAREA:

View File

@ -2340,7 +2340,7 @@ APP OtherProg IRQ 5</eg>
Default: Default:
</label> </label>
<item> <item>
LONG <ident/LONG/
</item> </item>
<label> <label>
Processed by: Processed by:
@ -2605,7 +2605,7 @@ AREA:&lt;OriginalEchoID&gt;</eg>
<item> <item>
<!-- FIX ME!!! --><kw/READcopymoveforward/, <!-- FIX ME!!! --><kw/READcopymoveforward/,
<ref target=AREACOPYADDID><kw/AREACOPYADDID/</ref>, <ref target=AREACOPYADDID><kw/AREACOPYADDID/</ref>,
<ref target=AREACOPYTO><kw/AREACOPYTO/</ref> <ref target=AREACOPYTO><kw/AREACOPYTO/</ref>,
<ref target=AREAFORWARDDIRECT><kw/AREAFORWARDDIRECT/</ref>, <ref target=AREAFORWARDDIRECT><kw/AREAFORWARDDIRECT/</ref>,
<ref target=AREAFREQDIRECT><kw/AREAFREQDIRECT/</ref>, <ref target=AREAFREQDIRECT><kw/AREAFREQDIRECT/</ref>,
<ref target=AREAREPLYDIRECT><kw/AREAREPLYDIRECT/</ref> <ref target=AREAREPLYDIRECT><kw/AREAREPLYDIRECT/</ref>
@ -2797,8 +2797,8 @@ AREA:&lt;OriginalEchoID&gt;</eg>
<ptr target=MESSAGEATTRS> chapter, <ptr target=MESSAGEATTRS> chapter,
<ref target=AREA><kw/AREA/</ref>, <ref target=AREA><kw/AREA/</ref>,
<ref target=AREADESC><kw/AREADESC/</ref>, <ref target=AREADESC><kw/AREADESC/</ref>,
<ref target=AREAFILE><kw/AREAFILE/</ref>,
<ref target=AREAEXCL><kw/AREAEXCL/</ref>, <ref target=AREAEXCL><kw/AREAEXCL/</ref>,
<ref target=AREAFILE><kw/AREAFILE/</ref>,
<ref target=AREAINCL><kw/AREAINCL/</ref>, <ref target=AREAINCL><kw/AREAINCL/</ref>,
<ref target=AREAISEMAIL><kw/AREAISEMAIL/</ref>, <ref target=AREAISEMAIL><kw/AREAISEMAIL/</ref>,
<ref target=AREAISNEWS><kw/AREAISNEWS/</ref>, <ref target=AREAISNEWS><kw/AREAISNEWS/</ref>,
@ -2935,56 +2935,103 @@ AREA:&lt;OriginalEchoID&gt;</eg>
</item> </item>
</list> </list>
</div2> </div2>
<!-- finished here -->
<div2 id=AREAEXCL> <div2 id=AREAEXCL>
<head> <head>
AREAEXCL &lt;echoid mask&gt; AREAEXCL
</head> </head>
<p> <list type=gloss>
With this keyword, you can define the echoids of areas which should be <label>
ignored by <name>GoldED+</name> (thereby leaving them out of the Synopsis:
arealist). This is normally used in connection with <kw>AREAFILE</kw>, </label>
to exclude areas you are not interested in reading. <item>
<name>DOS</name>/<name>4DOS</name>-style wildcards (* and ?) can be <kw/AREAEXCL/ <ident/&lt;echoid mask&gt;/
used in the echoid mask. </item>
</p> <label>
<p> Description:
Examples:<eg> </label>
<item>
With this keyword, you can define the echoids of areas which should
be ignored by <name/GoldED+/ (thereby leaving them out of the
arealist). This is normally used in connection with
<ref target=AREAFILE><kw/AREAFILE/</ref>, to exclude areas you are
not interested in reading.
</item>
<label>
Parameters:
</label>
<item>
The <ident/&lt;echoid mask&gt;/ may contain <name>4DOS</name>-style
wildcards (<q/*/ and <q/?/).
</item>
<label>
Notes:
</label>
<item>
You can use the <ref target=AREAINCL><kw/AREAINCL/</ref> keyword to
reinclude areas which have been excluded with <kw/AREAEXCL/.<lb>
This keyword must be placed before any of
<ref target=AREA><kw/AREA/</ref>,
<ref target=AREADEF><kw/AREADEF/</ref>,
or <ref target=AREAFILE><kw/AREAFILE/</ref> keywords.
</item>
<label>
Processed by:
</label>
<item>
Mail reader.
</item>
<label>
See also:
</label>
<item>
<ref target=AREA><kw/AREA/</ref>,
<ref target=AREADEF><kw/AREADEF/</ref>,
<ref target=AREAFILE><kw/AREAFILE/</ref>,
<ref target=AREAINCL><kw/AREAINCL/</ref>,
<ref target=AREARENAME><kw/AREARENAME/</ref>
</item>
<label>
Example:
</label>
<item><eg>
AREAEXCL * ; Excludes all areas. AREAEXCL * ; Excludes all areas.
AREAEXCL *INTER* ; Excludes all areas containing INTER anywhere in the AREAEXCL *INTER* ; Excludes all areas containing INTER anywhere in the
; echoid. ; echoid.
AREAEXCL INT*.* ; Excludes all areas beginning with INT and AREAEXCL INT*.* ; Excludes all areas beginning with INT and
; containing a dot anywhere in the echoid.</eg> ; containing a dot anywhere in the echoid.</eg>
</p> </item>
<p> </list>
You can use the <kw>AREAINCL</kw> keyword to reinclude areas which have
been excluded with <kw>AREAEXCL</kw>.
</p>
<p>
<hi>NOTE</hi> that this keyword must be placed before any of
<kw>AREA</kw>, <kw>AREADEF</kw> or <kw>AREAFILE</kw> keywords.
</p>
</div2> </div2>
<div2 id=AREAFILE> <div2 id=AREAFILE>
<head> <head>
AREAFILE &lt;type&gt; &lsqb;path/file&rsqb; &lsqb;switches&rsqb; AREAFILE
</head> </head>
<p> <list type=gloss>
<name>GoldED+</name> can read the area setup of many popular mailers, <label>
mail processors and <abbr>BBS</abbr>'es, thereby making it much easier Synopsis:
and simpler to configure <name>GoldED+</name> for the mail areas you </label>
receive, by eliminating the need to write <kw>AREA</kw> lines for all <item>
or most of your areas. <kw/AREAFILE/ <ident>&lt;type&gt; &lsqb;path/file&rsqb;
</p> &lsqb;switches&rsqb;</ident>
<p> </item>
<label>
Description:
</label>
<item>
<name/GoldED+/ can read the area setup of many popular mailers,
mail processors and <abbr/BBS/'es, thereby making it much easier
and simpler to configure <name/GoldED+/ for the mail areas you
receive, by eliminating the need to write area definition lines for
all or most of your areas.
</item>
<label>
Parameters:
</label>
<item>
<table rows=3 cols=2> <table rows=3 cols=2>
<row> <row>
<cell> <cell>
<ident>type</ident> <ident/type/
</cell> </cell>
<cell> <cell>
Name of the program. Name of the program.
@ -3000,120 +3047,363 @@ AREAEXCL INT*.* ; Excludes all areas beginning with INT and
</row> </row>
<row> <row>
<cell> <cell>
<ident>switches</ident> <ident/switches/
</cell> </cell>
<cell> <cell>
Msgbase specific switches. Areafile specific switches.
</cell> </cell>
</row> </row>
</table> </table>
</p> </item>
<p> <label>
For most programs, <name>GoldED+</name> can automatically find the path Notes:
or filename using environment variables. By default, </label>
<name>GoldED+</name> will look for the area setup files in the <item>
<kw>AREAPATH</kw>. For most programs, <name>GoldED+</name> can automatically find the
</p> path or filename using environment variables. By default,
<p> <name/GoldED+/ will look for the area setup files in the
There are switches for sorting the areas, and for turning off an <ref target=AREAPATH><kw/AREAPATH/</ref>.
update-check when <name>GoldED+</name> starts up. </item>
</p> <label>
<p> Processed by:
<name>GoldED+</name> can handle enviroment variables correctly in paths </label>
specified in connection with this keyword. <item>
</p> Mail reader.
<p> </item>
This keyword is explained in greater detail in the <label>
<ptr target=AREACONFIGURATION> chapter. See also:
</p> </label>
<item>
<ptr target=AREACONFIGURATION> chapter,
<ref target=AREA><kw/AREA/</ref>,
<ref target=AREADEF><kw/AREADEF/</ref>,
<ref target=AREAEXCL><kw/AREAEXCL/</ref>,
<ref target=AREAFILE><kw/AREAFILE/</ref>,
<ref target=AREAFILEGROUPS><kw/AREAFILEGROUPS/</ref>,
<ref target=AREAINCL><kw/AREAINCL/</ref>,
<ref target=AREAISEMAIL><kw/AREAISEMAIL/</ref>,
<ref target=AREAISNEWS><kw/AREAISNEWS/</ref>,
<ref target=AREARENAME><kw/AREARENAME/</ref>,
<ref target=AREAPATH><kw/AREAPATH/</ref>,
<ref target=AREASEP><kw/AREASEP/</ref>,
<ref target=ATTRIBSECHO><kw/ATTRIBSECHO/</ref>,
<ref target=ATTRIBSEMAIL><kw/ATTRIBSEMAIL/</ref>,
<ref target=ATTRIBSLOCAL><kw/ATTRIBSLOCAL/</ref>,
<ref target=ATTRIBSNET><kw/ATTRIBSNET/</ref>,
<ref target=ATTRIBSNEWS><kw/ATTRIBSNEWS/</ref>,
<ref target=ATTRIBUTES><kw/ATTRIBUTES/</ref>
</item>
</list>
</div2> </div2>
<div2> <div2>
<head> <head>
AREAFILEGROUPS &lt;(yes)/no&gt; AREAFILEGROUPS
</head> </head>
<p> <list type=gloss>
In some <kw>AREAFILE</kw> setups, you can groups the areas using single <label>
letters (A-Z) or numbers (&num;1-999). If this keyword is enabled, Synopsis:
<name>GoldED+</name> will use the area groupid instead of the area </label>
echoid when gathering area specific information from the Random System. <item>
</p> <kw/AREAFILEGROUPS/ <ident>&lt;YES/NO&gt;</ident>
<p> </item>
See <ptr target=RANDOMSYSTEM> chapter for details. <label>
</p> Description:
</label>
<item>
In some <ref target=AREAFILE><kw/AREAFILE/</ref> setups, you can
groups the areas using single letters (A-Z) or numbers (&num;1-999).
</item>
<label>
Parameters:
</label>
<item>
If this keyword is enabled, <name>GoldED+</name> will use the area
groupid instead of the area echoid when gathering area specific
information from the <ref target=RANDOMSYSTEM>Random System</ref>
group.
</item>
<label>
Default:
</label>
<item>
<ident/YES/
</item>
<label>
Notes:
</label>
<item>
This have only sence if you using <ref target=RANDOMSYSTEM>Random
System</ref> groups.
</item>
<label>
Processed by:
</label>
<item>
Mail reader.
</item>
<label>
See also:
</label>
<item>
<ptr target=RANDOMSYSTEM> chapter
</item>
</list>
</div2> </div2>
<div2 id=AREAFORWARDDIRECT> <div2 id=AREAFORWARDDIRECT>
<head> <head>
AREAFORWARDDIRECT AREAFORWARDDIRECT
</head> </head>
<p></p> <list type=gloss>
<label>
Synopsis:
</label>
<item>
<kw/AREAFORWARDDIRECT/ <ident>&lt;YES/NO&gt;</ident>
</item>
<label>
Description:
</label>
<item>
This keyword controls whether forward functions should bypass area
selection screen. The destination area should be set with
<ref target=AREAREPLYTO><kw/AREAREPLYTO/</ref> keyword.
</item>
<label>
Parameters:
</label>
<item>
If enabled, the destination area selection list is bypassed, thereby
making possible a <q/seamless/ forward to the default destination
area.
</item>
<label>
Default:
</label>
<item>
<ident/NO/
</item>
<label>
Notes:
</label>
<item>
This keyword can be used globally and in a
<ref target=RANDOMSYSTEM>Random System</ref> group.
</item>
<label>
Processed by:
</label>
<item>
Mail reader.
</item>
<label>
See also:
</label>
<item>
<!-- FIX ME!!! --><kw/READcopymoveforward/,
<ref target=AREACOPYDIRECT><kw/AREACOPYDIRECT/</ref>,
<ref target=AREAFREQDIRECT><kw/AREAFREQDIRECT/</ref>,
<ref target=AREAREPLYDIRECT><kw/AREAREPLYDIRECT/</ref>,
<ref target=AREAREPLYTO><kw/AREAREPLYTO/</ref>
</item>
</list>
</div2> </div2>
<div2 id=AREAFREQDIRECT> <div2 id=AREAFREQDIRECT>
<head> <head>
AREAFREQDIRECT &lt;yes/(no)&gt; AREAFREQDIRECT
</head> </head>
<p> <list type=gloss>
<label>
Synopsis:
</label>
<item>
<kw/AREAFREQDIRECT/ <ident>&lt;YES/NO&gt;</ident>
</item>
<label>
Description:
</label>
<item>
This keyword controls whether filerequest functions should bypass
area selection screen. The destination area should be set with
<ref target=AREAFREQTO><kw/AREAFREQTO/</ref> keyword.
</item>
<label>
Parameters:
</label>
<item>
If enabled, the destination area selection list is bypassed, thereby If enabled, the destination area selection list is bypassed, thereby
making possible a <q>seamless</q> file request in the default making possible a <q/seamless/ filerequest in the default
destination area. The destination area should be set with destination area.
<kw>AREAFREQTO</kw>. </item>
</p> <label>
<p> Default:
<hi>TIP:</hi> If you (like most) only have one mailer netmail area, </label>
you should enable the <kw>AREAFREQDIRECT</kw> keyword globally for <item>
simpler file requests. <ident/NO/
</p> </item>
<p> <label>
This keyword can be used globally and in a Random System group. Notes:
</p> </label>
<item>
This keyword can be used globally and in a
<ref target=RANDOMSYSTEM>Random System</ref> group.<lb>
If you (like most) only have one mailer netmail area, you can enable
this feature globally for simpler file requests.
</item>
<label>
Processed by:
</label>
<item>
Mail reader.
</item>
<label>
See also:
</label>
<item>
<!-- FIX ME!!! --><kw/READfilerequest/,
<ref target=AREACOPYDIRECT><kw/AREACOPYDIRECT/</ref>,
<ref target=AREAFORWARDDIRECT><kw/AREAFORWARDDIRECT/</ref>,
<ref target=AREAFREQTO><kw/AREAFREQTO/</ref>,
<ref target=AREAREPLYDIRECT><kw/AREAREPLYDIRECT/</ref>,
<ref target=FRQEXT><kw/FRQEXT/</ref>,
<ref target=FRQNODEMAP><kw/FRQNODEMAP/</ref>,
<ref target=FRQOPTIONS><kw/FRQOPTIONS/</ref>,
<ref target=FRQWAZOO><kw/FRQWAZOO/</ref>,
<ref target=OUTBOUND><kw/OUTBOUND/</ref>
</item>
</list>
</div2> </div2>
<div2 id=AREAFREQTO> <div2 id=AREAFREQTO>
<head> <head>
AREAFREQTO &lt;echoid(first netmail area)&gt; AREAFREQTO
</head> </head>
<p> <list type=gloss>
Sets the default area for the filerequest function. You should set <label>
this to the netmail area where you normally put the filerequest Synopsis:
messages. </label>
</p> <item>
<p> <kw/AREAFREQTO/ <ident/&lt;echoid&gt;/
Note that if <kw>AREAFREQTO</kw> is not specified, it defaults to the </item>
first netmail area found. <label>
</p> Description:
<p> </label>
This keyword can be used globally and in a Random System group. <item>
</p> Sets the default area for the filerequest functions.
<p> </item>
Related keywords: <ref target=AREACOPYTO><kw>AREACOPYTO</kw></ref>, <label>
<ref target=AREAREPLYTO><kw>AREAREPLYTO</kw></ref>. Parameters:
</p> </label>
<item>
The default destination area for the filerequest functions.
</item>
<label>
Default:
</label>
<item>
First netmail area.
</item>
<label>
Notes:
</label>
<item>
This keyword can be used globally and in a
<ref target=RANDOMSYSTEM>Random System</ref> group.<lb>
The forward function uses the
<ref target=AREAREPLYTO><kw/AREAREPLYTO/</ref> area instead.
</item>
<label>
Processed by:
</label>
<item>
Mail reader.
</item>
<label>
See also:
</label>
<item>
<!-- FIX ME!!! --><kw/READfilerequest/,
<ref target=AREACFMREPLYTO><kw/AREACFMREPLYTO/</ref>,
<ref target=AREACOPYTO><kw/AREACOPYTO/</ref>,
<ref target=AREAFREQDIRECT><kw/AREAFREQDIRECT/</ref>,
<ref target=AREAREPLYTO><kw/AREAREPLYTO/</ref>,
<ref target=AREAYOUWROTETO><kw/AREAYOUWROTETO/</ref>,
<ref target=FRQEXT><kw/FRQEXT/</ref>,
<ref target=FRQNODEMAP><kw/FRQNODEMAP/</ref>,
<ref target=FRQOPTIONS><kw/FRQOPTIONS/</ref>,
<ref target=FRQWAZOO><kw/FRQWAZOO/</ref>,
<ref target=OUTBOUND><kw/OUTBOUND/</ref>
</item>
</list>
</div2> </div2>
<div2 id=AREAINCL> <div2 id=AREAINCL>
<head> <head>
AREAINCL &lt;echoid mask&gt; AREAINCL
</head> </head>
<p> <list type=gloss>
With this keyword, you can define the echoids of areas which should be <label>
reincluded by <name>GoldED+</name>, if they have been excluded with the Synopsis:
<kw>AREAEXCL</kw> keyword. <name>DOS</name>/<name>4DOS</name>-style </label>
wildcards (* and ?) can be used in the echoid mask. <item>
</p> <kw/AREAINCL/ <ident/&lt;echoid mask&gt;/
<p> </item>
Examples:<eg> <label>
Description:
</label>
<item>
With this keyword, you can define the echoids of areas which should
be reincluded by <name/GoldED+/, if they have been excluded with the
<ref target=AREAEXCL><kw/AREAEXCL/</ref> keyword.
</item>
<label>
Parameters:
</label>
<item>
The <ident/&lt;echoid mask&gt;/ may contain <name>4DOS</name>-style
wildcards (<q/*/ and <q/?/).
</item>
<label>
Notes:
</label>
<item>
You can use the <kw/AREAINCL/ keyword to reinclude areas which have
been excluded with <ref target=AREAEXCL><kw/AREAEXCL/</ref>.<lb>
This keyword must be placed before any of
<ref target=AREA><kw/AREA/</ref>,
<ref target=AREADEF><kw/AREADEF/</ref>,
or <ref target=AREAFILE><kw/AREAFILE/</ref> keywords.
</item>
<label>
Processed by:
</label>
<item>
Mail reader.
</item>
<label>
See also:
</label>
<item>
<ref target=AREA><kw/AREA/</ref>,
<ref target=AREADEF><kw/AREADEF/</ref>,
<ref target=AREAFILE><kw/AREAFILE/</ref>,
<ref target=AREAEXCL><kw/AREAEXCL/</ref>,
<ref target=AREARENAME><kw/AREARENAME/</ref>
</item>
<label>
Example:
</label>
<item><eg>
AREAINCL * ; Includes all areas. AREAINCL * ; Includes all areas.
AREAINCL *INTER* ; Includes all areas containing INTER anywhere in the AREAINCL *INTER* ; Includes all areas containing INTER anywhere in the
; echoid. ; echoid.
AREAINCL INT*.* ; Includes all areas beginning with INT and AREAINCL INT*.* ; Includes all areas beginning with INT and
; containing a dot anywhere in the echoid.</eg> ; containing a dot anywhere in the echoid.</eg>
</p> </item>
<p> </list>
You can use the <kw>AREAINCL</kw> keyword to reinclude areas which have
been excluded with <kw>AREAEXCL</kw>.
</p>
<p>
<hi>NOTE</hi> that this keyword must be placed before any of
<kw>AREA</kw>, <kw>AREADEF</kw> or <kw>AREAFILE</kw> keywords.
</p>
</div2> </div2>
<!-- finished here -->
<div2 id=AREAISEMAIL> <div2 id=AREAISEMAIL>
<head> <head>
AREAISEMAIL &lt;echoid&gt; AREAISEMAIL &lt;echoid&gt;
@ -5736,7 +6026,7 @@ AREASEP &excl;C "Group C" C Local]]></eg>
Feed (12d) character after each message. Feed (12d) character after each message.
</p> </p>
</div2> </div2>
<div2> <div2 id=FRQEXT>
<head> <head>
FRQEXT &lt;.ext&gt; FRQEXT &lt;.ext&gt;
</head> </head>
@ -5757,7 +6047,7 @@ AREASEP &excl;C "Group C" C Local]]></eg>
Example: FRQEXT .XYZ Example: FRQEXT .XYZ
</p> </p>
</div2> </div2>
<div2> <div2 id=FRQNODEMAP>
<head> <head>
FRQNODEMAP &lt;to-node&gt; &lt;from-node&gt; FRQNODEMAP &lt;to-node&gt; &lt;from-node&gt;
</head> </head>
@ -5781,7 +6071,7 @@ AREASEP &excl;C "Group C" C Local]]></eg>
2:236/99. 2:236/99.
</p> </p>
</div2> </div2>
<div2> <div2 id=FRQOPTIONS>
<head> <head>
FRQOPTIONS &lt;options&gt; FRQOPTIONS &lt;options&gt;
</head> </head>
@ -5827,7 +6117,7 @@ AREASEP &excl;C "Group C" C Local]]></eg>
the .REQ file and NOT also touch/create a .?LO flowfile. the .REQ file and NOT also touch/create a .?LO flowfile.
</p> </p>
</div2> </div2>
<div2> <div2 id=FRQWAZOO>
<head> <head>
FRQWAZOO &lt;yes/no&gt; FRQWAZOO &lt;yes/no&gt;
</head> </head>
@ -7222,7 +7512,7 @@ AREASEP &excl;C "Group C" C Local]]></eg>
selected from the EDITSAVEMENU. selected from the EDITSAVEMENU.
</p> </p>
</div2> </div2>
<div2> <div2 id=OUTBOUNDPATH>
<head> <head>
OUTBOUNDPATH &lt;path&gt; OUTBOUNDPATH &lt;path&gt;
</head> </head>
@ -9446,16 +9736,6 @@ keyword is:
Available options: Available options:
</p> </p>
<p> <p>
-NoChk
</p>
<p>
Normally <name>GoldED+</name> will check the areafile timestamps when starting
up, and recompile the configuration if a file was changed. If this
option is given for any AREAFILE, those areafiles will not be
checked. This can be useful in cases like TosScan, GEcho, IMail
and several others which "touch" their files every time they run.
</p>
<p>
-S&lt;sortspec&gt; -S&lt;sortspec&gt;
</p> </p>
<p> <p>