References: <3b7b7cf9-4bc9-5932-eb51-ca75f973ef95@latex-project.org>
User-Agent: Mozilla/5.0 (X11; Linux i686; rv:45.0) Gecko/20100101
            Thunderbird/45.8.0
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8; format=flowed
Content-Transfer-Encoding: 7bit
Message-ID:  <0d7d8c7f-efa1-3b16-fc43-6244460340e2@earthlink.net>
Date:         Tue, 17 Apr 2018 19:42:30 +0100
Reply-To:     Mailing list for the LaTeX3 project
              <LATEX-L@LISTSERV.UNI-HEIDELBERG.DE>
Sender:       Mailing list for the LaTeX3 project <LATEX-L@LISTSERV.UNI-HEIDELBERG.DE>
From:         Peter Wilson <herries.press@EARTHLINK.NET>
Subject: Re: doc package version 3
To:           LATEX-L@LISTSERV.UNI-HEIDELBERG.DE
In-Reply-To:  <3b7b7cf9-4bc9-5932-eb51-ca75f973ef95@latex-project.org>
Precedence: list
Envelope-To: <rainer.schoepf@GMX.NET>
Status: R

Hello Frank,

Have you looked at the docmfp package?

Peter W.


On 16/04/18 19:22, Frank Mittelbach wrote:
> Hi folks,
>
> after about 20+ years I finally got around taking a closer look at doc 
> package and one ore the other extension that has been written based on 
> it.
>
> Given that on one hand doc is missing a lot of useful functionality 
> but on the other hand 2/3 of the LaTeX packages use .dtx based code I 
> thought it isn't advisable to change anything that exists but only 
> provide a modest update that offers some in my opinion useful features 
> without rendering existing documentation obsolete.
>
> Speaking of not changing anything: of course any addition is a change 
> and while \NewDocElement is probably safe other bits may not be and 
> that might call for some adjustments.
>
> So basically I added
>
> hyperref support out of the box
> and integrated some of the ideas from the dox package by Didier Verna 
> (though I didn't keep his interfaces). The latter allows addition 
> doc-elements so that you can structure the documentation properly and 
> obtain a more useful index according to your needs, eg document 
> options, counters lengths etc and have them indexed in various ways.
>
> Out of the box, doc will still only offer Macro and Env but this way 
> it is now trivial to customize this on a per package basis. I have 
> tested this on various documentation already, but of course some wider 
> tests are advisable before I will move that (or rather a later version 
> as I'm still working on code and documentation) into the main LaTeX 
> distribution.
>
> So I'm looking for people trying this out on their own packages and 
> report any problems or suggestions back to me, preferably via the 
> github issue tracker.
>
> The code is located at
>
> https://github.com/FrankMittelbach/fmitex/tree/master/doc-v3
>
> for those who want to give it a try
>
> thanks
> frank
>
> ps the new code uses the new rollback functionality of the 2018-04 
> release of LaTeX, even though you can use the package with an older 
> LaTeX release. But if you have a current one then
>
> \usepackage{doc}[v2]
>
> should always get you back the older version and thus should run any 
> old package code. (Of course that only works if you use the 2018 
> version of the LaTeX kernel)