On Wed, Sep 26 2018, Stefan Beller wrote: > On Wed, Sep 26, 2018 at 1:44 PM Ævar Arnfjörð Bjarmason > <avarab@xxxxxxxxx> wrote: > >> > And if we were going to generate something external, would it make more >> > sense to write in a structured format like doxygen? I am not a big fan >> > of it myself, but at least from there you can generate a more richly >> > interconnected set of documentation. >> >> It's useful to have a single authoritative source for all documentation >> that's easy to search through. > > If that is the case I would propose to keep it all in header files and > organize the headers. > >> That includes stuff like perl585delta(1) which we'd stick in >> Documentation/RelNotes, and "Internals and C Language Interface". Most >> of what we'd put in Documentation/technical/api-* & headers is in >> perlapi(1). > > This seems cool, but was also a recent introduction? > perl400delta seems to yield nothing for me (which may be because > I do not have an old version of perl installed?) Depends on what you think is "recent" I suppose. Perl 5.4 is the first version where deltas in POD format started being maintained consistently, that version was released in mid-1997. Perl 4 was released in 1991, see "perldoc perlhist". So ~everything consistently in POD has been the case for ~20 years.
