bug-texinfo
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Standard directory for documentation in EPUB format


From: Gavin Smith
Subject: Re: Standard directory for documentation in EPUB format
Date: Wed, 9 Nov 2022 19:20:53 +0000

On Wed, Nov 09, 2022 at 07:08:26PM +0200, Eli Zaretskii wrote:
> Hi,
> 
> Texinfo 7.0 added support for producing the manual in the EPUB format,
> but there's no standard directory to install that in GNU Coding
> Standards.  Would you please recommend where to install that, and
> suggest a patch for the GCS document to reflect that?  The first
> question about that "from the trenches" is already here:
> 
>   https://sourceware.org/pipermail/gdb-patches/2022-November/193622.html
> 
> TIA
> 

It's not clear that there should be a dedicated directory for installed
EPUB files, or that people would install lots of these.  I'm not too
clear on how people would use the EPUB output.

The 'docdir' in "(standards)Directory Variables" appears sufficient:

'docdir'
     The directory for installing documentation files (other than Info)
     for this package.  By default, it should be
     '/usr/local/share/doc/YOURPKG', but it should be written as
     '$(datarootdir)/doc/YOURPKG'.  (If you are using Autoconf, write it
     as '@docdir@'.)  The YOURPKG subdirectory, which may include a
     version number, prevents collisions among files with common names,
     such as 'README'.

htmldir, dvidir etc. all default to ${docdir} by default (with
autoconf/automake).  There would seem to be no benefit to
creating an epubdir along the same lines, in my opinion.




reply via email to

[Prev in Thread] Current Thread [Next in Thread]