John made a good point about "fetch a rock". The HTML version doesn't actually add any information from an architectural viewpoint; it's like saying your documentation depends on FrameMaker 7.
I'm happy with the spec as is, with the removal of the Firefox imported interface. Thanks, -tdc On Nov 20, 2008, at 9:36 AM, Dermot McCluskey wrote: > Tom, > > > On 11/20/08 16:50, Tom Childers wrote: >> Hi, Dermot. >> That sounds like a perfect solution. Is there an HTML standard >> that all this material is coded to, like HTML 4.01 Transitional, or >> XHTML 1.1? > > > HTML 4.01. All the .html files include this tag: > > <!DOCTYPE html > PUBLIC "-//W3C//DTD HTML 4.01//EN" > "http://www.w3.org/TR/html4/strict.dtd";> > > > What, if anything, should I put in the Imported > Interfaces section to indicate this? > > > - Dermot > > > > >> -tdc >> On Nov 20, 2008, at 2:42 AM, Dermot McCluskey wrote: >>> Tom, >>> >>> I'm planning to add a .desktop file so the book can >>> be accessed from the gnome-panel Launch menu. >>> >>> I was going to call "firefox file:///usr/share/doc/..." >>> directly from the .desktop file, so that's why I added >>> a dep. on firefox, but thinking more about it, it >>> would be better to call "gnome-open file:///..." and >>> let that deal with whatever browser is configured, if >>> any. So, I'll update the 1-pager to remove the firefox >>> dep. and mention the use of GNOME interfaces and >>> gnome-open instead. >>> >>> Is that reasonable? >>> >>> >>> Thanks, >>> - Dermot >>> >>> >>> >>> On 11/19/08 17:52, Tom Childers wrote: >>>> Does this product actually depend on Firefox, or can any browser >>>> display it? (Understood, there may not be any other viable >>>> alternatives...but I'm not sure FF should be an imported >>>> interface.) >>>> Is there an HTML standard that this product depends on? That >>>> would be an appropriate imported interface. >>>> -tdc >>>> On Nov 18, 2008, at 8:29 PM, Brian Cameron wrote: >>>>> >>>>> Template Version: @(#)onepager.txt 1.35 07/11/07 SMI >>>>> Copyright 2007 Sun Microsystems >>>>> >>>>> 1. Introduction >>>>> 1.1. Project/Component Working Name: >>>>> >>>>> diveintopython 5.4 >>>>> >>>>> 1.2. Name of Document Author/Supplier: >>>>> >>>>> Dermot McCluskey >>>>> >>>>> 1.3. Date of This Document: >>>>> >>>>> 17-Nov-2008 >>>>> >>>>> 1.3.1. Date this project was conceived: >>>>> >>>>> 01-Oct-2008 >>>>> >>>>> 1.4. Name of Major Document Customer(s)/Consumer(s): >>>>> >>>>> 1.4.1. The PAC or CPT you expect to review your project: >>>>> >>>>> Solaris PAC >>>>> >>>>> 1.4.2. The ARC(s) you expect to review your project: >>>>> >>>>> LSARC >>>>> >>>>> 1.4.3. The Director/VP who is "Sponsoring" this project: >>>>> >>>>> robert.odea at sun.com >>>>> >>>>> 1.4.4. The name of your business unit: >>>>> >>>>> OPG / OpenSource. >>>>> >>>>> 1.5. Email Aliases: >>>>> 1.5.1. Responsible Manager: >>>>> >>>>> tom.garland at sun.com >>>>> >>>>> 1.5.2. Responsible Engineer: >>>>> >>>>> dermot.mccluskey at sun.com >>>>> >>>>> 1.5.3. Marketing Manager: >>>>> >>>>> glynn.foster at sun.com >>>>> >>>>> 1.5.4. Interest List: >>>>> >>>>> desktop-discuss at opensolaris.org >>>>> >>>>> 4. Technical Description: >>>>> 4.1. Details: >>>>> >>>>> Dive Into Python is a book for developers using the Python >>>>> programming language. It is an open-source community >>>>> project that >>>>> is available is several formats, including printed book, >>>>> but this >>>>> proposal will add the HTML format version of the book into >>>>> OpenSolaris. Dive Into Python is already included in several >>>>> Linux distributions. >>>>> >>>>> The book is available from the community in several >>>>> languages. >>>>> This proposal will initially add the English language >>>>> edition. If >>>>> sufficient interest is expressed, we will consider adding >>>>> some or >>>>> all of the additional languages. >>>>> >>>>> This proposal adds Dive Into Python 5.4, the latest >>>>> version, to >>>>> OpenSolaris. This version of the book is applicable to all >>>>> versions of the Python language and discusses versions of >>>>> Python >>>>> up to 2.3.2. >>>>> >>>>> A .desktop menu file will be provided so that the book can be >>>>> accessed from the Developer Tools section of the Launch menu. >>>>> >>>>> This proposal seeks Minor release binding. >>>>> >>>>> 4.2. Bug/RFE Number(s): >>>>> >>>>> None. >>>>> >>>>> 4.3. In Scope: >>>>> >>>>> See above. >>>>> >>>>> 4.4. Out of Scope: >>>>> >>>>> See above. >>>>> >>>>> 4.5. Interfaces: >>>>> >>>>> >>>>> ------------------------------------------------------------------------ >>>>> Exported Stability Comments >>>>> >>>>> ------------------------------------------------------------------------ >>>>> SUNWdiveintopython Uncommitted >>>>> >>>>> /usr/share/doc/diveintopython/ Uncommitted Location of >>>>> book >>>>> >>>>> /usr/share/applications/diveintopython.desktop >>>>> Uncommitted >>>>> >>>>> >>>>> ------------------------------------------------------------------------ >>>>> Imported Stability Comments >>>>> >>>>> ------------------------------------------------------------------------ >>>>> firefox Uncommitted LSARC >>>>> 2008/158 >>>>> >>>>> >>>>> 4.6. Doc Impact: >>>>> >>>>> The project consists entirely of documentation. >>>>> >>>>> 4.7. Admin/Config Impact: >>>>> >>>>> None. >>>>> >>>>> 4.8. HA Impact: >>>>> >>>>> None. >>>>> >>>>> 4.9. I18N/L10N Impact: >>>>> >>>>> The JDS and G11N teams are working together to evaluate and >>>>> provide >>>>> I18N/L10N support. >>>>> >>>>> Localized translations of the book may, in future, be added >>>>> to >>>>> OpenSolaris but these will be taken from the Dive Into Python >>>>> community and would not be created by Sun. In-house >>>>> localization >>>>> will be restricted to the .desktop menu file and other >>>>> minor additions. >>>>> >>>>> 4.10. Packaging & Delivery: >>>>> >>>>> Adds one new package, SUNWdiveintopython. >>>>> >>>>> 4.11. Security Impact: >>>>> >>>>> None. >>>>> >>>>> 4.12. Dependencies: >>>>> >>>>> This package depends of the software listed in the Imported >>>>> Interfaces section. >>>>> >>>>> In addition, although not a strict dependency, a Python >>>>> interpreter >>>>> will obviously be needed to make best use of the book. >>>>> >>>>> 5. Reference Documents: >>>>> The Dive Into Python homepage: http://diveintopython.org >>>>> >>>>> LSARC 2008/158, Firefox 3 for Solaris Nevada >>>>>
