From: ldo@nz.invalid   
      
   On Tue, 11 Nov 2025 23:29:36 -0000 (UTC), Michael Sanders wrote:   
      
   > On Sat, 8 Nov 2025 07:58:31 -0000 (UTC), Lawrence D’Oliveiro wrote:   
   >   
   >> These days, I don’t bother. For more complex projects, I write up a   
   >> detailed man page and include it with the program.   
   >   
   > I'm just going to embed mine right in the app, no fuss.   
      
   Why is it a better idea to write up proper documentation separately?   
      
   Because a common format like a man page can be easily repurposed, e.g. to   
   generate a nicely-typeset PDF file. Bit tricky to do that with comments or   
   messages embedded in your code.   
      
   --- SoupGate-Win32 v1.05   
    * Origin: you cannot sedate... all the things you hate (1:229/2)