Re: nsh manual rewrite in mandoc draft feedback requested style ideas etc

2022-05-04 Thread Tom Smyth
Hello folks, Attached is the latest iteration of the proposed manual for nsh it is not complete yet, but I have tried to take on board Ingo@ very helpful feedback, it has been run through mandoc -Tlint It needs a number of more passes im sure, some additional changes made since last time, rem

Re: nsh manual rewrite in mandoc draft feedback requested style ideas etc

2022-04-26 Thread Tom Smyth
Hello Ingo, Thanks for all your feedback, It s very much appreciated. Re mandoc(1) vs mdoc(7) thanks for the clarification for me, I will try to use mdoc(7) when referring to the manpage language Your formatting advice was very helpful I have tried to fully implement your feedback as best I can

Re: nsh manual rewrite in mandoc draft feedback requested style ideas etc

2022-04-25 Thread Ingo Schwarze
Hi Tom, Tom Smyth wrote on Mon, Apr 25, 2022 at 11:08:26AM +0100: > I have been translating the txt of MANUAL of nsh port to mandoc In fact, you have started translating it to mdoc(7) - which is a markup language - rather than to mandoc(1) - which is a parsing and formatting program for multiple

nsh manual rewrite in mandoc draft feedback requested style ideas etc

2022-04-25 Thread Tom Smyth
Hello folks, I have been translating the txt of MANUAL of nsh port to mandoc there is quite alot of features and syntax to document so I figured that before I complete the first redraft(that is fit for human consumption) I would get feedback on what I have done so far. do you like the bullets a