[FFmpeg-devel] [PATCH 4/5] Revert "doc: fate: Support building a plain text version"

[Stefano Sabatini]

On date Saturday 2013-11-30 01:02:52 +0100, Alexander Strasser encoded:
> On 2013-11-29 14:49 -0800, Timothy Gu wrote:
[...]
> > * If a person likes HTML, there you go.
> > * If a person doesn't like HTML, (s)he can read .texi
> > 
> > (I said this in my last mail)
> 
>   I got that. But why not just have a generated text version from the
> same source. The texi format is there to generate lots of representations
> from one source.
> 
> > >   Then and now I do not think it makes sense to install the fate.txt
> > > file. You do not actually install FFmpeg to make a fate client. It
> > > is meant to be read out of the source directory.
> > 
> > I used the argument that it is not installed to say that there is no
> > reason to generate it. I didn't mean that it should be installed.
> 
>   And my argument is that if it isn't installed, that is no reason to
> not generate it.
> 
>   So what's up with insisting on reverting stuff that does not do any
> harm at all but can be useful. Having the file there also helps when
> people search for it in the same location it used to be. The only
> drawback from before is that they can only find it there after having
> built it or FFmpeg before.
> 
>   If there were any specific problems I would consider reverting and
> sacrificing the text version. If there are no issues, I cannot but
> continue to find this arbitrary.

Facts: the user may not have an HTML reader, nor want to read the file
in texinfo format (which is not supposed to be read as is).

For manual pages, this is not an issue, since we generate the POD and
MAN versions which can be read from a terminal. For FATE the only
alternative to HTML and TEXI is to read in TXT format.

So for the FATE docs we have at least an use case to generate the .txt
file, thus I think it makes sense to keep the current logic. I won't
object if you find/agree on a different solution.
-- 
FFmpeg = Faithless & Fast MultiPurpose Enchanting Geek