virtio — archive

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

From: Paul Knight <[email protected]>
To: [email protected]
Date: Mon, 23 Dec 2013 23:12:00 -0000

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 is an example of a computer typesetting system that makes use of ligatures automatically. The Computer Modern Roman 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 - Tel: +1 781-861-1013 OASIS - Advancing open standards for the information society Document Process Analyst -- Paul Knight - Tel: +1 781-861-1013 OASIS - Advancing open standards for the information society Document Process Analyst -- Paul Knight - Tel: +1 781-861-1013 OASIS - Advancing open standards for the information society Document Process Analyst