<div dir="ltr">Hi Karl.  <div>I realize that complete reference <span style="line-height:1.5">documentation for tlmgr will be massive, but massive *and* unstructured is not good. By "structure" I mean sections and sub-sections </span><span style="line-height:1.5">with </span><span style="line-height:1.5">headings, table of contents, index, separation of basic</span><span style="line-height:1.5"> and essential material fr</span><span style="line-height:1.5">om advanced or rarely-used actions/options, etc. </span></div><div><span style="line-height:1.5">Okay,</span><span style="line-height:1.5"> I can see that it wouldn't be feasible to replace the current documentation format and I'm certainly not the person who is</span></div><div><span style="line-height:1.5">going to try and make it better. </span><span style="line-height:1.5"> But does a "preamble" that summarizes the most useful </span><span style="line-height:1.5"> actions and options have to be in pod format?  </span></div><div><br></div><div>Bob</div></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Sat, Jul 18, 2020 at 5:53 PM Karl Berry <<a href="mailto:karl@freefriends.org">karl@freefriends.org</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">Hi Bob,<br>
<br>
   massive,<br>
<br>
There's a lot of functionality.<br>
<br>
    unstructured <br>
<br>
Well, there are many sections and lists, so it's not exactly completely<br>
unstructured.<br>
<br>
    and, frankly, unusable <br>
<br>
I know what you mean, but, there's the information.<br>
<br>
    man page which typesets to no less than 26 pages.<br>
<br>
There's a lot of functionality. It's not going to get shorter.<br>
<br>
    I propose to LaTeX-ify tlmgr.1.  Would that be acceptable?<br>
<br>
No. It would be unmaintainable. Sorry.<br>
<br>
Right now, tlmgr.1 and tlmgr.html are generated from the pod<br>
documentation that is at the end of <a href="http://tlmgr.pl" rel="noreferrer" target="_blank">tlmgr.pl</a>.<br>
<br>
There is also a program pod2latex (standard with Perl) which generates<br>
LaTeX source meant to be included in a document.  If you can devise a<br>
preamble for it (there is that makes you happier than the current man<br>
page pdf, we can distribute that. If there are changes to the pod that<br>
would make it better, that's fine too. (Doc for pod itself is at, e.g.,<br>
<a href="https://perldoc.perl.org/perlpod.html" rel="noreferrer" target="_blank">https://perldoc.perl.org/perlpod.html</a>. It is not complicated.)<br>
<br>
But the pod has to remain the ultimate source. --thanks, karl.<br>
</blockquote></div>