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: Eli Zaretskii
Subject: Re: Standard directory for documentation in EPUB format
Date: Wed, 09 Nov 2022 21:36:44 +0200

> From: Gavin Smith <gavinsmith0123@gmail.com>
> Date: Wed, 9 Nov 2022 19:20:53 +0000
> Cc: bug-texinfo@gnu.org
> 
> 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.

I thought you were saying that EPUB should be treated the same as
HTML, PDF, DVI, etc., in which case the EPUB directory should default
to docdir, but, like htmldir and dvidir, allow installing EPUB in
another place.  That made sense to me, but then came your last
sentence and confused me, because it actually says EPUB will NOT have
its variable, unlike those other formats.  Such a difference should be
due to some valid reason, IMO, but you don't say what would such a
reason be.



reply via email to

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