-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 On 07/12/14 19:47, Michael Niedermayer wrote: > On Fri, Dec 05, 2014 at 01:43:09PM +0100, Michael Niedermayer wrote: >> On Thu, Dec 04, 2014 at 04:57:09PM +0000, tim nicholson wrote: >>> -----BEGIN PGP SIGNED MESSAGE----- >>> Hash: SHA1 >>> >>> On 04/12/14 16:09, Clément Bœsch wrote: >>>> [..] >>>> >>>> This representation requires way more efforts to me to understand than the >>>> one from Michael... >>>> >>> >>> Just shows how different minds think/work ;) >>> >>> As the saying goes, one man's meat is another man's poison. >>> >>> I was going for consistency with current work (which I happened to find >>> clear) and I liked having the extra detail of line numbers. >> >> iam fine with either but id like to see one of them or a combination >> pushed. pushing neither would be worst ... >> >> so which solution do people prefer? > > seems people dont care > > so applied mine, feel free to replace by something else, iam fine with > any way of documenting it as long as it is documented >
People don't want choice, they just want what they want. I suspect those with the most pertinent view on the docs style generally are users new(ish) to ffmpeg who don't subscribe to this list. My experience generally is that end user documentation is best not written by developers as they cannot approach the subject from the view point of an outsider coming new to a feature. This is a luxury ffmpeg is not in a position to be able to afford so we do what we can, and respond as best we can if users squawk. Lets see if there is any further noise on the subject and if so we can look to tweaking things. In the meantime as you say "pushing neither would be worst", and you got 100% of the votes cast so progress has been made. > > [...] - -- Tim. Key Fingerprint 38CF DB09 3ED0 F607 8B67 6CED 0C0B FC44 8B0B FC83 -----BEGIN PGP SIGNATURE----- Version: GnuPG v2 iQEcBAEBAgAGBQJUhVv7AAoJEAwL/ESLC/yDVlgH/0aTM27YoG8dwZ128z+rLzVQ 1+vJq8X9xjVR0yXemMG5QRkWagj7z1hhRuZMtVVkMEKIRkvxxlENwlgNrDryjRVm GPgorWq0jkTiX0DRsF40hxqFwIavJBujZoXAmi/8B2ouJcGaVCjsKBOkDsN3RfEM 1/pbUKKLCMnU3dl49DtIFOThfztuFmDzscbwnqQf05/+rMHpYeHONwir1gsTnrOU nEFkm8Nc84ROCcD4j5hV+GiIumThrDzYS85C9aIu9xodgrsRk13o1KWqvLvFSsrk i69wa9C2T4GpfD6I3DWTs54oGONH2X3yZeKmvFPzK0pBoehm7deKKlO1DJxvahQ= =mtPR -----END PGP SIGNATURE----- _______________________________________________ ffmpeg-devel mailing list ffmpeg-devel@ffmpeg.org http://ffmpeg.org/mailman/listinfo/ffmpeg-devel