Skip to content

Conversation

ppentchev
Copy link

First of all, thanks a lot for writing and maintaining microsocks!

What do you think about these three commits? Two of them are trivial fixes, the third one - start sentences on a new line - is something I personally learned from my time as a FreeBSD doc committer; the FreeBSD project has a policy that mdoc manual pages should be written like that, both as a hint to the formatting software and also as a convenience when rewriting sentences: there is no need to reflow a whole paragraph that contains five or six sentences if you want to add four words to one of them.

Of course, it is your decision whether to accept these changes; let me know if you think that some of them are not needed, I can drop them from the branch.

BTW, it is great to see people writing mdoc manual pages! Over the years I have wondered why this is not more widespread; it is so much easier than using the "traditional" man macro set...

Thanks again, and keep up the great work!

It is very lightweight, and very light on resources too: for every client, a
thread with a low stack size is spawned. the main process basically doesn't
consume any resources at all. It is also designed to be robust: it handles
thread with a low stack size is spawned.
Copy link
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

what's the point of selectively making some lines short ?

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I went for a minimal-change approach: I only inserted a line break at the beginning of every sentence, I didn't change the already-existing line breaks in the middle of sentences. Let me know if you want me to also reflow the sentences so that short ones are now on a single line.

Copy link
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

i really don't even want to be reminded this manpage exists, even less spend any time on maintaining it. i'm already feeling that it was a bad idea to add it.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants