Documentation HELP issues

May 20, 2008
3,515
4
Elkridge, MD, USA
In a prior thread you explained the current version of the help build system under certain conditions reassigns hypertext links from their true destination to their own location. Apparently this happened to every single command option link I trued to use in the recent versions.

TPIPE command

/input=filename

Filename to read. This can be either a disk file, include file (@filename), or CLIP:. If it is not specified, TPIPE will read from standard input.

Shoudn't the emphasized phrase be include list?
 
May 20, 2008
11,432
99
Syracuse, NY, USA
Include files don't work.
Code:
v:\> type filelist.txt
avtemp.btm
factor.btm
 
v:\> tpipe /input=@filelist.txt /simple=6
TPIPE: The system cannot find the file specified.
"@filelist.txt"
But include lists, in general, don't work either. For example, a simple wildcard spec doesn't work.
Code:
v:\> tpipe /input=*.btm /simple=6
TPIPE: The filename, directory name, or volume label syntax is incorrect.
"*.btm"
In a brief test, a semicolon-separated list of actual filenames did work.
 

rconn

Administrator
Staff member
May 14, 2008
12,367
150
But include lists, in general, don't work either. For example, a simple wildcard spec doesn't work.

A wildcard isn't an include list. And TPIPE doesn't support wildcards (see the help). (The result of feeding wildcards to TPIPE would range from a moderately bad idea to catastrophic, depending on the operation requested.)

In a brief test, a semicolon-separated list of actual filenames did work.

No, it definitely won't.
 
May 20, 2008
3,515
4
Elkridge, MD, USA
What's an include file?

Many programming languages have an "include" statement, in the body of a file, which causes the language processor to include the contents of the included file as if it were included in the file instead of the include statement. The processing of TCMD's .INI file follows this concept.

Indirect file is a very different concept, implemented in many TCC commands under the title "@FILE lists" (no explanation needed...). The only term used anywhere in HELP is @FILE list. If that's what is meant by include file, I suggest rewording HELP. If not, what is the explanation?

Great product, but HELP sometimes needs improvement...
 

rconn

Administrator
Staff member
May 14, 2008
12,367
150
The only term used anywhere in HELP is @FILE list. If that's what is meant by include file, I suggest rewording HELP. If not, what is the explanation?

I don't know what your point is here -- the help never mentions the words "include file" (certainly not in this context); it says "@File lists".

You want me to reword something in the help that isn't in the help??
 
May 20, 2008
11,432
99
Syracuse, NY, USA
I don't know what your point is here -- the help never mentions the words "include file" (certainly not in this context); it says "@File lists".

You want me to reword something in the help that isn't in the help??
To be fair to Steve, he did accurately quote the help.
Code:
/input=filename
Filename to read. This can be either a disk file, include file (@filename), or ...
 
Similar threads
Thread starter Title Forum Replies Date
Dan Glynhampton Documentation Minor issues with HELP Support 0
S HELP issues Support 9
S Minor HELP issues Support 1
C Add link to ewriter help to program group... Support 3
samintz How to? Search for %(command) in Help? Support 1
Joe Caverly Favorites in eWriter Help Support 6
Joe Caverly Quick Search in eWriter Help Support 1
vefatica Online help? Support 2
fishman@panix.com HELP!! I just updated to Version 28 and as usual I cannot make extended directory search work. Support 2
JohnQSmith New online help file wrong logo Support 7
Jay Sage Documentation Function @DRIVE Missing in Help Lists Support 0
Charles Dye More help nits Support 0
D Documentation Typo in COPY help Support 0
FreezerBurnt Help making a CMD and TCC compatible batch file Support 7
Joe Caverly Documentation COMMANDS in Version 27 help Support 8
K_Meinhard How to? Help window position Support 7
U Command help on file names Support 5
D Documentation Help "Startup" page does not describe global lists Support 0
vefatica Help disappears? Support 6
rchapmanitt Help Purchasing Support 2
Charles Dye Documentation Help nits: @ZIPFILECRC Support 0
C version help Support 3
C Documentation Help Nit. REN / RENAME Support 0
Dmitry L. Kobyakov Documentation Error in the Help: the WINDOW command Support 0
vefatica Help for @PID Support 2
vefatica Need help with XML Support 3
Alpengreis Documentation Minor issue in help file for view /E Support 1
R Documentation Advanced Directives Help Support 0
R Documentation Help Nit with SETP Support 0
R wmic command help Support 9
R Documentation Help Nit > bdebugger View Menu Support 0
R Documentation A couple of Help nits Support 0
R Documentation Help typo Support 1
MikeBaas How to? I need help with RD Support 5
R Documentation v25 Help Comments Support 1
Joe Caverly DIRectory Colorization in v25 Help File Support 0
vefatica Help nit Support 0
D error in help documentation? Support 0
Joe Caverly _EXPANSION in help file Support 0
K_Meinhard Help file error Support 1
Joe Caverly JOBMONITOR in Help File Support 1
A Documentation [Help file] OPTION "//" synopsis formatting issue Support 0
D The local HELP viewer... Support 0
Chen Touboul Overtyping issue - i press the Insert key, help till press enter for new line in TCC Support 2
C Documentation Help nix ZIP /M Support 0
Joe Caverly v24 Help File - DATEMONITOR Support 1
Joe Caverly 7zip command links to zip help Support 0
K_Meinhard Help problems Support 3
Charles Dye Documentation Help Nits Forever: Checksum functions Support 0
Joe Caverly SAVECONSOLE in Help File Support 0

Similar threads