virtio — archive

Touch-ups needed for the virtio csd01 and csprd01 file "front matter"

From: Rusty Russell <[email protected]>
To: [email protected]
Date: Tue, 07 Jan 2014 06:08:00 -0000

Paul, what's the status of the draft? It's been a month since the committee approved it, and you previously said the ligatures fix can wait until draft 2. Thanks, Rusty. Paul Knight <[email protected]> writes: > A bit of follow-up on the "fi" and "ff" issue: > > - first, I see that the TC (?) apparently ran into the issue and introduced > a workaround in the file /tex/makehtml.sh > > #For some unclear reason we get 'fi' replaced by NULL character > #on Fedora. file recognizes result as a binary data. > > > - second, for what it's worth, a bit of information which indicates that > there may be a way to shut it off in TeX: > > "TeX < http://en.wikipedia.org/wiki/TeX > is an example of a computer > typesetting system that makes use of ligatures automatically. The Computer > Modern Roman < http://en.wikipedia.org/wiki/Computer_Modern > typeface > provided with TeX includes the five common ligatures *ff*, *fi*, *fl*, *ffi*, > and *ffl*. When TeX finds these combinations in a text it substitutes the > appropriate ligature, **unless overridden by the typesetter.**" [1] > > [1] http://en.wikipedia.org/wiki/Typographic_ligature#Computer_typesetting > > This isn't an area where I can likely be of much help other than to wish > you luck... > > Best regards, > Paul > > > On Mon, Dec 23, 2013 at 4:38 PM, Paul Knight <[email protected]>wrote: > >> Hi Rusty and all, >> >> An interesting item, which I don't think will affect publication, shows up >> in the HTML versions of the documents: >> >> It is probably related to kerning with the LaTex system: >> >> There are combined letters "?" (as opposed to the individual letters >> "fi")in the word "Speci?cation" on the front page and elsewhere, and >> various occurrences of double-f "?", which are actually represented by >> non-ascii characters. (This may or may not show up in this email for your >> amusement.) >> >> Luckily, these do not occur in the URIs, as far as I have been able to >> see... that would be a problem. >> >> For future publications, is there some control over "kerning" to prevent >> this? I think we can live with it, but it's an interesting element which >> could cause problems in some situations. >> >> Best regards, >> Paul >> >> >> On Mon, Dec 23, 2013 at 12:16 PM, Paul Knight <[email protected]>wrote: >> >>> Thanks, Rusty -- this looks good. >>> >>> We'll move the individual footnote files in the HTML format into a >>> subdirectory for publication. >>> >>> Best regards, >>> Paul >>> >>> >>> On Fri, Dec 20, 2013 at 10:54 PM, Rusty Russell <[email protected]>wrote: >>> >>>> Paul Knight <[email protected]> writes: >>>> > Hi Rusty and all, >>>> > >>>> > I've just taken a good look at the virtio files for publication, and >>>> they >>>> > will need a few additional modifications to the front pages. >>>> > >>>> > Although the TC Process does not allow changes to the document content >>>> > after approval, the front pages (down through the table of contents) >>>> may be >>>> > modified without any need for the TC to re-approve anything. >>>> > >>>> > I'm attaching a ZIP file containing examples of the front pages for >>>> both >>>> > the Committee Specification Draft 01 (csd01) and the Public Review >>>> Draft 01 >>>> > (csprd01) EXACTLY as they should appear, and I'll list the needed >>>> changes >>>> > below. >>>> > >>>> > We should be ready to publish the files and begin the Public Review >>>> quickly >>>> > after we receive the updated files. They should be sent to me and Chet. >>>> > >>>> > Changes needed to the csd01 files: >>>> > - Subtitle needs to include the csd number "01", so it will be >>>> Committee >>>> > Specification Draft 01 >>>> >>>> Done. >>>> >>>> > - Citation format needs to include the csd number "01", and also the >>>> word >>>> > "OASIS" before - so it will be OASIS Committee Specification Draft 01. >>>> >>>> Done. >>>> >>>> > - It also needs a period after the "01", and also at the end, after >>>> the URI. >>>> >>>> Done. >>>> >>>> > Please see the attached example, and follow it exactly. >>>> >>>> In addition, I added a horizontal rule above the Notices section in the >>>> html, as your example had. >>>> >>>> > Changes needed to the csprd01 files: >>>> > - Subtitle needs to be: (on two lines) >>>> > Committee Specification Draft 01 / >>>> > Public Review Draft 01 >>>> >>>> Done. >>>> >>>> > - Date needs to be 03 December 2013 - in three places - subtitle, >>>> citation >>>> > format, and footers (it now says 04 December) >>>> >>>> Damn, that's entirely my fault; I updated the respitory and >>>> regenerated. Fixed. >>>> >>>> > - Citation format needs to show "OASIS Committee Specification Draft >>>> 01 / >>>> > Public Review Draft 01". It also needs a period after the (second) >>>> "01", >>>> > and also at the end, after the URI. >>>> > Again, please see the attached examples. >>>> >>>> Yep, fixed too. >>>> >>>> These fixes have all been committed to the repository, so hopefully the >>>> next time we generate a draft it will be flawless. >>>> >>>> Attached below. >>>> >>>> > Finally, there is an issue which I don't think we can address for >>>> > csd01/csprd01 (without re-approval by the TC), but which I very much >>>> hope >>>> > can be addressed in future publications: >>>> > - The 18 footnotes each appear as individual HTML files, leading to a >>>> > terrible clutter in the publication directory. We'd like to see if >>>> they can >>>> > either be included in the main HTML file (typically at the end of the >>>> file) >>>> > or if this can't be arranged, then in a "footnotes" subdirectory. >>>> >>>> Hmm, I'll have to dig deeper to see if I can do that. >>>> >>>> > Although Chet is on vacation now, I'll also check with him to see if >>>> we (TC >>>> > Administration) can apply the "subdirectory" fix to these files during >>>> > publication. It may qualify as an allowable style modification. >>>> >>>> Thanks, >>>> Rusty. >>>> >>>> > Best regards, >>>> > Paul >>>> > -- >>>> > Paul Knight <[email protected]> - Tel: +1 781-861-1013 >>>> > OASIS < http://www.oasis-open.org/ > - Advancing open standards for the >>>> > information society >>>> > Document Process Analyst< >>>> http://www.oasis-open.org/people/staff/paul-knight > >>>> >>>> >>> >>> >>> -- >>> Paul Knight <[email protected]> - Tel: +1 781-861-1013 >>> OASIS < http://www.oasis-open.org/ > - Advancing open standards for the >>> information society >>> Document Process Analyst< http://www.oasis-open.org/people/staff/paul-knight > >>> >>> >> >> >> -- >> Paul Knight <[email protected]> - Tel: +1 781-861-1013 >> OASIS < http://www.oasis-open.org/ > - Advancing open standards for the >> information society >> Document Process Analyst< http://www.oasis-open.org/people/staff/paul-knight > >> >> > > > -- > Paul Knight <[email protected]> - Tel: +1 781-861-1013 > OASIS < http://www.oasis-open.org/ > - Advancing open standards for the > information society > Document Process Analyst< http://www.oasis-open.org/people/staff/paul-knight >