[Bug 14552] <track> support // and /* */ comments everywhere except in the signature line

http://www.w3.org/Bugs/Public/show_bug.cgi?id=14552

--- Comment #16 from Ian 'Hixie' Hickson <ian@hixie.ch> 2011-11-01 04:18:29 UTC ---
I really don't think /*...*/ comments fit with the style of WebVTT, based on
comment 13.

Comment 13 has several use cases:
 * Notes at the top of the file for things like copyright, typographic
conventions, etc
 * Notes in a cue regarding uncertainty of the transcription's accuracy
 * Removing blocks of cues that don't belong, but leaving them there anyway
(for some reason?)
 * Commenting out cues that were in an earlier version that didn't correspond
to the actual audio, e.g. because a cue has ugly-looking credits.

The first one we can easily handle using some sort of non-cue syntax like:

   WEBVTT

   NOTES
   bla bla
   bla (this block cannot contain the string "-" "-" ">"
   since recent changes have made the parser eager to find such strings

   00:01.000 --> 00:02.000
   Bla

The second we could handle in a similar way by requiring authors to put such
notes between cues, rather than before or after cues:


   WEBVTT

   00:01.000 --> 00:02.000
   Bla

   NOTE i'm not sure the next cue's timing is right

   00:02.000 --> 00:03.000
   Bla

   00:03.000 --> 00:04.000
   Bla

(such a note couldn't include --> either.)


The last two — removing a block of cues — seems to run counter to the desire to
help authors not ever exclude cues by accident (e.g. the way we now treat -->
as the magical syntax, not the blank line).

-- 
Configure bugmail: http://www.w3.org/Bugs/Public/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the QA contact for the bug.

Received on Tuesday, 1 November 2011 04:18:41 UTC