<div dir="ltr">On 11 May 2013 13:58, Daniel Hartwig <span dir="ltr"><<a href="mailto:mandyke@gmail.com" target="_blank">mandyke@gmail.com</a>></span> wrote:<br><div class="gmail_extra"><div class="gmail_quote"><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">

<br>
Hello<br>
<br>
Attached is a first pass at improving the source of distcc(1).  At this<br>
point I am only addressing typographical and syntax issues, such as "-"<br>
vs. "\-" [1], preventing inappropriate hyphenation, consistent<br>
formatting and use of man page conventions, and general readability of<br>
the source.<br></blockquote><div><br></div><div style>Hello Daniel, thank you for improving this.</div><div style><br></div><div style>That looks fine when I skim through the output and diff.</div><div style><br></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">


There are a couple of TODO markers still, and I will make a final pass<br>
to fully apply conventions such as command names in bold and program<br>
suites in italics (underline).<br></blockquote><div><br></div><div style>Let me know when it's ready to merge.</div><div style> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">


<br>
After that I will perform similar work on the other man pages.<br>
<br>
I have only tested the result on Debian Sid which is GNU troff 1.22.2.<br>
Feedback as to whether it renders correctly on other systems is<br>
appreciated.<br>
<br>
<br>
Also, these files do not contain any Copyright notice or license notice.<br>
It is practical to include a source comment at the top like this:<br>
<br>
  .ig<br>
  Copyright (C) AUTHOR<br>
<br>
  LICENCE BOILERPLATE<br>
  ..<br>
<br>
which I will do, but am not sure about the intended license.  It seems<br>
that these files _may_ have been produced from an earlier SGML version<br>
which was GNU Free Documentation License.  Is that the preferred license<br>
for the man pages?<br></blockquote><div><br></div><div style>I vaguely recall trying to generate this from SGML many years ago and then deciding it would be easier just to maintain troff.  troff is the canonical source now, though.  There is a LICENCE section in the document that says it's GPL2+, which has the advantage of keeping the whole package consistent, so please use that.  I wrote most of the manpage.</div>

<div style><br></div></div>-- <br>Martin<br>
</div></div>