home bbs files messages ]

Forums before death by AOL, social media and spammers... "We can't have nice things"

   comp.lang.c      Meh, in C you gotta define EVERYTHING      243,242 messages   

[   << oldest   |   < older   |   list   |   newer >   |   newest >>   ]

   Message 241,821 of 243,242   
   Michael Sanders to Janis Papanagnou   
   Re: Usage/Help Screen Conventions   
   07 Nov 25 10:43:33   
   
   From: porkchop@invalid.foo   
      
   On Thu, 6 Nov 2025 06:40:43 +0100, Janis Papanagnou wrote:   
      
   > While file arguments are part of the interface syntax   
   > redirections (like < building blocks; I wouldn't include them in the usage   
   > description.   
      
   Noted.   
      
   > Examples are fine (but '-' is syntactically unnecessary).   
   > A description is completely missing. (And a manual page   
   > should also have information about exit status codes.)   
      
   Yes.   
      
   > My preference for usage information goes in the direction   
   > (despite being also - like your "Syntax" line - formally   
   > not perfectly accurate)...   
   >   
   >   
   > Synopsis:   
   >     tinybase [ -q queries... | -t | -m ] files...   
   >   
   > Options:   
   >     -q queries...     comma separated list of queries   
   >     -t                   
   >     -m                show manual   
   >   
   > Description:   
   >     ...   
   >   
   > Examples:   
   >     tinybase -q 'query1, query2, query3' - *.txt   
   >     tinybase -t - *.txt   
   >     tinybase -m > manual.txt   
      
   That's closer to what I what in fact.   
      
   As always, thanks Janis, lots of good info.   
   Slowly but surely I move forward.   
      
   --   
   :wq   
   Mike Sanders   
      
   --- SoupGate-Win32 v1.05   
    * Origin: you cannot sedate... all the things you hate (1:229/2)   

[   << oldest   |   < older   |   list   |   newer >   |   newest >>   ]


(c) 1994,  bbs@darkrealms.ca