[FFmpeg-devel] [PATCH 2/3] doc/faq: add section on freezing terminal state

[Ganesh Ajjanagadde]

On Tue, Aug 11, 2015 at 1:08 PM, Ganesh Ajjanagadde <gajjanag at mit.edu> wrote:
> On Tue, Aug 11, 2015 at 12:59 PM, Michael Niedermayer
> <michael at niedermayer.cc> wrote:
>> On Tue, Aug 11, 2015 at 12:06:03PM -0400, Ganesh Ajjanagadde wrote:
>> [...]
>>> As for whether this is a faq or not is a matter of debate.
>>> I am perfectly fine placing it elsewhere if that is what people want.
>>
>> please do, FFmpeg should not trash the terminal so this shuld not
>> be a frequently asked question
>
> Well, in an ideal world FFmpeg should not,
> but as examples indicate, it can indeed trash the terminal
> (with or without the patchset).
>
> Nevertheless, I will move this to the wiki,
> unless someone has a better idea for where it should go.

Now that I think of it, there is yet another alternative:
note that terminal recovery is really the shell's responsibility
in some cases.
As such, if anything, this should belong in the shell's documentation
and/or distribution documentation.
We do not need to document this.
If someone files a bogus bug report on this,
or some user asks this question on IRC, forums, mailing list, etc
we could take that as a signal for us to document this.

My own rationale for using the faq is that it is more widely read
as compared to the wiki, thus potentially benefiting more users/devs.
Michael's concerns seem to essentially boil down to the
negative PR effect of keeping this on the faq.
I could add a sentence clarifying that this is not a bug in ffmpeg,
mitigating some of those negative effects.

>
>>
>> [...]
>> --
>> Michael     GnuPG fingerprint: 9FF2128B147EF6730BADF133611EC787040B0FAB
>>
>> I am the wisest man alive, for I know one thing, and that is that I know
>> nothing. -- Socrates
>>
>> _______________________________________________
>> ffmpeg-devel mailing list
>> ffmpeg-devel at ffmpeg.org
>> http://ffmpeg.org/mailman/listinfo/ffmpeg-devel
>>