[FFmpeg-devel] [PATCH] conversion of FFV1 specification from lyx to markdown

[Dave Rice]

> On Jul 10, 2015, at 2:06 PM, Michael Niedermayer <michael at niedermayer.cc> wrote:
> 
> On Fri, Jul 10, 2015 at 07:51:20PM +0200, Michael Niedermayer wrote:
>> On Fri, Jul 10, 2015 at 07:47:46PM +0200, Michael Niedermayer wrote:
>>> On Fri, Jul 10, 2015 at 11:52:24AM +0200, Michael Niedermayer wrote:
>>>> On Thu, Jul 09, 2015 at 02:14:36PM -0400, Dave Rice wrote:
>>>>> 
>>>>>> On Jul 9, 2015, at 1:53 PM, Michael Niedermayer <michaelni at gmx.at> wrote:
>>>>>> 
>>>>>> On Tue, Jul 07, 2015 at 11:03:39AM -0400, Dave Rice wrote:
>>>>>>> Hi,
>>>>>>> 
>>>>>>>> On Jul 7, 2015, at 10:35 AM, Michael Niedermayer <michaelni at gmx.at> wrote:
>>>>>>>> 
>>>>>>>> On Thu, Jul 02, 2015 at 09:50:21AM -0400, Dave Rice wrote:
>>>>>>>>> Hi all,
>>>>>>>>> Last month I posted a draft of the FFV1 specification formatted in Markdown [1], whereas it currently lives in lyx. From that post there were responses in favor of the use of Markdown formatting and suggestions to not use mathml within a draft targeting an RFC specification and suggestions to update a few urls. I propose to proceed with a format conversion of the FFV1 specification from lyx to Markdown and then I'll file tickets or patches to explore simplifying the mathml expressions and updating the urls. Attached is a patch to convert the formatting (but not meaning) of the FFV1 specification from lyx to markdown.
>>>>>>>>> 
>>>>>>>>> Best Regards,
>>>>>>>>> Dave Rice
>>>>>>>>> 
>>>>>>>>> [1] http://comments.gmane.org/gmane.comp.video.ffmpeg.devel/193851
>>>>>>>>> 
>>>>>>>> 
>>>>>>>> how can this be edited and converted ?
>>>>>>> 
>>>>>>> Via pandoc you can get outputs that are close to the current ffv1.html and ffv1.pdf outputs of ffv1.lyx.
>>>>>>> 
>>>>>>> pandoc --mathml -s --number-sections ../ffv1.md -c lyx.css -o ffv1.html
>>>>>>> pandoc -s --number-sections ../ffv1.md --latex-engine=xelatex -V geometry:margin=1in -o ffv1.pdf
>>>>>>> 
>>>>>>> I can move this info to a readme.
>>>>>> 
>>>>>> please do
>>>>> 
>>>>> Sure. Would you prefer a patch on ffmpeg-devel or a PR in github?
>>>> 
>>>> whatever you prefer
>>> 
>>> generated files like pdf should not be checked into git.
>>> instead add a Makefile to generate them, so a simple
>>> make
>>> or
>>> make ffv1.pdf
>>> generates the file
>> 
>> also the readme should document which version of markdown/pandoc
>> this needs
>> and something should check for that version ideally so the user
>> is nt left wondering why "make" produces broken tables
> 
> reviewing the pull req
> 
> The conventions section 3.
> lacks vertical alignment

Fixed in https://github.com/MediaArea/FFV1/commit/d25fb39f7514547f72cbc13ef3851f3c9d9c0c5f

> theres an empty line after
>    for(i=0;i<e;i++) 4.6.1.2

Fixed in https://github.com/MediaArea/FFV1/commit/1291e6c3e90ea6816b543a9e12c08d1cbbc1f31c

> 4.6.2.5:
>    log2_run[41]={JPEGLS.
>    0,0,0,0,1,1,1,1,
> 
> that JPEGLS is supposed to be a link/reference/whatever but its a
> litteral word

I'm having trouble getting a footnote to work within a codeblock. It is feasible to use this footnote in a reference to JPEGLS in a sentence above the codeblock?

[...]

Dave Rice