Fixed Help nits

May 20, 2008
3,515
4
Elkridge, MD, USA
Topic Date Ranges paragraph 3 has incorrect example (V12 example incorrectly "updated"):

For example, /[d2010-12-31,2010-1-1] selects files modified between December 31, 2010 and January 1, 2011.

The 3rd paragraph below the table of examples (none of which show a "date exclusion range"!) refers to the date 1980-01-01 as the oldest PC file date - only true for FAT file systems. The actual example is correct, but the reference to the "zero point" etc. is not. With NTFS if I copy a document from the Civil War I can set its modification date to the document's actual date. Useful for a document archivist!

Note: There ought to be a prefix for HELP nits!
 

rconn

Administrator
Staff member
May 14, 2008
12,344
149
The 3rd paragraph below the table of examples (none of which show a "date exclusion range"!) refers to the date 1980-01-01 as the oldest PC file date - only true for FAT file systems. The actual example is correct, but the reference to the "zero point" etc. is not. With NTFS if I copy a document from the Civil War I can set its modification date to the document's actual date. Useful for a document archivist!

You could, but you wouldn't. In the real world, nobody is going to have file dates prior to the existence of the PC.
 
Nov 13, 2008
255
3
www.thedave.me
You could, but you wouldn't. In the real world, nobody is going to have file dates prior to the existence of the PC.
I checked my system and I found a few hundred files that predate 1980 (and not dates I intentionally set myself, all came this way in some fashion, likely from archives)

I was a bit surprised, I expected 2-3 (because I already knew about them)
 
May 20, 2008
3,515
4
Elkridge, MD, USA
The incorrect statements in HELP, reported in the OP, are still present in the webhelp as well as the one distributed with build 56. IMHO the issue is NOT FIXED. As specified in the 4th paragraph of the topic, the date range /[d2010-12-31,2010-1-1] is the same as /[d2010-1-1,2010-12-31], i.e., files dated at any time in the 2010th year, NOT those dated the last day of 2010 or the day after that, the first day of 2011. BTW, is there any reason to change the dates used in the date range EXAMPLES just because they are not "current"? The examples would be valid if they referred to the year 1910 - why else use a time stamp system going back several centuries! Of course, examples using 2-digit year always refer to the closed interval [1980,2079].
 
May 20, 2008
3,515
4
Elkridge, MD, USA
Sorry, b56 was distributed later than the "fixed" prefix. Perhaps you could add in future a note in which version it is fixed. It certainly was not a show stopper that would require "instant" response.
 

rconn

Administrator
Staff member
May 14, 2008
12,344
149
Build 56 was built hours before you posted. Your nit was not deemed sufficiently earthshaking to warrant spending 4 hours rebuilding everything.

(The web help *was* updated with the change, but the tcmd.chm help update won't appear until 13.04.57.)
 
Nov 2, 2009
294
6
Chile
www.farah.cl
You could, but you wouldn't. In the real world, nobody is going to have file dates prior to the existence of the PC.

Years ago, I had to help a professor migrate his personal files (mostly plaintext files) written in a VMS machine that was (even then) old as sin. Some of his files were, indeed, older than 1980.

Sure, 1980 might be enough for all practical purposes, but a small note might be helpful. You could add an asterisk after the '1980', and later on add something like this:

In the FAT filesystem, originally used on the IBM PC and still extant, 01-01-1980 is the oldest date that can be handled; this is why, for most practical purposes, this is considered the oldest PC file date. Other, newer, filesystems can handle dates farther into the past.
 
Similar threads
Thread starter Title Forum Replies Date
Charles Dye More help nits Support 0
Charles Dye Documentation Help nits: @ZIPFILECRC Support 0
R Documentation A couple of Help nits Support 0
Charles Dye Documentation Help Nits Forever: Checksum functions Support 0
samintz Documentation Help nits Support 5
Charles Dye Revenge of the Help Nits Support 0
samintz Documentation Help Nits Support 3
JohnQSmith Ye olde Help Nits Support 4
Charles Dye Doc nits: HELP BATCHDETECT Support 2
Charles Dye The eternal Help Nits thread Support 0
C web help nits Support 1
S More HELP nits Support 5
S HELP nits Support 9
S SET /A question; HELP nits Support 8
S HELP nits Support 1
S HELP nits Support 0
dcantor 12.1 help nits Support 0
S HELP nits Support 3
samintz V12 Help Nits Support 5
S HELP nits Support 3
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
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
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 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

Similar threads