From bugzilla at redhat.com Fri Aug 1 04:29:59 2008 From: bugzilla at redhat.com (bugzilla at redhat.com) Date: Fri, 1 Aug 2008 00:29:59 -0400 Subject: [publican-list] [Bug 457339] RFE: can make test please only run over included files In-Reply-To: Message-ID: <200808010429.m714Txod021522@bz-web2.app.phx.redhat.com> Please do not reply directly to this email. All additional comments should be made in the comments box of this bug report. Summary: RFE: can make test please only run over included files https://bugzilla.redhat.com/show_bug.cgi?id=457339 jfearn at redhat.com changed: What |Removed |Added ---------------------------------------------------------------------------- Status|NEW |CLOSED Resolution| |NOTABUG ------- Additional Comments From jfearn at redhat.com 2008-08-01 00:29 EST ------- No, move the files to a different directory. -- Configure bugmail: https://bugzilla.redhat.com/userprefs.cgi?tab=email ------- You are receiving this mail because: ------- You are on the CC list for the bug, or are watching someone who is. From daobrien at redhat.com Fri Aug 1 04:55:44 2008 From: daobrien at redhat.com (David O'Brien) Date: Fri, 01 Aug 2008 14:55:44 +1000 Subject: [publican-list] [Bug 457339] RFE: can make test please only run over included files In-Reply-To: <200808010429.m714Txod021522@bz-web2.app.phx.redhat.com> References: <200808010429.m714Txod021522@bz-web2.app.phx.redhat.com> Message-ID: <48929750.30203@redhat.com> bugzilla at redhat.com wrote: > Please do not reply directly to this email. All additional > comments should be made in the comments box of this bug report. > > Summary: RFE: can make test please only run over included files > > > https://bugzilla.redhat.com/show_bug.cgi?id=457339 > > > jfearn at redhat.com changed: > > What |Removed |Added > ---------------------------------------------------------------------------- > Status|NEW |CLOSED > Resolution| |NOTABUG > > > > > ------- Additional Comments From jfearn at redhat.com 2008-08-01 00:29 EST ------- > No, move the files to a different directory. > > or mv .xml .xml.orig It only processes .xml files (or it did last time I did this) -- David O'Brien IPA Content Author Red Hat Asia Pacific "We couldn't care less about comfort. We make you feel good." Federico Minoli CEO Ducati Motor S.p.A. From jfearn at redhat.com Tue Aug 5 07:22:56 2008 From: jfearn at redhat.com (Jeff Fearn) Date: Tue, 05 Aug 2008 17:22:56 +1000 Subject: [publican-list] Proposed changes to Book_Info.xml Message-ID: <4897FFD0.4040600@redhat.com> A bug has been raised about how the titles currently differ between the HTML and PDF outputs, this has lead to a review to the way the Book_Info.xml files are structured. https://bugzilla.redhat.com/show_bug.cgi?id=456497 Currently the usage is: title: the name of the Product the book is about. subtitle: the actual title of the book. issuenum: the version of the Product the book is about. productnumber: the release of the book for this Product version. This is somewhat confusing and I'd like to change it to: productname: the name of the product this book is about. productnumber: the version of the product this book is about. pubsnumber: the release of this book for this products version. (Only used for rpm) title: the title of this book. subtitle: a secondary title for this book. This would then lead to a restructuring of the way the titles are displayed. The cover page display would be: Top of page centered, font size 2em, colored block: ProductName ProductVersion Below that block, centered, font size 2em: BookTitle Below that, centered, font size 1.8em: BookSubTitle The centering is because the current layout makes it hard to separate the titles from the content, this small changes highlights the titles and brings the HTML and PDF in to alignment. No feedback means I am right and should proceed however I want :D Cheers, Jeff. -- Jeff Fearn Software Engineer Engineering Operations Red Hat, Inc From daobrien at redhat.com Tue Aug 5 11:49:39 2008 From: daobrien at redhat.com (David O'Brien) Date: Tue, 05 Aug 2008 21:49:39 +1000 Subject: [publican-list] Proposed changes to Book_Info.xml In-Reply-To: <4897FFD0.4040600@redhat.com> References: <4897FFD0.4040600@redhat.com> Message-ID: <48983E53.8000102@redhat.com> Jeff Fearn wrote: > A bug has been raised about how the titles currently differ between > the HTML and PDF outputs, this has lead to a review to the way the > Book_Info.xml files are structured. > > https://bugzilla.redhat.com/show_bug.cgi?id=456497 > > Currently the usage is: > > title: the name of the Product the book is about. > subtitle: the actual title of the book. > issuenum: the version of the Product the book is about. > productnumber: the release of the book for this Product version. > > This is somewhat confusing and I'd like to change it to: > > productname: the name of the product this book is about. > productnumber: the version of the product this book is about. > pubsnumber: the release of this book for this products version. (Only > used for rpm) > title: the title of this book. > subtitle: a secondary title for this book. > > This would then lead to a restructuring of the way the titles are > displayed. > > The cover page display would be: > > Top of page centered, font size 2em, colored block: ProductName > ProductVersion > Below that block, centered, font size 2em: BookTitle > Below that, centered, font size 1.8em: BookSubTitle > > The centering is because the current layout makes it hard to separate > the titles from the content, this small changes highlights the titles > and brings the HTML and PDF in to alignment. > > No feedback means I am right and should proceed however I want :D > > Cheers, Jeff. > Mostly that looks fine to me, but not 100% sure about the pubsnumber. Why would you only use that for the rpm? If you provide updates to the original release of a manual, but where there are no changes to the product, how is this indicated? Only in the Revision History? Can we not provide something more obvious? I admit to not spending much time looking at the final output, though, such as size and placement of titles, etc.; that's not my "forte". ^^ Any thoughts on whether we should effect any changes to RH entity names at the same time? A bit more work involved, to be sure, but I always like to raise the consistency questions. We have a bit of a mixture at present. Some that I use look like: &PRODNAME; &TITLE;"> I bet Jeff's next salary that every other non-IPA .ent file is different :-) cheers -- David O'Brien IPA Content Author Red Hat Asia Pacific "We couldn't care less about comfort. We make you feel good." Federico Minoli CEO Ducati Motor S.p.A. From stickster at gmail.com Tue Aug 5 13:05:17 2008 From: stickster at gmail.com (Paul W. Frields) Date: Tue, 05 Aug 2008 13:05:17 +0000 Subject: [publican-list] Proposed changes to Book_Info.xml In-Reply-To: <48983E53.8000102@redhat.com> References: <4897FFD0.4040600@redhat.com> <48983E53.8000102@redhat.com> Message-ID: <1217941517.6981.26.camel@victoria> On Tue, 2008-08-05 at 21:49 +1000, David O'Brien wrote: > Jeff Fearn wrote: > > A bug has been raised about how the titles currently differ between > > the HTML and PDF outputs, this has lead to a review to the way the > > Book_Info.xml files are structured. > > > > https://bugzilla.redhat.com/show_bug.cgi?id=456497 > > > > Currently the usage is: > > > > title: the name of the Product the book is about. > > subtitle: the actual title of the book. > > issuenum: the version of the Product the book is about. > > productnumber: the release of the book for this Product version. > > > > This is somewhat confusing and I'd like to change it to: > > > > productname: the name of the product this book is about. > > productnumber: the version of the product this book is about. > > pubsnumber: the release of this book for this products version. (Only > > used for rpm) > > title: the title of this book. > > subtitle: a secondary title for this book. > > > > This would then lead to a restructuring of the way the titles are > > displayed. > > > > The cover page display would be: > > > > Top of page centered, font size 2em, colored block: ProductName > > ProductVersion > > Below that block, centered, font size 2em: BookTitle > > Below that, centered, font size 1.8em: BookSubTitle > > > > The centering is because the current layout makes it hard to separate > > the titles from the content, this small changes highlights the titles > > and brings the HTML and PDF in to alignment. > > > > No feedback means I am right and should proceed however I want :D > > > > Cheers, Jeff. > > > Mostly that looks fine to me, but not 100% sure about the pubsnumber. > Why would you only use that for the rpm? If you provide updates to the > original release of a manual, but where there are no changes to the > product, how is this indicated? Only in the Revision History? Can we not > provide something more obvious? > > I admit to not spending much time looking at the final output, though, > such as size and placement of titles, etc.; that's not my "forte". ^^ > > Any thoughts on whether we should effect any changes to RH entity names > at the same time? A bit more work involved, to be sure, but I always > like to raise the consistency questions. We have a bit of a mixture at > present. Some that I use look like: > > > > > > &PRODNAME; &TITLE;"> > > I bet Jeff's next salary that every other non-IPA .ent file is different :-) How does this affect books which are about a nonversioned (i.e. generic platform) feature? An example that comes to mind is the Fedora Documentation Guide, which doesn't map one-to-one to a product. -- Paul W. Frields gpg fingerprint: 3DA6 A0AC 6D58 FEC4 0233 5906 ACDB C937 BD11 3717 http://paul.frields.org/ - - http://pfrields.fedorapeople.org/ irc.freenode.net: stickster @ #fedora-docs, #fedora-devel, #fredlug -------------- next part -------------- A non-text attachment was scrubbed... Name: signature.asc Type: application/pgp-signature Size: 189 bytes Desc: This is a digitally signed message part URL: From bugzilla at redhat.com Wed Aug 6 03:18:45 2008 From: bugzilla at redhat.com (bugzilla at redhat.com) Date: Tue, 5 Aug 2008 23:18:45 -0400 Subject: [publican-list] [Bug 458003] New: Korean font breaks PDF generation Message-ID: Please do not reply directly to this email. All additional comments should be made in the comments box of this bug. Summary: Korean font breaks PDF generation https://bugzilla.redhat.com/show_bug.cgi?id=458003 Summary: Korean font breaks PDF generation Product: Fedora Version: rawhide Platform: All OS/Version: Linux Status: NEW Severity: medium Priority: medium Component: publican AssignedTo: jfearn at redhat.com ReportedBy: jfearn at redhat.com QAContact: extras-qa at fedoraproject.org CC: mmcallis at redhat.com, publican-list at redhat.com Estimated Hours: 0.0 Classification: Fedora Description of problem: The Korean font has been moved and it's failure to create a metrics file causes PDF generation to fail. Version-Release number of selected component (if applicable): publican-0.34 How reproducible: Always Actual results: Generating metrics for: /usr/share/fonts/baekmuk-ttf-batang/batang.ttf Error while building XML font metrics file. java.io.FileNotFoundException: /usr/share/fonts/baekmuk-ttf-batang/batang.ttf (No such file or directory) Expected results: font metric file Additional info: The script that builds font metrics needs to die properly so broken packages don't get created. -- Configure bugmail: https://bugzilla.redhat.com/userprefs.cgi?tab=email ------- You are receiving this mail because: ------- You are on the CC list for the bug. From bugzilla at redhat.com Wed Aug 6 03:42:00 2008 From: bugzilla at redhat.com (bugzilla at redhat.com) Date: Tue, 5 Aug 2008 23:42:00 -0400 Subject: [publican-list] [Bug 458003] Korean font breaks PDF generation In-Reply-To: References: Message-ID: <200808060342.m763g0BA015004@bz-web2.app.phx.redhat.com> Please do not reply directly to this email. All additional comments should be made in the comments box of this bug. https://bugzilla.redhat.com/show_bug.cgi?id=458003 Jeff Fearn changed: What |Removed |Added ---------------------------------------------------------------------------- Status|NEW |CLOSED Fixed In Version| |0.35 Resolution| |CURRENTRELEASE --- Comment #1 from Jeff Fearn 2008-08-05 23:41:59 EDT --- Changed font path and Requires font name. Ensured font metric script dies properly if metric generation fails. -- Configure bugmail: https://bugzilla.redhat.com/userprefs.cgi?tab=email ------- You are receiving this mail because: ------- You are on the CC list for the bug. From jfearn at redhat.com Wed Aug 6 05:17:38 2008 From: jfearn at redhat.com (Jeff Fearn) Date: Wed, 06 Aug 2008 15:17:38 +1000 Subject: [publican-list] Proposed changes to Book_Info.xml In-Reply-To: <1217941517.6981.26.camel@victoria> References: <4897FFD0.4040600@redhat.com> <48983E53.8000102@redhat.com> <1217941517.6981.26.camel@victoria> Message-ID: <489933F2.9070205@redhat.com> Paul W. Frields wrote: > On Tue, 2008-08-05 at 21:49 +1000, David O'Brien wrote: >> Jeff Fearn wrote: >>> A bug has been raised about how the titles currently differ between >>> the HTML and PDF outputs, this has lead to a review to the way the >>> Book_Info.xml files are structured. >>> >>> https://bugzilla.redhat.com/show_bug.cgi?id=456497 >>> >>> Currently the usage is: >>> >>> title: the name of the Product the book is about. >>> subtitle: the actual title of the book. >>> issuenum: the version of the Product the book is about. >>> productnumber: the release of the book for this Product version. >>> >>> This is somewhat confusing and I'd like to change it to: >>> >>> productname: the name of the product this book is about. >>> productnumber: the version of the product this book is about. >>> pubsnumber: the release of this book for this products version. (Only >>> used for rpm) >>> title: the title of this book. >>> subtitle: a secondary title for this book. >>> >>> This would then lead to a restructuring of the way the titles are >>> displayed. >>> >>> The cover page display would be: >>> >>> Top of page centered, font size 2em, colored block: ProductName >>> ProductVersion >>> Below that block, centered, font size 2em: BookTitle >>> Below that, centered, font size 1.8em: BookSubTitle >>> >>> The centering is because the current layout makes it hard to separate >>> the titles from the content, this small changes highlights the titles >>> and brings the HTML and PDF in to alignment. >>> >>> No feedback means I am right and should proceed however I want :D >>> >>> Cheers, Jeff. >>> >> Mostly that looks fine to me, but not 100% sure about the pubsnumber. >> Why would you only use that for the rpm? If you provide updates to the >> original release of a manual, but where there are no changes to the >> product, how is this indicated? Only in the Revision History? Can we not >> provide something more obvious? >> >> I admit to not spending much time looking at the final output, though, >> such as size and placement of titles, etc.; that's not my "forte". ^^ >> >> Any thoughts on whether we should effect any changes to RH entity names >> at the same time? A bit more work involved, to be sure, but I always >> like to raise the consistency questions. We have a bit of a mixture at >> present. Some that I use look like: >> >> >> >> >> >> &PRODNAME; &TITLE;"> >> >> I bet Jeff's next salary that every other non-IPA .ent file is different :-) > > How does this affect books which are about a nonversioned (i.e. generic > platform) feature? An example that comes to mind is the Fedora > Documentation Guide, which doesn't map one-to-one to a product. This field is currently mandatory, so we'd have to add an exception for this practice. The output would just skip the version, since XSL is tolerant that way. The RPMs require this field, so you would not be able to create desktop RPMs with such a book. We could probably hack in a way to have the version in the Makefile instead of the Book_Info.xml. I've been trying to keep as much in the xml files as I can to avoid having writers edit the makefile, since I get lots of flack every time I make them do that :D Cheers, Jeff. -- Jeff Fearn Software Engineer Engineering Operations Red Hat, Inc From bugzilla at redhat.com Wed Aug 6 06:09:33 2008 From: bugzilla at redhat.com (bugzilla at redhat.com) Date: Wed, 6 Aug 2008 02:09:33 -0400 Subject: [publican-list] [Bug 456170] publican won't render valid DocBook XML document In-Reply-To: References: Message-ID: <200808060609.m7669XQ5002269@bz-web2.app.phx.redhat.com> Please do not reply directly to this email. All additional comments should be made in the comments box of this bug. https://bugzilla.redhat.com/show_bug.cgi?id=456170 Jeff Fearn changed: What |Removed |Added ---------------------------------------------------------------------------- CC| |publican-list at redhat.com Customer Facing| |--- -- Configure bugmail: https://bugzilla.redhat.com/userprefs.cgi?tab=email ------- You are receiving this mail because: ------- You are on the CC list for the bug. From bugzilla at redhat.com Wed Aug 6 06:12:28 2008 From: bugzilla at redhat.com (bugzilla at redhat.com) Date: Wed, 6 Aug 2008 02:12:28 -0400 Subject: [publican-list] [Bug 456170] publican won't render valid DocBook XML document In-Reply-To: References: Message-ID: <200808060612.m766CSrB002942@bz-web2.app.phx.redhat.com> Please do not reply directly to this email. All additional comments should be made in the comments box of this bug. https://bugzilla.redhat.com/show_bug.cgi?id=456170 --- Comment #6 from Jeff Fearn 2008-08-06 02:12:27 EDT --- I have added a warning message: *WARNING: Entities Declared in XML* Entities declared in XML files are excluded from all output. Entities should be declared in en-US/Publican.ent Declaration in: en-US/Book_Info.xml It will spit out one such warning for each xml file containing an entity declaration. The documentation has been updated to reflect this design decision, feedback welcomed :) http://jfearn.fedorapeople.org/Publican/chap-Publican-Introduction.html -- Configure bugmail: https://bugzilla.redhat.com/userprefs.cgi?tab=email ------- You are receiving this mail because: ------- You are on the CC list for the bug. From bugzilla at redhat.com Wed Aug 6 06:31:09 2008 From: bugzilla at redhat.com (bugzilla at redhat.com) Date: Wed, 6 Aug 2008 02:31:09 -0400 Subject: [publican-list] [Bug 458020] New: RFE: please remove passive voice from "Adding Images" section Message-ID: Please do not reply directly to this email. All additional comments should be made in the comments box of this bug. Summary: RFE: please remove passive voice from "Adding Images" section https://bugzilla.redhat.com/show_bug.cgi?id=458020 Summary: RFE: please remove passive voice from "Adding Images" section Product: Red Hat Enterprise Linux 5 Version: 5.2 Platform: am31 URL: http://jfearn.fedorapeople.org/Publican/sect-Publican- Using_the_publican_package-Adding_Images.html OS/Version: Windows Status: NEW Severity: low Priority: low Component: publican AssignedTo: jfearn at redhat.com ReportedBy: mmcallis at redhat.com QAContact: mhideo at redhat.com CC: publican-list at redhat.com Estimated Hours: 0.0 Classification: Red Hat Please change "The build system will only use images" to "The build system only uses images", and "Other directories will not work." to "Other directories do not work". Cheers. -- Configure bugmail: https://bugzilla.redhat.com/userprefs.cgi?tab=email ------- You are receiving this mail because: ------- You are on the CC list for the bug. From bugzilla at redhat.com Wed Aug 6 06:35:47 2008 From: bugzilla at redhat.com (bugzilla at redhat.com) Date: Wed, 6 Aug 2008 02:35:47 -0400 Subject: [publican-list] [Bug 458020] RFE: please remove passive voice from "Adding Images" section In-Reply-To: References: Message-ID: <200808060635.m766Zlkl001711@bz-web1.app.phx.redhat.com> Please do not reply directly to this email. All additional comments should be made in the comments box of this bug. https://bugzilla.redhat.com/show_bug.cgi?id=458020 Jeff Fearn changed: What |Removed |Added ---------------------------------------------------------------------------- AssignedTo|jfearn at redhat.com |mmcallis at redhat.com -- Configure bugmail: https://bugzilla.redhat.com/userprefs.cgi?tab=email ------- You are receiving this mail because: ------- You are on the CC list for the bug. From bugzilla at redhat.com Wed Aug 6 07:17:27 2008 From: bugzilla at redhat.com (bugzilla at redhat.com) Date: Wed, 6 Aug 2008 03:17:27 -0400 Subject: [publican-list] [Bug 458020] RFE: please remove passive voice from "Adding Images" section In-Reply-To: References: Message-ID: <200808060717.m767HRT6011991@bz-web2.app.phx.redhat.com> Please do not reply directly to this email. All additional comments should be made in the comments box of this bug. https://bugzilla.redhat.com/show_bug.cgi?id=458020 Murray McAllister changed: What |Removed |Added ---------------------------------------------------------------------------- Status|NEW |MODIFIED Platform|am31 |All OS/Version|Windows |Linux --- Comment #1 from Murray McAllister 2008-08-06 03:17:27 EDT --- r390 | mdious | 2008-08-06 17:16:24 +1000 (Wed, 06 Aug 2008) | 3 lines Red Hat BZ #458020 - removing passive voice from "Adding Images" section. -- Configure bugmail: https://bugzilla.redhat.com/userprefs.cgi?tab=email ------- You are receiving this mail because: ------- You are on the CC list for the bug. From stickster at gmail.com Wed Aug 6 12:35:20 2008 From: stickster at gmail.com (Paul W. Frields) Date: Wed, 06 Aug 2008 08:35:20 -0400 Subject: [publican-list] Proposed changes to Book_Info.xml In-Reply-To: <489933F2.9070205@redhat.com> References: <4897FFD0.4040600@redhat.com> <48983E53.8000102@redhat.com> <1217941517.6981.26.camel@victoria> <489933F2.9070205@redhat.com> Message-ID: <1218026120.3749.48.camel@victoria> On Wed, 2008-08-06 at 15:17 +1000, Jeff Fearn wrote: > Paul W. Frields wrote: > > On Tue, 2008-08-05 at 21:49 +1000, David O'Brien wrote: > >> Jeff Fearn wrote: > >>> A bug has been raised about how the titles currently differ between > >>> the HTML and PDF outputs, this has lead to a review to the way the > >>> Book_Info.xml files are structured. > >>> > >>> https://bugzilla.redhat.com/show_bug.cgi?id=456497 > >>> > >>> Currently the usage is: > >>> > >>> title: the name of the Product the book is about. > >>> subtitle: the actual title of the book. > >>> issuenum: the version of the Product the book is about. > >>> productnumber: the release of the book for this Product version. > >>> > >>> This is somewhat confusing and I'd like to change it to: > >>> > >>> productname: the name of the product this book is about. > >>> productnumber: the version of the product this book is about. > >>> pubsnumber: the release of this book for this products version. (Only > >>> used for rpm) > >>> title: the title of this book. > >>> subtitle: a secondary title for this book. > >>> > >>> This would then lead to a restructuring of the way the titles are > >>> displayed. > >>> > >>> The cover page display would be: > >>> > >>> Top of page centered, font size 2em, colored block: ProductName > >>> ProductVersion > >>> Below that block, centered, font size 2em: BookTitle > >>> Below that, centered, font size 1.8em: BookSubTitle > >>> > >>> The centering is because the current layout makes it hard to separate > >>> the titles from the content, this small changes highlights the titles > >>> and brings the HTML and PDF in to alignment. > >>> > >>> No feedback means I am right and should proceed however I want :D > >>> > >> Mostly that looks fine to me, but not 100% sure about the pubsnumber. > >> Why would you only use that for the rpm? If you provide updates to the > >> original release of a manual, but where there are no changes to the > >> product, how is this indicated? Only in the Revision History? Can we not > >> provide something more obvious? > >> > >> I admit to not spending much time looking at the final output, though, > >> such as size and placement of titles, etc.; that's not my "forte". ^^ > >> > >> Any thoughts on whether we should effect any changes to RH entity names > >> at the same time? A bit more work involved, to be sure, but I always > >> like to raise the consistency questions. We have a bit of a mixture at > >> present. Some that I use look like: > >> > >> > >> > >> > >> > >> &PRODNAME; &TITLE;"> > >> > >> I bet Jeff's next salary that every other non-IPA .ent file is different :-) > > > > How does this affect books which are about a nonversioned (i.e. generic > > platform) feature? An example that comes to mind is the Fedora > > Documentation Guide, which doesn't map one-to-one to a product. > > This field is currently mandatory, so we'd have to add an exception > for this practice. > > The output would just skip the version, since XSL is tolerant that > way. > > The RPMs require this field, so you would not be able to create > desktop RPMs with such a book. > > We could probably hack in a way to have the version in the Makefile > instead of the Book_Info.xml. I've been trying to keep as much in the > xml files as I can to avoid having writers edit the makefile, since I > get lots of flack every time I make them do that :D I can definitely understand not wanting people to do this in the Makefile. Maybe I'm misunderstanding the usage -- if pubsnumber maps to a revision of the publication (i.e. Documentation Guide 0.5), and the version of the product is missing (which in the example is the case), does the new usage fit properly? -- Paul W. Frields gpg fingerprint: 3DA6 A0AC 6D58 FEC4 0233 5906 ACDB C937 BD11 3717 http://paul.frields.org/ - - http://pfrields.fedorapeople.org/ irc.freenode.net: stickster @ #fedora-docs, #fedora-devel, #fredlug -------------- next part -------------- A non-text attachment was scrubbed... Name: signature.asc Type: application/pgp-signature Size: 189 bytes Desc: This is a digitally signed message part URL: From jfearn at redhat.com Wed Aug 6 23:13:09 2008 From: jfearn at redhat.com (Jeff Fearn) Date: Thu, 07 Aug 2008 09:13:09 +1000 Subject: [publican-list] Proposed changes to Book_Info.xml In-Reply-To: <48983E53.8000102@redhat.com> References: <4897FFD0.4040600@redhat.com> <48983E53.8000102@redhat.com> Message-ID: <489A3005.1060503@redhat.com> David O'Brien wrote: > Jeff Fearn wrote: >> A bug has been raised about how the titles currently differ between >> the HTML and PDF outputs, this has lead to a review to the way the >> Book_Info.xml files are structured. >> >> https://bugzilla.redhat.com/show_bug.cgi?id=456497 >> >> Currently the usage is: >> >> title: the name of the Product the book is about. >> subtitle: the actual title of the book. >> issuenum: the version of the Product the book is about. >> productnumber: the release of the book for this Product version. >> >> This is somewhat confusing and I'd like to change it to: >> >> productname: the name of the product this book is about. >> productnumber: the version of the product this book is about. >> pubsnumber: the release of this book for this products version. (Only >> used for rpm) >> title: the title of this book. >> subtitle: a secondary title for this book. >> >> This would then lead to a restructuring of the way the titles are >> displayed. >> >> The cover page display would be: >> >> Top of page centered, font size 2em, colored block: ProductName >> ProductVersion >> Below that block, centered, font size 2em: BookTitle >> Below that, centered, font size 1.8em: BookSubTitle >> >> The centering is because the current layout makes it hard to separate >> the titles from the content, this small changes highlights the titles >> and brings the HTML and PDF in to alignment. >> >> No feedback means I am right and should proceed however I want :D >> >> Cheers, Jeff. >> > Mostly that looks fine to me, but not 100% sure about the pubsnumber. > Why would you only use that for the rpm? If you provide updates to the > original release of a manual, but where there are no changes to the > product, how is this indicated? Only in the Revision History? Can we not > provide something more obvious? Just to come back to pubsnumber, I don't think it would be useful as a visual indication that a book has changed. Having 2 numbers on the cover page may be confusing. I think a better way of doing this would be to set a publishing date, either in the xml, or as I prefer in the build process, to indicate when the book was last built. People will grok that a new publication date may mean things have been updated. Another way would be to grab the latest revision number from the Revision_History file and not use pubsnumber at all. Then we could add 'Revision: "??"' to the cover pages. Cheers, Jeff. -- Jeff Fearn Software Engineer Engineering Operations Red Hat, Inc From bugzilla at redhat.com Thu Aug 7 03:04:49 2008 From: bugzilla at redhat.com (bugzilla at redhat.com) Date: Wed, 6 Aug 2008 23:04:49 -0400 Subject: [publican-list] [Bug 458020] RFE: please remove passive voice from "Adding Images" section In-Reply-To: References: Message-ID: <200808070304.m7734ndn013304@bz-web1.app.phx.redhat.com> Please do not reply directly to this email. All additional comments should be made in the comments box of this bug. https://bugzilla.redhat.com/show_bug.cgi?id=458020 Murray McAllister changed: What |Removed |Added ---------------------------------------------------------------------------- Status|MODIFIED |CLOSED Fixed In Version| |0.35 Resolution| |CURRENTRELEASE -- Configure bugmail: https://bugzilla.redhat.com/userprefs.cgi?tab=email ------- You are receiving this mail because: ------- You are on the CC list for the bug. From daobrien at redhat.com Thu Aug 7 03:34:05 2008 From: daobrien at redhat.com (David O'Brien) Date: Thu, 07 Aug 2008 13:34:05 +1000 Subject: [publican-list] Proposed changes to Book_Info.xml In-Reply-To: <489A3005.1060503@redhat.com> References: <4897FFD0.4040600@redhat.com> <48983E53.8000102@redhat.com> <489A3005.1060503@redhat.com> Message-ID: <489A6D2D.8070508@redhat.com> Jeff Fearn wrote: > David O'Brien wrote: >> Jeff Fearn wrote: >>> A bug has been raised about how the titles currently differ between >>> the HTML and PDF outputs, this has lead to a review to the way the >>> Book_Info.xml files are structured. >>> >>> https://bugzilla.redhat.com/show_bug.cgi?id=456497 >>> >>> Currently the usage is: >>> >>> title: the name of the Product the book is about. >>> subtitle: the actual title of the book. >>> issuenum: the version of the Product the book is about. >>> productnumber: the release of the book for this Product version. >>> >>> This is somewhat confusing and I'd like to change it to: >>> >>> productname: the name of the product this book is about. >>> productnumber: the version of the product this book is about. >>> pubsnumber: the release of this book for this products version. >>> (Only used for rpm) >>> title: the title of this book. >>> subtitle: a secondary title for this book. >>> >>> This would then lead to a restructuring of the way the titles are >>> displayed. >>> >>> The cover page display would be: >>> >>> Top of page centered, font size 2em, colored block: ProductName >>> ProductVersion >>> Below that block, centered, font size 2em: BookTitle >>> Below that, centered, font size 1.8em: BookSubTitle >>> >>> The centering is because the current layout makes it hard to >>> separate the titles from the content, this small changes highlights >>> the titles and brings the HTML and PDF in to alignment. >>> >>> No feedback means I am right and should proceed however I want :D >>> >>> Cheers, Jeff. >>> >> Mostly that looks fine to me, but not 100% sure about the pubsnumber. >> Why would you only use that for the rpm? If you provide updates to >> the original release of a manual, but where there are no changes to >> the product, how is this indicated? Only in the Revision History? Can >> we not provide something more obvious? > > Just to come back to pubsnumber, I don't think it would be useful as a > visual indication that a book has changed. Having 2 numbers on the > cover page may be confusing. > > I think a better way of doing this would be to set a publishing date, > either in the xml, or as I prefer in the build process, to indicate > when the book was last built. People will grok that a new publication > date may mean things have been updated. > > Another way would be to grab the latest revision number from the > Revision_History file and not use pubsnumber at all. > > Then we could add 'Revision: "??"' to the cover pages. > > Cheers, Jeff. > I don't mind the idea of using the build date. I actually prefer that to using the Revision History. Build dates (generally) don't lie, but writers are responsible for maintaining the Revision History file. I think I know which is more reliable :) -- David O'Brien IPA Content Author Red Hat Asia Pacific "We couldn't care less about comfort. We make you feel good." Federico Minoli CEO Ducati Motor S.p.A. From jwulf at redhat.com Thu Aug 7 04:59:30 2008 From: jwulf at redhat.com (Joshua Wulf) Date: Thu, 07 Aug 2008 14:59:30 +1000 Subject: [publican-list] Proposed changes to Book_Info.xml In-Reply-To: <489A6D2D.8070508@redhat.com> References: <4897FFD0.4040600@redhat.com> <48983E53.8000102@redhat.com> <489A3005.1060503@redhat.com> <489A6D2D.8070508@redhat.com> Message-ID: <489A8132.9010009@redhat.com> David O'Brien wrote: > I don't mind the idea of using the build date. I actually prefer that > to using the Revision History. Build dates (generally) don't lie, but > writers are responsible for maintaining the Revision History file. I > think I know which is more reliable :) > Setting the date of publication at build time: Pluses: I don't know how many times I've built a new version of a book and forgotten to go into yet another xml file and update the date. Minuses: Books which are unmodified display a different date if they are rebuilt. -- Joshua J Wulf Engineering Content Services Red Hat Asia Pacific tel: +61 (0)7 3514 8140 mob: +61 (0)431 929 675 eml: jwulf at redhat.com From bugzilla at redhat.com Mon Aug 11 01:28:18 2008 From: bugzilla at redhat.com (bugzilla at redhat.com) Date: Sun, 10 Aug 2008 21:28:18 -0400 Subject: [publican-list] [Bug 458618] New: make commands hang after re-installing publican Message-ID: Please do not reply directly to this email. All additional comments should be made in the comments box of this bug. Summary: make commands hang after re-installing publican https://bugzilla.redhat.com/show_bug.cgi?id=458618 Summary: make commands hang after re-installing publican Product: Red Hat Enterprise Linux 5 Version: 5.2 Platform: All OS/Version: Linux Status: NEW Severity: medium Priority: medium Component: publican AssignedTo: jfearn at redhat.com ReportedBy: mmcallis at redhat.com QAContact: mhideo at redhat.com CC: publican-list at redhat.com Estimated Hours: 0.0 Classification: Red Hat Created an attachment (id=313901) --> (https://bugzilla.redhat.com/attachment.cgi?id=313901) strace make test Version-Release number of selected component (if applicable): publican-doc-0.33-0.el5 publican-0.33-0.el5 publican-fedora-0.12-0.el5 publican-jboss-0.12-0.el5 publican-redhat-0.12-0.el5 Steps to Reproduce: 1. yum remove publican (removes all publican packages) 2. yum install publican\* 3. make test, make html (except make clean) Actual results: hang: END: xml-en-US Mon Aug 11 11:22:08 EST 2008 START: test-en-US Mon Aug 11 11:22:08 EST 2008 Does not complete; does not build HTML files. See attached strace of make test. -- Configure bugmail: https://bugzilla.redhat.com/userprefs.cgi?tab=email ------- You are receiving this mail because: ------- You are on the CC list for the bug. From kwade at redhat.com Mon Aug 11 19:26:41 2008 From: kwade at redhat.com (Karsten 'quaid' Wade) Date: Mon, 11 Aug 2008 12:26:41 -0700 Subject: [publican-list] Proposed changes to Book_Info.xml In-Reply-To: <489A8132.9010009@redhat.com> References: <4897FFD0.4040600@redhat.com> <48983E53.8000102@redhat.com> <489A3005.1060503@redhat.com> <489A6D2D.8070508@redhat.com> <489A8132.9010009@redhat.com> Message-ID: <1218482801.4118.29.camel@calliope.phig.org> On Thu, 2008-08-07 at 14:59 +1000, Joshua Wulf wrote: > David O'Brien wrote: > > I don't mind the idea of using the build date. I actually prefer that > > to using the Revision History. Build dates (generally) don't lie, but > > writers are responsible for maintaining the Revision History file. I > > think I know which is more reliable :) > > > Setting the date of publication at build time: > > Pluses: > > I don't know how many times I've built a new version of a book and > forgotten to go into yet another xml file and update the date. > > Minuses: > > Books which are unmodified display a different date if they are rebuilt. Thus the showing of a different date is not a guarantee of changed content, but is a clue. With shared modular content, it's also possible that a rebuild does capture new content. - Karsten -- Karsten Wade, Sr. Developer Community Mgr. Dev Fu : http://developer.redhatmagazine.com Fedora : http://quaid.fedorapeople.org gpg key : AD0E0C41 -------------- next part -------------- A non-text attachment was scrubbed... Name: signature.asc Type: application/pgp-signature Size: 189 bytes Desc: This is a digitally signed message part URL: From bugzilla at redhat.com Tue Aug 12 01:48:03 2008 From: bugzilla at redhat.com (bugzilla at redhat.com) Date: Mon, 11 Aug 2008 21:48:03 -0400 Subject: [publican-list] [Bug 458740] New: error 6 in building translated html Message-ID: Please do not reply directly to this email. All additional comments should be made in the comments box of this bug. Summary: error 6 in building translated html https://bugzilla.redhat.com/show_bug.cgi?id=458740 Summary: error 6 in building translated html Product: Red Hat Enterprise Linux 5 Version: 5.2 Platform: All OS/Version: Linux Status: NEW Severity: medium Priority: medium Component: publican AssignedTo: jfearn at redhat.com ReportedBy: ccurran at redhat.com QAContact: mhideo at redhat.com CC: publican-list at redhat.com Estimated Hours: 0.0 Classification: Red Hat Description of problem: sloppy selector in translated make html. Publican is using en-US/* instead of en-US/*.xml Version-Release number of selected component (if applicable): How reproducible: Steps to Reproduce: 1. 2. 3. Actual results: Expected results: Additional info: -- Configure bugmail: https://bugzilla.redhat.com/userprefs.cgi?tab=email ------- You are receiving this mail because: ------- You are on the CC list for the bug. From bugzilla at redhat.com Tue Aug 12 02:10:02 2008 From: bugzilla at redhat.com (bugzilla at redhat.com) Date: Mon, 11 Aug 2008 22:10:02 -0400 Subject: [publican-list] [Bug 458743] New: different html single from make srpm Message-ID: Please do not reply directly to this email. All additional comments should be made in the comments box of this bug. Summary: different html single from make srpm https://bugzilla.redhat.com/show_bug.cgi?id=458743 Summary: different html single from make srpm Product: Red Hat Enterprise Linux 5 Version: 5.2 Platform: All OS/Version: Linux Status: NEW Severity: medium Priority: medium Component: publican AssignedTo: jfearn at redhat.com ReportedBy: ccurran at redhat.com QAContact: mhideo at redhat.com CC: publican-list at redhat.com Estimated Hours: 0.0 Classification: Red Hat Description of problem: make old_srpm2 seems to generate different html-single output Version-Release number of selected component (if applicable): How reproducible: Steps to Reproduce: 1. 2. 3. Actual results: Expected results: Additional info: -- Configure bugmail: https://bugzilla.redhat.com/userprefs.cgi?tab=email ------- You are receiving this mail because: ------- You are on the CC list for the bug. From bugzilla at redhat.com Tue Aug 12 04:51:00 2008 From: bugzilla at redhat.com (bugzilla at redhat.com) Date: Tue, 12 Aug 2008 00:51:00 -0400 Subject: [publican-list] [Bug 458740] error 6 in building translated html In-Reply-To: References: Message-ID: <200808120451.m7C4p0WQ023273@bz-web2.app.phx.redhat.com> Please do not reply directly to this email. All additional comments should be made in the comments box of this bug. https://bugzilla.redhat.com/show_bug.cgi?id=458740 Jeff Fearn changed: What |Removed |Added ---------------------------------------------------------------------------- Status|NEW |CLOSED Fixed In Version| |0.35 Resolution| |CURRENTRELEASE --- Comment #1 from Jeff Fearn 2008-08-12 00:50:59 EDT --- Changed to match on $(XML_LANG)/*.xml -- Configure bugmail: https://bugzilla.redhat.com/userprefs.cgi?tab=email ------- You are receiving this mail because: ------- You are on the CC list for the bug. From bugzilla at redhat.com Tue Aug 12 05:00:18 2008 From: bugzilla at redhat.com (bugzilla at redhat.com) Date: Tue, 12 Aug 2008 01:00:18 -0400 Subject: [publican-list] [Bug 458743] different html single from make srpm In-Reply-To: References: Message-ID: <200808120500.m7C50IrR010076@bz-web1.app.phx.redhat.com> Please do not reply directly to this email. All additional comments should be made in the comments box of this bug. https://bugzilla.redhat.com/show_bug.cgi?id=458743 Jeff Fearn changed: What |Removed |Added ---------------------------------------------------------------------------- Status|NEW |CLOSED Fixed In Version| |0.35 Resolution| |CURRENTRELEASE --- Comment #1 from Jeff Fearn 2008-08-12 01:00:17 EDT --- Changed Makefile-RedHat to use html-desktop. -- Configure bugmail: https://bugzilla.redhat.com/userprefs.cgi?tab=email ------- You are receiving this mail because: ------- You are on the CC list for the bug. From bugzilla at redhat.com Tue Aug 12 05:07:36 2008 From: bugzilla at redhat.com (bugzilla at redhat.com) Date: Tue, 12 Aug 2008 01:07:36 -0400 Subject: [publican-list] [Bug 458764] New: Updates for documentation Message-ID: Please do not reply directly to this email. All additional comments should be made in the comments box of this bug. Summary: Updates for documentation https://bugzilla.redhat.com/show_bug.cgi?id=458764 Summary: Updates for documentation Product: Fedora Version: rawhide Platform: All OS/Version: Linux Status: NEW Severity: medium Priority: medium Component: publican AssignedTo: jfearn at redhat.com ReportedBy: jfearn at redhat.com QAContact: extras-qa at fedoraproject.org CC: mmcallis at redhat.com, publican-list at redhat.com Estimated Hours: 0.0 Classification: Fedora Updates for the documentation: Revision History: Make will search for the first XML file in the $(XML_LANG) directory containing a revhistory tag. Publican will use that file to build the rpm revision history from. Revision History: All dates must be in the correct RPM format, other formats will break the spec file creation. e.g. Mon Aug 4 2008 VERSION: Can only contain 'a-z', 'A-Z', '0-9' or '.', this is to ensure valid RPM names. This tag is processed before XSLT transactions and so can not contain an entity. REVISION: Can only contain 'a-z', 'A-Z', '0-9' or '.', this is to ensure valid RPM names. This tag is processed before XSLT transactions and so can not contain an entity. PRODUCT: Can only contain 'a-z', 'A-Z' or '_', this is to ensure valid RPM names. DOCNAME: Can only contain 'a-z', 'A-Z' or '_', this is to ensure valid RPM names. -- Configure bugmail: https://bugzilla.redhat.com/userprefs.cgi?tab=email ------- You are receiving this mail because: ------- You are on the CC list for the bug. From bugzilla at redhat.com Fri Aug 15 02:30:45 2008 From: bugzilla at redhat.com (bugzilla at redhat.com) Date: Thu, 14 Aug 2008 22:30:45 -0400 Subject: [publican-list] [Bug 458618] make commands hang after re-installing publican In-Reply-To: References: Message-ID: <200808150230.m7F2Ujbh031582@bz-web1.app.phx.redhat.com> Please do not reply directly to this email. All additional comments should be made in the comments box of this bug. https://bugzilla.redhat.com/show_bug.cgi?id=458618 Jeff Fearn changed: What |Removed |Added ---------------------------------------------------------------------------- Status|NEW |CLOSED Resolution| |DUPLICATE --- Comment #1 from Jeff Fearn 2008-08-14 22:30:44 EDT --- *** This bug has been marked as a duplicate of 458709 *** -- Configure bugmail: https://bugzilla.redhat.com/userprefs.cgi?tab=email ------- You are receiving this mail because: ------- You are on the CC list for the bug. From bugzilla at redhat.com Fri Aug 15 03:01:06 2008 From: bugzilla at redhat.com (bugzilla at redhat.com) Date: Thu, 14 Aug 2008 23:01:06 -0400 Subject: [publican-list] [Bug 459216] JBoss common content Conventions.xml refers to a competing product in example In-Reply-To: References: Message-ID: <200808150301.m7F316Ls003430@bz-web1.app.phx.redhat.com> Please do not reply directly to this email. All additional comments should be made in the comments box of this bug. https://bugzilla.redhat.com/show_bug.cgi?id=459216 Jeff Fearn changed: What |Removed |Added ---------------------------------------------------------------------------- Status|NEW |ASSIGNED Version|rawhide |5.3 CC| |publican-list at redhat.com Component|publican |publican AssignedTo|jfearn at redhat.com |mhideo at redhat.com Customer Facing| |--- Product|Fedora |Red Hat Enterprise Linux 5 QAContact|extras-qa at fedoraproject.org |mhideo at redhat.com -- Configure bugmail: https://bugzilla.redhat.com/userprefs.cgi?tab=email ------- You are receiving this mail because: ------- You are on the CC list for the bug. From jfearn at redhat.com Mon Aug 18 05:37:10 2008 From: jfearn at redhat.com (Jeff Fearn) Date: Mon, 18 Aug 2008 15:37:10 +1000 Subject: [publican-list] Proposed changes to Book_Info.xml In-Reply-To: <1218482801.4118.29.camel@calliope.phig.org> References: <4897FFD0.4040600@redhat.com> <48983E53.8000102@redhat.com> <489A3005.1060503@redhat.com> <489A6D2D.8070508@redhat.com> <489A8132.9010009@redhat.com> <1218482801.4118.29.camel@calliope.phig.org> Message-ID: <48A90A86.1020108@redhat.com> So after chatting with people about this here is the new, new plan! ;) My Guide The Product 5.2 1 0 Where: title: is the books title productname: is the products name productnumber: is the products version edition: is the edition (X.Y) pubsnumber: is the revision of this edition (Z) The Layout would roughly be: Product Name Product Version* Title Subtitle* edition.pubsnumber * = not mandatory This gives us the ability to distinguish between major (X), minor (Y) and maintenance (Z) updates to documentation. One of the main reasons for going to X.Y.Z is to allow translations to be updated independently of each other. So for any edition X.Y of a book, all translations have the same X.Y, but Z is independent for each and every language. I'm currently working out with translators how best to allow them to set their own Z. All comments and doughnuts gratefully received! Cheers, Jeff. -- Jeff Fearn Software Engineer Engineering Operations Red Hat, Inc Freedom ... courage ... Commitment ... ACCOUNTABILITY From mhideo at redhat.com Mon Aug 18 22:13:16 2008 From: mhideo at redhat.com (Michael Hideo-Smith) Date: Mon, 18 Aug 2008 18:13:16 -0400 (EDT) Subject: [publican-list] Proposed changes to Book_Info.xml In-Reply-To: <48A90A86.1020108@redhat.com> Message-ID: <1812238271.2735481219097596319.JavaMail.root@zmail01.collab.prod.int.phx2.redhat.com> ----- "Jeff Fearn" wrote: > From: "Jeff Fearn" > To: "publican" > Sent: Monday, August 18, 2008 3:37:10 PM GMT +10:00 Brisbane > Subject: Re: [publican-list] Proposed changes to Book_Info.xml > > So after chatting with people about this here is the new, new plan! > ;) > > > My Guide > The Product > 5.2 > 1 > 0 > > > > Where: > > title: is the books title > productname: is the products name > productnumber: is the products version > edition: is the edition (X.Y) > pubsnumber: is the revision of this edition (Z) > > > The Layout would roughly be: > > Product Name Product Version* > Title > Subtitle* > edition.pubsnumber > > * = not mandatory > > This gives us the ability to distinguish between major (X), minor (Y) > and maintenance (Z) updates to documentation. > > One of the main reasons for going to X.Y.Z is to allow translations to > be updated independently of each other. So for any edition X.Y of a > book, all translations have the same X.Y, but Z is independent for > each and every language. > > I'm currently working out with translators how best to allow them to > set their own Z. > > All comments and doughnuts gratefully received! > +1 From kwade at redhat.com Mon Aug 18 23:05:43 2008 From: kwade at redhat.com (Karsten 'quaid' Wade) Date: Mon, 18 Aug 2008 16:05:43 -0700 Subject: [publican-list] Proposed changes to Book_Info.xml In-Reply-To: <48A90A86.1020108@redhat.com> References: <4897FFD0.4040600@redhat.com> <48983E53.8000102@redhat.com> <489A3005.1060503@redhat.com> <489A6D2D.8070508@redhat.com> <489A8132.9010009@redhat.com> <1218482801.4118.29.camel@calliope.phig.org> <48A90A86.1020108@redhat.com> Message-ID: <1219100743.7342.28.camel@calliope.phig.org> On Mon, 2008-08-18 at 15:37 +1000, Jeff Fearn wrote: > I'm currently working out with translators how best to allow them to > set their own Z. > > All comments and doughnuts gratefully received! Doughnuts all around! I especially like the Z for translation. - k' -- Karsten Wade, Sr. Developer Community Mgr. Dev Fu : http://developer.redhatmagazine.com Fedora : http://quaid.fedorapeople.org gpg key : AD0E0C41 -------------- next part -------------- A non-text attachment was scrubbed... Name: signature.asc Type: application/pgp-signature Size: 189 bytes Desc: This is a digitally signed message part URL: From stickster at gmail.com Tue Aug 19 00:14:06 2008 From: stickster at gmail.com (Paul W. Frields) Date: Mon, 18 Aug 2008 20:14:06 -0400 Subject: [publican-list] Proposed changes to Book_Info.xml In-Reply-To: <1219100743.7342.28.camel@calliope.phig.org> References: <4897FFD0.4040600@redhat.com> <48983E53.8000102@redhat.com> <489A3005.1060503@redhat.com> <489A6D2D.8070508@redhat.com> <489A8132.9010009@redhat.com> <1218482801.4118.29.camel@calliope.phig.org> <48A90A86.1020108@redhat.com> <1219100743.7342.28.camel@calliope.phig.org> Message-ID: <1219104846.25510.160.camel@victoria> On Mon, 2008-08-18 at 16:05 -0700, Karsten 'quaid' Wade wrote: > On Mon, 2008-08-18 at 15:37 +1000, Jeff Fearn wrote: > > > I'm currently working out with translators how best to allow them to > > set their own Z. > > > > All comments and doughnuts gratefully received! > > Doughnuts all around! I especially like the Z for translation. +1. -- Paul W. Frields gpg fingerprint: 3DA6 A0AC 6D58 FEC4 0233 5906 ACDB C937 BD11 3717 http://paul.frields.org/ - - http://pfrields.fedorapeople.org/ irc.freenode.net: stickster @ #fedora-docs, #fedora-devel, #fredlug -------------- next part -------------- A non-text attachment was scrubbed... Name: signature.asc Type: application/pgp-signature Size: 189 bytes Desc: This is a digitally signed message part URL: From jfearn at redhat.com Wed Aug 20 04:53:37 2008 From: jfearn at redhat.com (Jeff Fearn) Date: Wed, 20 Aug 2008 14:53:37 +1000 Subject: [publican-list] Proposed changes to Book_Info.xml In-Reply-To: <4897FFD0.4040600@redhat.com> References: <4897FFD0.4040600@redhat.com> Message-ID: <48ABA351.7020903@redhat.com> One last change for the Info file format. Since the RPM requires a summary field, subtitle will be compulsory since this is the field we will use to populate the summary with. e.g. From the publican Users Guide: in Book_Info.xml: Users Guide Publishing books, articles, papers and multi-volume sets with DocBook XML Publican 1.0 12 0 This book will help you install publican. It also provides instructions for using publican to create and publish DocBook XML-based books, articles and book-sets. This guide assumes you are already familiar with DocBook XML. The RPM Info: [jfearn at obelisk docs]$ rpm -qip tmp/rpm/SRPMS/Publican-Users_Guide-1.0-web-en-US-12-0.src.rpm Name : Publican-Users_Guide-1.0-web-en-US Relocations: (not relocatable) Version : 12 Vendor: (none) Release : 0 Build Date: Wed 20 Aug 2008 02:12:01 PM EST Install Date: (not installed) Build Host: foo.redhat.com Group : Documentation Source RPM: (none) Size : 86580 License: OPL + Restrictions Signature : (none) URL : http://www.redhat.com/docs Summary : Publishing books, articles, papers and multi-volume sets with DocBook XML Description : This book will help you install publican. It also provides instructions for using publican to create and publish DocBook XML-based books, articles and book-sets. This guide assumes you are already familiar with DocBook XML. Cheers, Jeff. -- Jeff Fearn Software Engineer Engineering Operations Red Hat, Inc Freedom ... courage ... Commitment ... ACCOUNTABILITY From bugzilla at redhat.com Thu Aug 21 01:22:53 2008 From: bugzilla at redhat.com (bugzilla at redhat.com) Date: Wed, 20 Aug 2008 21:22:53 -0400 Subject: [publican-list] [Bug 459671] New: RFE: please support menuchoice tag Message-ID: Please do not reply directly to this email. All additional comments should be made in the comments box of this bug. Summary: RFE: please support menuchoice tag https://bugzilla.redhat.com/show_bug.cgi?id=459671 Summary: RFE: please support menuchoice tag Product: Red Hat Enterprise Linux 5 Version: 5.2 Platform: All OS/Version: Linux Status: NEW Severity: low Priority: low Component: publican AssignedTo: jfearn at redhat.com ReportedBy: mmcallis at redhat.com QAContact: mhideo at redhat.com CC: publican-list at redhat.com Estimated Hours: 0.0 Classification: Red Hat Description of problem: ApplicationsSystem ToolsTerminal Result: WARNING: Unknown tag: menuchoice. This tag may not be displayed correctly This renders fine. Please remove the warning. -- Configure bugmail: https://bugzilla.redhat.com/userprefs.cgi?tab=email ------- You are receiving this mail because: ------- You are on the CC list for the bug. From bugzilla at redhat.com Thu Aug 21 01:38:26 2008 From: bugzilla at redhat.com (bugzilla at redhat.com) Date: Wed, 20 Aug 2008 21:38:26 -0400 Subject: [publican-list] [Bug 459671] RFE: please support menuchoice tag In-Reply-To: References: Message-ID: <200808210138.m7L1cQeL003391@bz-web1.app.phx.redhat.com> Please do not reply directly to this email. All additional comments should be made in the comments box of this bug. https://bugzilla.redhat.com/show_bug.cgi?id=459671 --- Comment #2 from Jeff Fearn 2008-08-20 21:38:25 EDT --- Please also confirm that the HTML and HTML-OUTPUTS pass xhtml 1.0 Strict checks :) -- Configure bugmail: https://bugzilla.redhat.com/userprefs.cgi?tab=email ------- You are receiving this mail because: ------- You are on the CC list for the bug. From bugzilla at redhat.com Thu Aug 21 01:36:43 2008 From: bugzilla at redhat.com (bugzilla at redhat.com) Date: Wed, 20 Aug 2008 21:36:43 -0400 Subject: [publican-list] [Bug 459671] RFE: please support menuchoice tag In-Reply-To: References: Message-ID: <200808210136.m7L1ahb9003130@bz-web1.app.phx.redhat.com> Please do not reply directly to this email. All additional comments should be made in the comments box of this bug. https://bugzilla.redhat.com/show_bug.cgi?id=459671 Jeff Fearn changed: What |Removed |Added ---------------------------------------------------------------------------- Status|NEW |ASSIGNED --- Comment #1 from Jeff Fearn 2008-08-20 21:36:42 EDT --- Please confirm that this renders correctly in PDF, HTML and HTML-SINGLE outputs. -- Configure bugmail: https://bugzilla.redhat.com/userprefs.cgi?tab=email ------- You are receiving this mail because: ------- You are on the CC list for the bug. From bugzilla at redhat.com Mon Aug 25 01:58:24 2008 From: bugzilla at redhat.com (bugzilla at redhat.com) Date: Sun, 24 Aug 2008 21:58:24 -0400 Subject: [publican-list] [Bug 447825] Need a plugin for the ovirt brand for oVirt docs In-Reply-To: References: Message-ID: <200808250158.m7P1wOr9028919@bz-web1.app.phx.redhat.com> Please do not reply directly to this email. All additional comments should be made in the comments box of this bug. https://bugzilla.redhat.com/show_bug.cgi?id=447825 Jeff Fearn changed: What |Removed |Added ---------------------------------------------------------------------------- Status|ASSIGNED |CLOSED CC| |jfearn at redhat.com Fixed In Version| |0.35 Resolution| |CURRENTRELEASE -- Configure bugmail: https://bugzilla.redhat.com/userprefs.cgi?tab=email ------- You are receiving this mail because: ------- You are on the CC list for the bug. From bugzilla at redhat.com Mon Aug 25 04:42:57 2008 From: bugzilla at redhat.com (bugzilla at redhat.com) Date: Mon, 25 Aug 2008 00:42:57 -0400 Subject: [publican-list] [Bug 459951] New: Author group CSS is horrible in html single Message-ID: Please do not reply directly to this email. All additional comments should be made in the comments box of this bug. Summary: Author group CSS is horrible in html single https://bugzilla.redhat.com/show_bug.cgi?id=459951 Summary: Author group CSS is horrible in html single Product: Red Hat Enterprise Linux 5 Version: 5.2 Platform: All OS/Version: Linux Status: NEW Severity: high Priority: medium Component: publican AssignedTo: jfearn at redhat.com ReportedBy: ccurran at redhat.com QAContact: ccurran at redhat.com CC: publican-list at redhat.com Estimated Hours: 0.0 Classification: Red Hat Description of problem: The spacing and css markup are horrible. Technical editors are jammed up under the second author. Version-Release number of selected component (if applicable): How reproducible: Steps to Reproduce: 1. Pull down the virtualization guide. 2. Build html single. 3. Actual results: Expected results: something a bit cleaner and more readable. Additional info: -- Configure bugmail: https://bugzilla.redhat.com/userprefs.cgi?tab=email ------- You are receiving this mail because: ------- You are on the CC list for the bug. From bugzilla at redhat.com Mon Aug 25 04:50:07 2008 From: bugzilla at redhat.com (bugzilla at redhat.com) Date: Mon, 25 Aug 2008 00:50:07 -0400 Subject: [publican-list] [Bug 459953] New: html-single numbering missing Message-ID: Please do not reply directly to this email. All additional comments should be made in the comments box of this bug. Summary: html-single numbering missing https://bugzilla.redhat.com/show_bug.cgi?id=459953 Summary: html-single numbering missing Product: Red Hat Enterprise Linux 5 Version: 5.2 Platform: All OS/Version: Linux Status: NEW Severity: medium Priority: medium Component: publican AssignedTo: jfearn at redhat.com ReportedBy: ccurran at redhat.com QAContact: mhideo at redhat.com CC: publican-list at redhat.com Estimated Hours: 0.0 Classification: Red Hat Description of problem: Numbering is missing from section, chapter and other headings and titles for most tags. Numbering present in the table of contents and xrefs are not repeated in the titles they reference. Some link to numbers which are not present I suggest implementing numbering the same as the html version. Version-Release number of selected component (if applicable): How reproducible: Check out any RHEL branded book and build html-single. Steps to Reproduce: 1. 2. 3. Actual results: Expected results: Additional info: -- Configure bugmail: https://bugzilla.redhat.com/userprefs.cgi?tab=email ------- You are receiving this mail because: ------- You are on the CC list for the bug. From bugzilla at redhat.com Mon Aug 25 04:57:30 2008 From: bugzilla at redhat.com (bugzilla at redhat.com) Date: Mon, 25 Aug 2008 00:57:30 -0400 Subject: [publican-list] [Bug 459953] html-single numbering missing In-Reply-To: References: Message-ID: <200808250457.m7P4vUTw017570@bz-web1.app.phx.redhat.com> Please do not reply directly to this email. All additional comments should be made in the comments box of this bug. https://bugzilla.redhat.com/show_bug.cgi?id=459953 Lana Brindley changed: What |Removed |Added ---------------------------------------------------------------------------- CC| |lbrindle at redhat.com --- Comment #1 from Lana Brindley 2008-08-25 00:57:29 EDT --- Bullets are missing from also. LKB -- Configure bugmail: https://bugzilla.redhat.com/userprefs.cgi?tab=email ------- You are receiving this mail because: ------- You are on the CC list for the bug. From bugzilla at redhat.com Tue Aug 26 02:08:21 2008 From: bugzilla at redhat.com (bugzilla at redhat.com) Date: Mon, 25 Aug 2008 22:08:21 -0400 Subject: [publican-list] [Bug 459951] Author group CSS is horrible in html single In-Reply-To: References: Message-ID: <200808260208.m7Q28LAC014601@bz-web1.app.phx.redhat.com> Please do not reply directly to this email. All additional comments should be made in the comments box of this bug. https://bugzilla.redhat.com/show_bug.cgi?id=459951 Jeff Fearn changed: What |Removed |Added ---------------------------------------------------------------------------- Status|NEW |CLOSED Fixed In Version| |0.35 Resolution| |CURRENTRELEASE --- Comment #1 from Jeff Fearn 2008-08-25 22:08:21 EDT --- The layout was changed late last week. Which is lucky because this bug report is so bad I'd have closed this bug WONTFIX USELESS_INFO -- Configure bugmail: https://bugzilla.redhat.com/userprefs.cgi?tab=email ------- You are receiving this mail because: ------- You are on the CC list for the bug. From bugzilla at redhat.com Tue Aug 26 05:27:58 2008 From: bugzilla at redhat.com (bugzilla at redhat.com) Date: Tue, 26 Aug 2008 01:27:58 -0400 Subject: [publican-list] [Bug 459953] html-single numbering missing In-Reply-To: References: Message-ID: <200808260527.m7Q5RwCi010171@bz-web1.app.phx.redhat.com> Please do not reply directly to this email. All additional comments should be made in the comments box of this bug. https://bugzilla.redhat.com/show_bug.cgi?id=459953 Jeff Fearn changed: What |Removed |Added ---------------------------------------------------------------------------- Status|NEW |CLOSED Fixed In Version| |0.35 Resolution| |CURRENTRELEASE -- Configure bugmail: https://bugzilla.redhat.com/userprefs.cgi?tab=email ------- You are receiving this mail because: ------- You are on the CC list for the bug. From bugzilla at redhat.com Tue Aug 26 06:29:02 2008 From: bugzilla at redhat.com (bugzilla at redhat.com) Date: Tue, 26 Aug 2008 02:29:02 -0400 Subject: [publican-list] [Bug 458764] Updates for documentation In-Reply-To: References: Message-ID: <200808260629.m7Q6T2Rc016126@bz-web2.app.phx.redhat.com> Please do not reply directly to this email. All additional comments should be made in the comments box of this bug. https://bugzilla.redhat.com/show_bug.cgi?id=458764 Jeff Fearn changed: What |Removed |Added ---------------------------------------------------------------------------- Status|NEW |CLOSED Fixed In Version| |0.35 Resolution| |CURRENTRELEASE -- Configure bugmail: https://bugzilla.redhat.com/userprefs.cgi?tab=email ------- You are receiving this mail because: ------- You are on the CC list for the bug. From bugzilla at redhat.com Wed Aug 27 14:12:34 2008 From: bugzilla at redhat.com (bugzilla at redhat.com) Date: Wed, 27 Aug 2008 10:12:34 -0400 Subject: [publican-list] [Bug 460268] publican-ovirt license In-Reply-To: References: Message-ID: <200808271412.m7RECYb7002115@bz-web1.app.phx.redhat.com> Please do not reply directly to this email. All additional comments should be made in the comments box of this bug. https://bugzilla.redhat.com/show_bug.cgi?id=460268 Daniel Berrange changed: What |Removed |Added ---------------------------------------------------------------------------- CC| |berrange at redhat.com -- Configure bugmail: https://bugzilla.redhat.com/userprefs.cgi?tab=email ------- You are receiving this mail because: ------- You are on the CC list for the bug. From bugzilla at redhat.com Thu Aug 28 03:55:22 2008 From: bugzilla at redhat.com (bugzilla at redhat.com) Date: Wed, 27 Aug 2008 23:55:22 -0400 Subject: [publican-list] [Bug 459216] JBoss common content Conventions.xml refers to a competing product in example In-Reply-To: References: Message-ID: <200808280355.m7S3tMcm013060@bz-web1.app.phx.redhat.com> Please do not reply directly to this email. All additional comments should be made in the comments box of this bug. https://bugzilla.redhat.com/show_bug.cgi?id=459216 Jeff Fearn changed: What |Removed |Added ---------------------------------------------------------------------------- Status|ASSIGNED |CLOSED CC| |jfearn at redhat.com Fixed In Version| |0.35 Resolution| |CURRENTRELEASE --- Comment #1 from Jeff Fearn 2008-08-27 23:55:21 EDT --- Conventions.xml has been completely re-written for version 0.35, controversy has been removed. -- Configure bugmail: https://bugzilla.redhat.com/userprefs.cgi?tab=email ------- You are receiving this mail because: ------- You are on the CC list for the bug. From bugzilla at redhat.com Thu Aug 28 04:00:00 2008 From: bugzilla at redhat.com (bugzilla at redhat.com) Date: Thu, 28 Aug 2008 00:00:00 -0400 Subject: [publican-list] [Bug 459671] RFE: please support menuchoice tag In-Reply-To: References: Message-ID: <200808280400.m7S4009j003209@bz-web2.app.phx.redhat.com> Please do not reply directly to this email. All additional comments should be made in the comments box of this bug. https://bugzilla.redhat.com/show_bug.cgi?id=459671 Jeff Fearn changed: What |Removed |Added ---------------------------------------------------------------------------- Flag|needinfo?(mmcallis at redhat.c |needinfo+ |om) | -- Configure bugmail: https://bugzilla.redhat.com/userprefs.cgi?tab=email ------- You are receiving this mail because: ------- You are on the CC list for the bug.