From bugzilla at redhat.com Thu Jul 2 06:02:35 2009
From: bugzilla at redhat.com (bugzilla at redhat.com)
Date: Thu, 2 Jul 2009 02:02:35 -0400
Subject: [publican-list] [Bug 509307] New: remarks in
s are not
consistently highlighted in pdfs
Message-ID:
Please do not reply directly to this email. All additional
comments should be made in the comments box of this bug.
Summary: remarks in s are not consistently highlighted in pdfs
https://bugzilla.redhat.com/show_bug.cgi?id=509307
Summary: remarks in s are not consistently highlighted
in pdfs
Product: Red Hat Enterprise Linux 5
Version: 5.2
Platform: All
OS/Version: Linux
Status: NEW
Severity: medium
Priority: low
Component: publican
AssignedTo: mhideo at redhat.com
ReportedBy: dmison at redhat.com
QAContact: ecs-dev-list at redhat.com
CC: publican-list at redhat.com
Classification: Red Hat
Target Release: ---
Description of problem:
adding remarks to tags, specifically for and do not
always have the expected highlighting in all the places they occur
This worked in 0.44
I'd modified my /usr/share/publican/xsl/pdf.xsl file as per BZ 491782 prior to
upgrading to 0.45, so when I upgraded to 0.45 I probably still had the 0.44
pdf.xsl
I uninstalled publican & reinstalled it on the 29th of June to verify that the
current version still had BZ 491782, which is probably the first time I got the
0.45 pdf.xsl
Version-Release number of selected component (if applicable):
publican-doc-0.45-0.el5
publican-ovirt-0.7-0.el5
publican-jboss-0.19-0.el5
publican-0.45-0.el5
publican-WebSite-obsoletes-1.03-1.el5
publican-redhat-0.19-0.el5
publican-gimp-0.5-2.el5
publican-fedora-0.18-0.el5
How reproducible:
any pdf, does not occur in html or html-single output
Steps to Reproduce:
1. add a remark to a chapter title, eg.
UPDATEDchapter X
2. add a remark to a section title, eg.
UPDATEDsection Y
3. add SHOW_REMARKS = 1 to the Makefile
4. make clean pdf-en-US
Actual results:
remarks in chapter titles as not highlighted in the page content (ie when the
title appears at the start of a chapter)
Expected results:
both chapter & section title remarks are highlighted
- in the table of contents
- as they occur in page content
- in page headers
Additional info:
Publican 0.44 on Fedora 11 (plus xslthl package) has a similar problem with the
additional problem that no highlighting appears at all in the table of contents
--
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 Jul 2 06:12:57 2009
From: bugzilla at redhat.com (bugzilla at redhat.com)
Date: Thu, 2 Jul 2009 02:12:57 -0400
Subject: [publican-list] [Bug 509307] remarks in s are not
consistently highlighted in pdfs
In-Reply-To:
References:
Message-ID: <200907020612.n626Cvr3009319@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=509307
--- Comment #1 from Darrin Mison 2009-07-02 02:12:56 EDT ---
Note the ability to have highlighted remarks in chapter/section titles that
appear in all three places is important to the SOA QE team's process for being
able to quickly QE the product docs.
--
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 mhideo at redhat.com Sun Jul 5 23:01:03 2009
From: mhideo at redhat.com (Michael Hideo)
Date: Mon, 06 Jul 2009 09:01:03 +1000
Subject: [publican-list] Publican 1.0
Message-ID: <4A5130AF.9000408@redhat.com>
Folks,
This is a heads up email for the plan to begin testing Publican 1.0 on
Fedora.
These are the actions we are looking at right now to begin alpha testing
the software:
F12 Guides
==========
* Installation Guide
* Security Guide
* Deployment Guide
* Virtualization Guide
* Release Notes
We will need someone from l10n to check that the translations come out
cleanly. Additionally, we will need a dedicated person to do QE against
the new bugs and to regression test against the old bugs. Also we need
someone to work between l10n and QE to ensure that all the langs still
build correctly.
A few other activities that need to performed:
* Brands need to be repackaged (cc-by-sa for fedora/rh)
* Need to start a lock on the test repos
Rough timeline is sometime in the next 2 weeks. Note that the publican
software has been completely re-written from the ground up. Apparently
it will not use a "make" system but will use proper commands and
actions. This will provide more flexibility for the future and allow us
to be cross platform.
More timelines and infotainment to come shortly.
- Mike
From bugzilla at redhat.com Mon Jul 6 01:55:18 2009
From: bugzilla at redhat.com (bugzilla at redhat.com)
Date: Sun, 5 Jul 2009 21:55:18 -0400
Subject: [publican-list] [Bug 509768] New: fix for no rounded corners in
html output when viewed in Safari
Message-ID:
Please do not reply directly to this email. All additional
comments should be made in the comments box of this bug.
Summary: fix for no rounded corners in html output when viewed in Safari
https://bugzilla.redhat.com/show_bug.cgi?id=509768
Summary: fix for no rounded corners in html output when viewed
in Safari
Product: Red Hat Enterprise Linux 5
Version: 5.2
Platform: All
OS/Version: Linux
Status: NEW
Severity: medium
Priority: low
Component: publican
AssignedTo: mhideo at redhat.com
ReportedBy: dmison at redhat.com
QAContact: ecs-dev-list at redhat.com
CC: publican-list at redhat.com
Classification: Red Hat
Target Release: ---
Description of problem:
The html output of and do not appear with rounded
corners in Safari (and other webkit browsers I guess), only in Firefox.
FIX: the addition of the evil webkit-border-radius css attribute in the same
manner as the evil moz-border-radius attribute in common.css
eg:
/* Dirty EVIL Mozilla hack for round corners */
and double-plus EVIL webkit hack */
pre {
-moz-border-radius:11px;
-webkit-border-radius:11px;
}
.example {
-moz-border-radius:15px;
-webkit-border-radius:15px;
}
Version-Release number of selected component (if applicable):
0.45
--
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 Jul 6 02:53:10 2009
From: bugzilla at redhat.com (bugzilla at redhat.com)
Date: Sun, 5 Jul 2009 22:53:10 -0400
Subject: [publican-list] [Bug 509768] fix for no rounded corners in html
output when viewed in Safari
In-Reply-To:
References:
Message-ID: <200907060253.n662rArW002772@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=509768
Jeff Fearn changed:
What |Removed |Added
----------------------------------------------------------------------------
CC| |jfearn at redhat.com
--- Comment #1 from Jeff Fearn 2009-07-05 22:53:10 EDT ---
Also should have:
border-radius: 15px;
--
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 Jul 6 04:34:57 2009
From: bugzilla at redhat.com (bugzilla at redhat.com)
Date: Mon, 6 Jul 2009 00:34:57 -0400
Subject: [publican-list] [Bug 509768] fix for no rounded corners in html
output when viewed in Safari
In-Reply-To:
References:
Message-ID: <200907060434.n664YvS2021365@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=509768
--- Comment #2 from Darrin Mison 2009-07-06 00:34:56 EDT ---
oh, I didn't realise there was a non-evil method ;-)
--
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 Jul 6 08:30:43 2009
From: bugzilla at redhat.com (bugzilla at redhat.com)
Date: Mon, 6 Jul 2009 04:30:43 -0400
Subject: [publican-list] [Bug 509768] fix for no rounded corners in html
output when viewed in Safari
In-Reply-To:
References:
Message-ID: <200907060830.n668Uh4Z005602@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=509768
Issue Tracker changed:
What |Removed |Added
----------------------------------------------------------------------------
CC| |tao 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 jaredsmith at jaredsmith.net Wed Jul 8 22:31:30 2009
From: jaredsmith at jaredsmith.net (Jared Smith)
Date: Wed, 08 Jul 2009 18:31:30 -0400
Subject: [publican-list] Publican 1.0
In-Reply-To: <4A5130AF.9000408@redhat.com>
References: <4A5130AF.9000408@redhat.com>
Message-ID: <1247092290.26721.3.camel@hockey.jaredsmith.net>
On Mon, 2009-07-06 at 09:01 +1000, Michael Hideo wrote:
> This is a heads up email for the plan to begin testing Publican 1.0 on
> Fedora.
Publican 1.0?
> Rough timeline is sometime in the next 2 weeks.
I'd be happy to dedicate a few hours over the next two weeks to help
test.
> Note that the publican
> software has been completely re-written from the ground up. Apparently
> it will not use a "make" system but will use proper commands and
> actions. This will provide more flexibility for the future and allow us
> to be cross platform.
Wow... is the code freely available yet?
> More timelines and infotainment to come shortly.
Can't wait to hear more details.
-Jared
From rpjday at crashcourse.ca Thu Jul 9 14:07:37 2009
From: rpjday at crashcourse.ca (Robert P. J. Day)
Date: Thu, 9 Jul 2009 10:07:37 -0400 (EDT)
Subject: [publican-list] does publican have a drop-down menu entry in f11?
Message-ID:
perhaps not the best place to ask this but, after i install publican
on my f11 system, should i expect to see it somewhere under, perhaps,
"applications", maybe under "office"? or is it not set up to install
a menu entry?
rday
--
========================================================================
Robert P. J. Day Waterloo, Ontario, CANADA
Linux Consulting, Training and Annoying Kernel Pedantry.
Web page: http://crashcourse.ca
Linked In: http://www.linkedin.com/in/rpjday
Twitter: http://twitter.com/rpjday
========================================================================
From jfearn at redhat.com Thu Jul 9 22:56:45 2009
From: jfearn at redhat.com (Jeffrey Fearn)
Date: Fri, 10 Jul 2009 08:56:45 +1000
Subject: [publican-list] does publican have a drop-down menu entry in f11?
In-Reply-To:
References:
Message-ID: <4A5675AD.5090609@redhat.com>
Robert P. J. Day wrote:
> perhaps not the best place to ask this but, after i install publican
> on my f11 system, should i expect to see it somewhere under, perhaps,
> "applications", maybe under "office"? or is it not set up to install
> a menu entry?
Hi Robert, publican is a CLI tool. The only entry it makes is if you
install the docs package it makes an entry under System->Documentation.
Cheers, Jeff.
--
Jeff Fearn
Software Engineer
Engineering Operations
Red Hat, Inc
Freedom ... courage ... Commitment ... ACCOUNTABILITY
http://file.bne.redhat.com/~jfearn/
From jfearn at redhat.com Thu Jul 9 23:37:16 2009
From: jfearn at redhat.com (Jeffrey Fearn)
Date: Fri, 10 Jul 2009 09:37:16 +1000
Subject: [publican-list] Publican 1.0
In-Reply-To: <1247092290.26721.3.camel@hockey.jaredsmith.net>
References: <4A5130AF.9000408@redhat.com>
<1247092290.26721.3.camel@hockey.jaredsmith.net>
Message-ID: <4A567F2C.7020904@redhat.com>
Jared Smith wrote:
> On Mon, 2009-07-06 at 09:01 +1000, Michael Hideo wrote:
>> This is a heads up email for the plan to begin testing Publican 1.0 on
>> Fedora.
>
> Publican 1.0?
>
>> Rough timeline is sometime in the next 2 weeks.
>
> I'd be happy to dedicate a few hours over the next two weeks to help
> test.
>
>> Note that the publican
>> software has been completely re-written from the ground up. Apparently
>> it will not use a "make" system but will use proper commands and
>> actions. This will provide more flexibility for the future and allow us
>> to be cross platform.
>
> Wow... is the code freely available yet?
Hi Jared, the code is not freely available yet. It will be in the repo
for the beat though.
Cheers, Jeff.
--
Jeff Fearn
Software Engineer
Engineering Operations
Red Hat, Inc
Freedom ... courage ... Commitment ... ACCOUNTABILITY
http://file.bne.redhat.com/~jfearn/
From jaredsmith at jaredsmith.net Thu Jul 9 23:51:53 2009
From: jaredsmith at jaredsmith.net (Jared Smith)
Date: Thu, 09 Jul 2009 19:51:53 -0400
Subject: [publican-list] Publican 1.0
In-Reply-To: <4A567F2C.7020904@redhat.com>
References: <4A5130AF.9000408@redhat.com>
<1247092290.26721.3.camel@hockey.jaredsmith.net>
<4A567F2C.7020904@redhat.com>
Message-ID: <1247183513.18600.6.camel@hockey.jaredsmith.net>
On Fri, 2009-07-10 at 09:37 +1000, Jeffrey Fearn wrote:
> Hi Jared, the code is not freely available yet. It will be in the repo
> for the beat though.
Thanks for the update.
I'm not sure what you mean by "in the repo for the beat". Which repo?
What do you mean by "for the beat"?
I'll try to be patient... but I can't wait to start trying it out.
Despite my (sometimes vocal) complaints about Publican, it's still a
pretty cool piece of software, and it makes me happy to hear that
development is moving forward. Thanks to everyone involved for their
hard work on it!
-Jared
From jfearn at redhat.com Thu Jul 9 23:59:42 2009
From: jfearn at redhat.com (Jeffrey Fearn)
Date: Fri, 10 Jul 2009 09:59:42 +1000
Subject: [publican-list] Publican 1.0
In-Reply-To: <1247183513.18600.6.camel@hockey.jaredsmith.net>
References: <4A5130AF.9000408@redhat.com>
<1247092290.26721.3.camel@hockey.jaredsmith.net>
<4A567F2C.7020904@redhat.com>
<1247183513.18600.6.camel@hockey.jaredsmith.net>
Message-ID: <4A56846E.2070009@redhat.com>
Jared Smith wrote:
> On Fri, 2009-07-10 at 09:37 +1000, Jeffrey Fearn wrote:
>> Hi Jared, the code is not freely available yet. It will be in the repo
>> for the beat though.
>
> Thanks for the update.
>
> I'm not sure what you mean by "in the repo for the beat". Which repo?
> What do you mean by "for the beat"?
I like to think my typos add "character" ... at least that is what I try
to tell myself!
The source code will be in the publican SVN repo for the beta.
Packages will be also made available, we haven't discussed how yet. We
want to do it so you can install the beta side by side with the current
packages so people can continue to do their work and test the new stuff
at the same time.
Cheers, Jeff.
--
Jeff Fearn
Software Engineer
Engineering Operations
Red Hat, Inc
Freedom ... courage ... Commitment ... ACCOUNTABILITY
http://file.bne.redhat.com/~jfearn/
From lbrindle at redhat.com Fri Jul 10 00:46:59 2009
From: lbrindle at redhat.com (Lana Brindley)
Date: Fri, 10 Jul 2009 10:46:59 +1000
Subject: [publican-list] Publican 1.0
In-Reply-To: <4A56846E.2070009@redhat.com>
References: <4A5130AF.9000408@redhat.com> <1247092290.26721.3.camel@hockey.jaredsmith.net> <4A567F2C.7020904@redhat.com> <1247183513.18600.6.camel@hockey.jaredsmith.net>
<4A56846E.2070009@redhat.com>
Message-ID: <4A568F83.6020203@redhat.com>
Jeffrey Fearn wrote:
> Jared Smith wrote:
>> On Fri, 2009-07-10 at 09:37 +1000, Jeffrey Fearn wrote:
>>> Hi Jared, the code is not freely available yet. It will be in the
>>> repo for the beat though.
>>
>> Thanks for the update.
>>
>> I'm not sure what you mean by "in the repo for the beat". Which repo?
>> What do you mean by "for the beat"?
>
> I like to think my typos add "character" ... at least that is what I try
> to tell myself!
>
> The source code will be in the publican SVN repo for the beta.
I kind of liked the sound of "in the repo for the beat".
I imagined Jeff wearing flouro yellow happy pants and carrying a massive
boom box while he said it ;)
L
-------------- next part --------------
A non-text attachment was scrubbed...
Name: lbrindle.vcf
Type: text/x-vcard
Size: 976 bytes
Desc: not available
URL:
From rpjday at crashcourse.ca Fri Jul 10 04:52:26 2009
From: rpjday at crashcourse.ca (Robert P. J. Day)
Date: Fri, 10 Jul 2009 00:52:26 -0400 (EDT)
Subject: [publican-list] and the repository is where?
Message-ID:
i've only used publican via the yum-installable package -- so
where's the svn repository? and while perusing the publican wiki page
here:
http://fedoraproject.org/wiki/DocsProject/Publican
i noticed that it continues to refer to F9 alpha, which seems a bit
out of date, and the name of the yum directory most of the way down
the page is given as "/etc/yum/yum.repos.d/", which doesn't sound
right.
rday
--
========================================================================
Robert P. J. Day Waterloo, Ontario, CANADA
Linux Consulting, Training and Annoying Kernel Pedantry.
Web page: http://crashcourse.ca
Linked In: http://www.linkedin.com/in/rpjday
Twitter: http://twitter.com/rpjday
========================================================================
From jwulf at redhat.com Fri Jul 10 05:05:08 2009
From: jwulf at redhat.com (Joshua Wulf)
Date: Fri, 10 Jul 2009 15:05:08 +1000
Subject: [publican-list] and the repository is where?
In-Reply-To:
References:
Message-ID: <4A56CC04.3090602@redhat.com>
svn repo linked from here: https://fedorahosted.org/publican/
On 07/10/2009 02:52 PM, Robert P. J. Day wrote:
> i've only used publican via the yum-installable package -- so
> where's the svn repository? and while perusing the publican wiki page
> here:
>
> http://fedoraproject.org/wiki/DocsProject/Publican
>
> i noticed that it continues to refer to F9 alpha, which seems a bit
> out of date, and the name of the yum directory most of the way down
> the page is given as "/etc/yum/yum.repos.d/", which doesn't sound
> right.
>
> rday
> --
>
> ========================================================================
> Robert P. J. Day Waterloo, Ontario, CANADA
>
> Linux Consulting, Training and Annoying Kernel Pedantry.
>
> Web page: http://crashcourse.ca
> Linked In: http://www.linkedin.com/in/rpjday
> Twitter: http://twitter.com/rpjday
> ========================================================================
>
> _______________________________________________
> publican-list mailing list
> publican-list at redhat.com
> https://www.redhat.com/mailman/listinfo/publican-list
> Wiki: https://fedorahosted.org/publican
>
--
Joshua J Wulf
Manager
Engineering Content Services
Red Hat Asia Pacific
eml: jwulf at redhat.com
tel: +61 7 3514-8140
cel: +61 431 929 675
From jfearn at redhat.com Fri Jul 10 05:07:29 2009
From: jfearn at redhat.com (Jeffrey Fearn)
Date: Fri, 10 Jul 2009 15:07:29 +1000
Subject: [publican-list] and the repository is where?
In-Reply-To:
References:
Message-ID: <4A56CC91.7020106@redhat.com>
Robert P. J. Day wrote:
> i've only used publican via the yum-installable package -- so
> where's the svn repository? and while perusing the publican wiki page
> here:
>
> http://fedoraproject.org/wiki/DocsProject/Publican
>
> i noticed that it continues to refer to F9 alpha, which seems a bit
> out of date, and the name of the yum directory most of the way down
> the page is given as "/etc/yum/yum.repos.d/", which doesn't sound
> right.
>
> rday
> --
>
> ========================================================================
> Robert P. J. Day Waterloo, Ontario, CANADA
>
> Linux Consulting, Training and Annoying Kernel Pedantry.
>
> Web page: http://crashcourse.ca
> Linked In: http://www.linkedin.com/in/rpjday
> Twitter: http://twitter.com/rpjday
> ========================================================================
>
> _______________________________________________
> publican-list mailing list
> publican-list at redhat.com
> https://www.redhat.com/mailman/listinfo/publican-list
> Wiki: https://fedorahosted.org/publican
The publican wiki is ^^^^^^^^^^^^^^^^^^^^
It has the SVN info.
I'm not sure what that fedora docs page is doing there ... it's far to
well written for me to have simply forgotten I wrote it some time in the
distant past :D
Cheers, Jeff.
--
Jeff Fearn
Software Engineer
Engineering Operations
Red Hat, Inc
Freedom ... courage ... Commitment ... ACCOUNTABILITY
http://file.bne.redhat.com/~jfearn/
From rpjday at crashcourse.ca Fri Jul 10 05:19:04 2009
From: rpjday at crashcourse.ca (Robert P. J. Day)
Date: Fri, 10 Jul 2009 01:19:04 -0400 (EDT)
Subject: [publican-list] and the repository is where?
In-Reply-To: <4A56CC91.7020106@redhat.com>
References:
<4A56CC91.7020106@redhat.com>
Message-ID:
On Fri, 10 Jul 2009, Jeffrey Fearn wrote:
> Robert P. J. Day wrote:
... snip ...
> > http://fedoraproject.org/wiki/DocsProject/Publican
> > Wiki: https://fedorahosted.org/publican
>
> The publican wiki is ^^^^^^^^^^^^^^^^^^^^
>
> It has the SVN info.
ah, gotcha.
> I'm not sure what that fedora docs page is doing there ... it's far
> to well written for me to have simply forgotten I wrote it some time
> in the distant past :D
might want to toss that older page, then. when i googled for
publican and repository, that's the one i ran across, and that might
throw a few folks who end up there the same way.
rday
--
========================================================================
Robert P. J. Day Waterloo, Ontario, CANADA
Linux Consulting, Training and Annoying Kernel Pedantry.
Web page: http://crashcourse.ca
Linked In: http://www.linkedin.com/in/rpjday
Twitter: http://twitter.com/rpjday
========================================================================
From rpjday at crashcourse.ca Fri Jul 10 06:16:58 2009
From: rpjday at crashcourse.ca (Robert P. J. Day)
Date: Fri, 10 Jul 2009 02:16:58 -0400 (EDT)
Subject: [publican-list] newbie observations on building publican from SVN
Message-ID:
from the perspective of someone who built publican from the repo for
the very first time a few minutes ago:
* the README file suggests i can get make help with one of "make help"
or "make help_params". neither of those targets seem to be supported.
* the build on a fully-updated f11 x86_64 system generates numerous
"... Legal_Notice.po MISSING Using en-US file" warnings. doesn't stop
the build, though.
* doing a straight "make" clearly attempts to *install* the
constructed rpm. that's kind of unusual, isn't it? i'm more used to
having to do that explicitly, with "make install". only after i
looked at the Makefile did i see the more limited "make rpm" target.
rday
--
========================================================================
Robert P. J. Day Waterloo, Ontario, CANADA
Linux Consulting, Training and Annoying Kernel Pedantry.
Web page: http://crashcourse.ca
Linked In: http://www.linkedin.com/in/rpjday
Twitter: http://twitter.com/rpjday
========================================================================
From rpjday at crashcourse.ca Fri Jul 10 06:41:47 2009
From: rpjday at crashcourse.ca (Robert P. J. Day)
Date: Fri, 10 Jul 2009 02:41:47 -0400 (EDT)
Subject: [publican-list] publican-doc-0.45 users guide still reads "0.44"
Message-ID:
not a big deal but, from the svn build, the file
file:///usr/share/doc/publican-doc-0.45/en-US/index.html still reads
"Publican 0.44" on the front page.
rday
--
========================================================================
Robert P. J. Day Waterloo, Ontario, CANADA
Linux Consulting, Training and Annoying Kernel Pedantry.
Web page: http://crashcourse.ca
Linked In: http://www.linkedin.com/in/rpjday
Twitter: http://twitter.com/rpjday
========================================================================
From rpjday at crashcourse.ca Fri Jul 10 07:33:46 2009
From: rpjday at crashcourse.ca (Robert P. J. Day)
Date: Fri, 10 Jul 2009 03:33:46 -0400 (EDT)
Subject: [publican-list] random observations on svn checkout of users guide
Message-ID:
figured i might as well peruse the users guide from beginning to end
so here's some random observations.
* as i mentioned already, version 0.45 of the UG still has a title of
"0.44"
* section 1.2, "Source-code listings are also set in mono-spaced roman
but add syntax highlighting as follows:"
- in my browser, i see no example of "syntax highlighting". am i
supposed to see something representing an example of
highlighting there? it's just straight mono-spaced roman.
* perhaps off-topic but will publican work with the relax ng schema of
docbook 5.0? it's possible that's mentioned later in the UG and i
just haven't got to it yet.
* Chapter 2 refers to five different brand packages, yet yum sees only
the following at the moment:
$ yum search publican
publican.noarch : Common files and scripts for publishing with DocBook XML
publican-doc.noarch : Documentation for the Publican package
publican-fedora.noarch : Publican documentation template files for fedora
publican-genome.noarch : Common documentation files for genome
publican-ovirt.noarch : Common documentation files for oVirt
$
where are the packages for gimp, redhat and jboss? are they in the
works? and that UG table says nothing about publican-genome (whatever
that is).
* Section 3.1:
"Run the following command to install the publican package:
# yum install publican publican-doc
i would rephrase that as installing the package *and* its associated
documentation package since, AFAICT, they can be installed
independently, no?
and just below that:
# yum install publican-brand
Replace brand with redhat, fedora, jboss, ovirt, or gimp.
we've already noticed that some of those packages don't seem to
exist, at least for a stock f11 x86_64 install.
* section 3.2 lists the create_book options "--help" and "--man" while
the actual help output lists them as "-help" and "-man". both work
but perhaps those should be made consistent to avoid confusion.
also, that list of options in Section 3.2 doesn't mention "--lang".
* still in Section 3.2, the instructions to create a new book fail to
note that, after running that create_book command, you need to "cd
Test_Book" before running ls. i'm sure readers will notice that right
away but you might as well be explicit to be accurate.
* Figure 3.1 lists an alleged new file "Appendix.xml". i see no such
file after a book creation.
time for more coffee. back in a bit.
rday
--
========================================================================
Robert P. J. Day Waterloo, Ontario, CANADA
Linux Consulting, Training and Annoying Kernel Pedantry.
Web page: http://crashcourse.ca
Linked In: http://www.linkedin.com/in/rpjday
Twitter: http://twitter.com/rpjday
========================================================================
From rpjday at crashcourse.ca Fri Jul 10 10:39:51 2009
From: rpjday at crashcourse.ca (Robert P. J. Day)
Date: Fri, 10 Jul 2009 06:39:51 -0400 (EDT)
Subject: [publican-list] "make srpm-en-US" fails, "bad date in %changelog"
Message-ID:
not sure if this is a known issue but with a brand new generic book
via "create_book --name Test_Book":
$ make srpm-en-US
...
END: xml-en-US Fri Jul 10 06:34:05 EDT 2009
START: test-en-US Fri Jul 10 06:34:05 EDT 2009
warning: failed to load external entity "tmp/en-US/xml/Feedback.xml"
...
END: spec-en-US Fri Jul 10 06:34:06 EDT 2009
START: srpm-en-US Fri Jul 10 06:34:06 EDT 2009
error: bad date in %changelog: 1.0
make: *** [srpm-en-US] Error 1
$
i thought that might have been this:
https://bugzilla.redhat.com/show_bug.cgi?id=478950
but it doesn't look like it.
rday
p.s. i will be back to annoying you with UG issues shortly.
--
========================================================================
Robert P. J. Day Waterloo, Ontario, CANADA
Linux Consulting, Training and Annoying Kernel Pedantry.
Web page: http://crashcourse.ca
Linked In: http://www.linkedin.com/in/rpjday
Twitter: http://twitter.com/rpjday
========================================================================
From rpjday at crashcourse.ca Fri Jul 10 11:05:11 2009
From: rpjday at crashcourse.ca (Robert P. J. Day)
Date: Fri, 10 Jul 2009 07:05:11 -0400 (EDT)
Subject: [publican-list] ongoing observations on users guide (svn checkout)
Message-ID:
* section 3.3.1, under "BRAND": "Accepted values are RedHat, fedora,
JBoss, oVirt and GIMP." already mentioned earlier that some of those
brands don't *appear* to exist as packages, so i'll shut up about it
from now on.
* section 3.3.3: " If you distribute a book as an RPM package, the
data placed within this tag sets 'the first two digits of the version
number in the .rpm filename'.
So, an edition of '1.0' becomes a version of '1.0'."
that's not a terribly informative example -- stating that '1.0'
becomes '1.0'. perhaps a more complex edition number would show what
was happening more clearly.
* section 3.3.6: "This example loads the Book_Info.xml, Preface.xml,
Chapter.xml, and Appendix.xml XML files."
no, it doesn't load Appendix.xml, it loads Revision_History.xml.
as we observed before, there is no auto-generated Appendix.xml file.
* section 3.3.7: "If you define an entity ? ? you can enter &LIFT; in your XML
and it will appear as The Secret to Eternal Life every time the book
is built ..."
- i'm pretty sure that's not true.
i think that's all i have for now.
rday
--
========================================================================
Robert P. J. Day Waterloo, Ontario, CANADA
Linux Consulting, Training and Annoying Kernel Pedantry.
Web page: http://crashcourse.ca
Linked In: http://www.linkedin.com/in/rpjday
Twitter: http://twitter.com/rpjday
========================================================================
From rpjday at crashcourse.ca Fri Jul 10 13:15:27 2009
From: rpjday at crashcourse.ca (Robert P. J. Day)
Date: Fri, 10 Jul 2009 09:15:27 -0400 (EDT)
Subject: [publican-list] Error in /usr/share/publican/make/Makefile.common
Message-ID:
line 181:
@if [ ! -d $(COMMON_CONTENT)/$(BRAND) ]; then \
echo; \
echo "*ERROR: Brand $(BRAND) is not installed*" ; \
echo "Either install $(BRAND) or change to a valid Brand."; \
echo "Installed Brands:" \ <---- ERROR
echo "`ls $(COMMON_CONTENT)`"; \
exit 1; \
fi
that line should have a semi-colon as do the rest of them. without
it, if you try to build with an uninstalled brand, you'll get:
*ERROR: Brand fedora is not installed*
Either install fedora or change to a valid Brand.
Installed Brands: echo common
make: *** [pre] Error 1
note how the word "echo" is printed as if it's an installed brand.
that shouldn't happen, of course. adding the semi-colon fixes it.
rday
--
========================================================================
Robert P. J. Day Waterloo, Ontario, CANADA
Linux Consulting, Training and Annoying Kernel Pedantry.
Web page: http://crashcourse.ca
Linked In: http://www.linkedin.com/in/rpjday
Twitter: http://twitter.com/rpjday
========================================================================
From stickster at gmail.com Fri Jul 10 13:29:36 2009
From: stickster at gmail.com (Paul W. Frields)
Date: Fri, 10 Jul 2009 09:29:36 -0400
Subject: [publican-list] and the repository is where?
In-Reply-To:
References:
<4A56CC91.7020106@redhat.com>
Message-ID: <20090710132936.GD28530@localhost.localdomain>
On Fri, Jul 10, 2009 at 01:19:04AM -0400, Robert P. J. Day wrote:
> On Fri, 10 Jul 2009, Jeffrey Fearn wrote:
>
> > Robert P. J. Day wrote:
> ... snip ...
> > > http://fedoraproject.org/wiki/DocsProject/Publican
>
> > > Wiki: https://fedorahosted.org/publican
> >
> > The publican wiki is ^^^^^^^^^^^^^^^^^^^^
> >
> > It has the SVN info.
>
> ah, gotcha.
>
> > I'm not sure what that fedora docs page is doing there ... it's far
> > to well written for me to have simply forgotten I wrote it some time
> > in the distant past :D
>
> might want to toss that older page, then. when i googled for
> publican and repository, that's the one i ran across, and that might
> throw a few folks who end up there the same way.
It's a wiki! ;-) If you have a FAS account, log in to the wiki and
simply correct the instructions. Well, OK, I took care of this for
you already.
--
Paul W. Frields http://paul.frields.org/
gpg fingerprint: 3DA6 A0AC 6D58 FEC4 0233 5906 ACDB C937 BD11 3717
http://redhat.com/ - - - - http://pfrields.fedorapeople.org/
irc.freenode.net: stickster @ #fedora-docs, #fedora-devel, #fredlug
From rpjday at crashcourse.ca Fri Jul 10 13:34:08 2009
From: rpjday at crashcourse.ca (Robert P. J. Day)
Date: Fri, 10 Jul 2009 09:34:08 -0400 (EDT)
Subject: [publican-list] and the repository is where?
In-Reply-To: <20090710132936.GD28530@localhost.localdomain>
References:
<4A56CC91.7020106@redhat.com>
<20090710132936.GD28530@localhost.localdomain>
Message-ID:
On Fri, 10 Jul 2009, Paul W. Frields wrote:
> On Fri, Jul 10, 2009 at 01:19:04AM -0400, Robert P. J. Day wrote:
> > On Fri, 10 Jul 2009, Jeffrey Fearn wrote:
> >
> > > Robert P. J. Day wrote:
> > ... snip ...
> > > > http://fedoraproject.org/wiki/DocsProject/Publican
> >
> > > > Wiki: https://fedorahosted.org/publican
> > >
> > > The publican wiki is ^^^^^^^^^^^^^^^^^^^^
> > >
> > > It has the SVN info.
> >
> > ah, gotcha.
> >
> > > I'm not sure what that fedora docs page is doing there ... it's far
> > > to well written for me to have simply forgotten I wrote it some time
> > > in the distant past :D
> >
> > might want to toss that older page, then. when i googled for
> > publican and repository, that's the one i ran across, and that might
> > throw a few folks who end up there the same way.
>
> It's a wiki! ;-) If you have a FAS account, log in to the wiki and
> simply correct the instructions. Well, OK, I took care of this for
> you already.
i think the point that was made was that that page shouldn't even be
there, if i was reading jeff correctly. i thought he was suggesting
that fedorahosted.org/publican was the canonical wiki these days.
rday
--
========================================================================
Robert P. J. Day Waterloo, Ontario, CANADA
Linux Consulting, Training and Annoying Kernel Pedantry.
Web page: http://crashcourse.ca
Linked In: http://www.linkedin.com/in/rpjday
Twitter: http://twitter.com/rpjday
========================================================================
From rpjday at crashcourse.ca Fri Jul 10 13:35:37 2009
From: rpjday at crashcourse.ca (Robert P. J. Day)
Date: Fri, 10 Jul 2009 09:35:37 -0400 (EDT)
Subject: [publican-list] and the repository is where?
In-Reply-To: <20090710132936.GD28530@localhost.localdomain>
References:
<4A56CC91.7020106@redhat.com>
<20090710132936.GD28530@localhost.localdomain>
Message-ID:
On Fri, 10 Jul 2009, Paul W. Frields wrote:
> It's a wiki! ;-) If you have a FAS account, log in to the wiki and
> simply correct the instructions. Well, OK, I took care of this for
> you already.
or you could give me commit access to the repository and i could fix
a lot of the things i'm currently reporting. you know, things like
the numerous misspellings of "separate" as "seperate". niggly stuff
like that. :-)
rday
--
========================================================================
Robert P. J. Day Waterloo, Ontario, CANADA
Linux Consulting, Training and Annoying Kernel Pedantry.
Web page: http://crashcourse.ca
Linked In: http://www.linkedin.com/in/rpjday
Twitter: http://twitter.com/rpjday
========================================================================
From stickster at gmail.com Fri Jul 10 13:45:10 2009
From: stickster at gmail.com (Paul W. Frields)
Date: Fri, 10 Jul 2009 09:45:10 -0400
Subject: [publican-list] and the repository is where?
In-Reply-To:
References:
<4A56CC91.7020106@redhat.com>
<20090710132936.GD28530@localhost.localdomain>
Message-ID: <20090710134510.GH28530@localhost.localdomain>
On Fri, Jul 10, 2009 at 09:34:08AM -0400, Robert P. J. Day wrote:
> On Fri, 10 Jul 2009, Paul W. Frields wrote:
> > It's a wiki! ;-) If you have a FAS account, log in to the wiki and
> > simply correct the instructions. Well, OK, I took care of this for
> > you already.
>
> i think the point that was made was that that page shouldn't even be
> there, if i was reading jeff correctly. i thought he was suggesting
> that fedorahosted.org/publican was the canonical wiki these days.
I put an admonition on the top of the page to send people to the
official page.
--
Paul W. Frields http://paul.frields.org/
gpg fingerprint: 3DA6 A0AC 6D58 FEC4 0233 5906 ACDB C937 BD11 3717
http://redhat.com/ - - - - http://pfrields.fedorapeople.org/
irc.freenode.net: stickster @ #fedora-docs, #fedora-devel, #fredlug
From stickster at gmail.com Fri Jul 10 13:47:22 2009
From: stickster at gmail.com (Paul W. Frields)
Date: Fri, 10 Jul 2009 09:47:22 -0400
Subject: [publican-list] and the repository is where?
In-Reply-To:
References:
<4A56CC91.7020106@redhat.com>
<20090710132936.GD28530@localhost.localdomain>
Message-ID: <20090710134722.GI28530@localhost.localdomain>
On Fri, Jul 10, 2009 at 09:35:37AM -0400, Robert P. J. Day wrote:
> On Fri, 10 Jul 2009, Paul W. Frields wrote:
>
> > It's a wiki! ;-) If you have a FAS account, log in to the wiki and
> > simply correct the instructions. Well, OK, I took care of this for
> > you already.
>
> or you could give me commit access to the repository and i could fix
> a lot of the things i'm currently reporting. you know, things like
> the numerous misspellings of "separate" as "seperate". niggly stuff
> like that. :-)
True -- you can always send those things in as diffs, to this list for
example. (I don't have the ability to give you commit access
personally.)
Unfortunately, that repo, as far as I can tell, no longer contains up
to date Publican. The new Publican 1.0 that was announced isn't found
in any public repo that I can see from the fh.o/publican site.
Where's the code?
--
Paul W. Frields http://paul.frields.org/
gpg fingerprint: 3DA6 A0AC 6D58 FEC4 0233 5906 ACDB C937 BD11 3717
http://redhat.com/ - - - - http://pfrields.fedorapeople.org/
irc.freenode.net: stickster @ #fedora-docs, #fedora-devel, #fredlug
From rpjday at crashcourse.ca Fri Jul 10 13:54:01 2009
From: rpjday at crashcourse.ca (Robert P. J. Day)
Date: Fri, 10 Jul 2009 09:54:01 -0400 (EDT)
Subject: [publican-list] and the repository is where?
In-Reply-To: <20090710134722.GI28530@localhost.localdomain>
References:
<4A56CC91.7020106@redhat.com>
<20090710132936.GD28530@localhost.localdomain>
<20090710134722.GI28530@localhost.localdomain>
Message-ID:
On Fri, 10 Jul 2009, Paul W. Frields wrote:
> On Fri, Jul 10, 2009 at 09:35:37AM -0400, Robert P. J. Day wrote:
> > On Fri, 10 Jul 2009, Paul W. Frields wrote:
> >
> > > It's a wiki! ;-) If you have a FAS account, log in to the wiki and
> > > simply correct the instructions. Well, OK, I took care of this for
> > > you already.
> >
> > or you could give me commit access to the repository and i could
> > fix a lot of the things i'm currently reporting. you know, things
> > like the numerous misspellings of "separate" as "seperate".
> > niggly stuff like that. :-)
>
> True -- you can always send those things in as diffs, to this list
> for example. (I don't have the ability to give you commit access
> personally.)
sure, that's doable, but what about changes to the user guide?
given the number of translations, how does one submit a patch against
something in the user guide? just against en-US? or what?
> Unfortunately, that repo, as far as I can tell, no longer contains
> up to date Publican. The new Publican 1.0 that was announced isn't
> found in any public repo that I can see from the fh.o/publican site.
>
> Where's the code?
/usr/share/publican/make/Makefile.common. *that* i can submit a
patch for.
rday
--
========================================================================
Robert P. J. Day Waterloo, Ontario, CANADA
Linux Consulting, Training and Annoying Kernel Pedantry.
Web page: http://crashcourse.ca
Linked In: http://www.linkedin.com/in/rpjday
Twitter: http://twitter.com/rpjday
========================================================================
From rpjday at crashcourse.ca Fri Jul 10 14:00:22 2009
From: rpjday at crashcourse.ca (Robert P. J. Day)
Date: Fri, 10 Jul 2009 10:00:22 -0400 (EDT)
Subject: [publican-list] so what *is* publican-genome?
Message-ID:
it's not mentioned here:
https://fedorahosted.org/publican/
but it's a yum-installable package, although what it produces looks
kind of crappy with the default book -- the section headings
splattered over top of the "Genome" graphic with a couple sizable
"oVirt" images on the first page.
given that it's in the standard fedora yum repo, it really should
work a bit better than that.
rday
p.s. i am not *trying* to be relentlessly annoying -- i am merely
succeeding. mercifully, i am almost out of complaints. :-)
--
========================================================================
Robert P. J. Day Waterloo, Ontario, CANADA
Linux Consulting, Training and Annoying Kernel Pedantry.
Web page: http://crashcourse.ca
Linked In: http://www.linkedin.com/in/rpjday
Twitter: http://twitter.com/rpjday
========================================================================
From rpjday at crashcourse.ca Fri Jul 10 14:17:43 2009
From: rpjday at crashcourse.ca (Robert P. J. Day)
Date: Fri, 10 Jul 2009 10:17:43 -0400 (EDT)
Subject: [publican-list] [PATCH] Correct "seperate" misspellings in
make/Makefile.common
Message-ID:
Correct misspellings of "seperate" to "separate" strictly in
Makefile.common.
Signed-off-by: Robert P. J. Day
---
is this the proper format for submitted patches? i'm working off
the format i use for kernel patches.
Index: trunk/publican/make/Makefile.common
===================================================================
--- trunk/publican/make/Makefile.common (revision 736)
+++ trunk/publican/make/Makefile.common (working copy)
@@ -62,7 +62,7 @@
COMMON_CONTENT = $(COMMON_CONFIG)/Common_Content
-# a comma seperated list of other languages
+# a comma separated list of other languages
ifdef OTHER_LANGS
OTHER_LANGS_C = $(shell echo $(OTHER_LANGS) | sed -e 's/ /,/g')
endif
@@ -496,14 +496,14 @@
@echo
@echo "DOC_URL: URL for top right link in html. Currently: $(DOC_URL)"
@echo
- @echo "DT_OBSOLETES: A comma seperated list of desk top packages the package should obsolete. Currently: $(DT_OBSOLETES)"
+ @echo "DT_OBSOLETES: A comma separated list of desk top packages the package should obsolete. Currently: $(DT_OBSOLETES)"
@echo
@echo "GENERATE_SECTION_TOC_LEVEL: Include a TOC at the given section level. Currently: $(GENERATE_SECTION_TOC_LEVEL)"
@echo
@echo "IGNORED_TRANSLATIONS: When building replace any languages in this list with the source langauge text"
@echo " This allows you to work on translations without shipping incomplete translations. Currently: $(IGNORED_TRANSLATIONS)"
@echo
- @echo "OTHER_LANGS: space seperated list of language locales. Currently: $(OTHER_LANGS)"
+ @echo "OTHER_LANGS: space separated list of language locales. Currently: $(OTHER_LANGS)"
@echo
@echo "PRODUCT: Product this book is associated with. Currently: $(PRODUCT)"
@echo " When this book is published it will be nested in a directory named after the product"
@@ -518,7 +518,7 @@
@echo
@echo "WEB_BREW_DIST: brew tag to use for web rpms. Currently: $(WEB_BREW_DIST)"
@echo
- @echo "WEB_OBSOLETES: A comma seperated list of web site packages the web package should obsolete. Currently: $(WEB_OBSOLETES)"
+ @echo "WEB_OBSOLETES: A comma separated list of web site packages the web package should obsolete. Currently: $(WEB_OBSOLETES)"
@echo
@echo "XML_DESKTOP: Use XML for the desktop package instead of the default html-single. Currently: $(XML_DESKTOP)"
@echo
@@ -541,11 +541,11 @@
@echo
@echo "EXTRA_DIRS: Helps handle nested directories."
@echo
- @echo "EXTRA_DIRS_C: Comma seperated list of EXTRA_DIRS."
+ @echo "EXTRA_DIRS_C: Comma separated list of EXTRA_DIRS."
@echo
@echo "FORMATS: Output formats currently supported. Currently: $(FORMATS)."
@echo
- @echo "OTHER_LANGS_C: Comma seperated list of non-source languages."
+ @echo "OTHER_LANGS_C: Comma separated list of non-source languages."
@echo
@echo "PWD: present working directory."
@echo
========================================================================
Robert P. J. Day Waterloo, Ontario, CANADA
Linux Consulting, Training and Annoying Kernel Pedantry.
Web page: http://crashcourse.ca
Twitter: http://twitter.com/rpjday
"Kernel Newbie Corner" column @ linux.com: http://cli.gs/WG6WYX
========================================================================
From eric at christensenplace.us Fri Jul 10 14:53:20 2009
From: eric at christensenplace.us (Eric Christensen)
Date: Fri, 10 Jul 2009 10:53:20 -0400
Subject: [publican-list] and the repository is where?
In-Reply-To:
References:
<4A56CC91.7020106@redhat.com>
<20090710132936.GD28530@localhost.localdomain>
<20090710134722.GI28530@localhost.localdomain>
Message-ID: <1247237600.2520.8.camel@thunder.christensenplace.us>
On Fri, 2009-07-10 at 09:54 -0400, Robert P. J. Day wrote:
> sure, that's doable, but what about changes to the user guide?
> given the number of translations, how does one submit a patch against
> something in the user guide? just against en-US? or what?
> rday
Robert,
There should be a feedback page at the beginning of the User Guide (and
every guide) that shows users how to provide feedback. I'm pretty sure
you do that on BZ [1].
[1]
https://bugzilla.redhat.com/enter_bug.cgi?component=desktop-user-guide&product=Fedora%20Documentation
--
Thanks,
Eric Christensen
Fedora Docs Project Lead
Fedora Talk: 5102043 Phone: 919-424-0063 x 5102043
E-Mail: sparks at fedoraproject.org SIP: sparks at talk.fedoraproject.org
IRC: Sparks on freenode.net
GPG Fingerprint: CA02 4ACA EB6C 1A76 F0D6 1127 7D04 D240 BD0C 14C1
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 197 bytes
Desc: This is a digitally signed message part
URL:
From rpjday at crashcourse.ca Fri Jul 10 15:13:13 2009
From: rpjday at crashcourse.ca (Robert P. J. Day)
Date: Fri, 10 Jul 2009 11:13:13 -0400 (EDT)
Subject: [publican-list] and the repository is where?
In-Reply-To: <1247237600.2520.8.camel@thunder.christensenplace.us>
References:
<4A56CC91.7020106@redhat.com>
<20090710132936.GD28530@localhost.localdomain>
<20090710134722.GI28530@localhost.localdomain>
<1247237600.2520.8.camel@thunder.christensenplace.us>
Message-ID:
On Fri, 10 Jul 2009, Eric Christensen wrote:
> On Fri, 2009-07-10 at 09:54 -0400, Robert P. J. Day wrote:
> > sure, that's doable, but what about changes to the user guide?
> > given the number of translations, how does one submit a patch against
> > something in the user guide? just against en-US? or what?
> > rday
>
>
> Robert,
> There should be a feedback page at the beginning of the User Guide (and
> every guide) that shows users how to provide feedback. I'm pretty sure
> you do that on BZ [1].
>
> [1]
> https://bugzilla.redhat.com/enter_bug.cgi?component=desktop-user-guide&product=Fedora%20Documentation
it would take me less time to generate and submit patches than it
would to fight with the nightmare that is bugzilla.
rday
--
========================================================================
Robert P. J. Day Waterloo, Ontario, CANADA
Linux Consulting, Training and Annoying Kernel Pedantry.
Web page: http://crashcourse.ca
Twitter: http://twitter.com/rpjday
"Kernel Newbie Corner" column @ linux.com: http://cli.gs/WG6WYX
========================================================================
From eric at christensenplace.us Fri Jul 10 15:28:23 2009
From: eric at christensenplace.us (Eric Christensen)
Date: Fri, 10 Jul 2009 11:28:23 -0400
Subject: [publican-list] and the repository is where?
In-Reply-To:
References:
<4A56CC91.7020106@redhat.com>
<20090710132936.GD28530@localhost.localdomain>
<20090710134722.GI28530@localhost.localdomain>
<1247237600.2520.8.camel@thunder.christensenplace.us>
Message-ID: <1247239703.2520.22.camel@thunder.christensenplace.us>
On Fri, 2009-07-10 at 11:13 -0400, Robert P. J. Day wrote:
> On Fri, 10 Jul 2009, Eric Christensen wrote:
>
> > On Fri, 2009-07-10 at 09:54 -0400, Robert P. J. Day wrote:
> > > sure, that's doable, but what about changes to the user guide?
> > > given the number of translations, how does one submit a patch against
> > > something in the user guide? just against en-US? or what?
> > > rday
> >
> >
> > Robert,
> > There should be a feedback page at the beginning of the User Guide (and
> > every guide) that shows users how to provide feedback. I'm pretty sure
> > you do that on BZ [1].
> >
> > [1]
> > https://bugzilla.redhat.com/enter_bug.cgi?component=desktop-user-guide&product=Fedora%20Documentation
>
> it would take me less time to generate and submit patches than it
> would to fight with the nightmare that is bugzilla.
>
> rday
> --
Bugzilla really isn't a nightmare (takes me about 10 seconds to submit a
patch). It provides us an easy way of tracking patches and making sure
that everything happens.
--Eric
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 197 bytes
Desc: This is a digitally signed message part
URL:
From rpjday at crashcourse.ca Fri Jul 10 15:35:16 2009
From: rpjday at crashcourse.ca (Robert P. J. Day)
Date: Fri, 10 Jul 2009 11:35:16 -0400 (EDT)
Subject: [publican-list] and the repository is where?
In-Reply-To: <1247239703.2520.22.camel@thunder.christensenplace.us>
References:
<4A56CC91.7020106@redhat.com>
<20090710132936.GD28530@localhost.localdomain>
<20090710134722.GI28530@localhost.localdomain>
<1247237600.2520.8.camel@thunder.christensenplace.us>
<1247239703.2520.22.camel@thunder.christensenplace.us>
Message-ID:
On Fri, 10 Jul 2009, Eric Christensen wrote:
> Bugzilla really isn't a nightmare (takes me about 10 seconds to
> submit a patch). It provides us an easy way of tracking patches and
> making sure that everything happens.
*sigh*. i have no problem using BZ if i've found what i think is a
significant issue, whereupon i *will* be as complete and detailed as
possible because i want someone else more knowledgeable to take care
of it.
in *this* case, however, it actually takes less time to just create
a patch of the appropriate form (of which i am still uncertain since
no one has confirmed exactly what form of patch is proper on this ML)
and just post it to the list so someone can apply it.
seriously, if i have to go thru BZ to submit these types of patches,
i'm not going to bother with any of it. i save BZ for reports that
*matter*. i have no intention of inflicting BZ on myself for
correcting trivial errors or typoes.
rday
--
========================================================================
Robert P. J. Day Waterloo, Ontario, CANADA
Linux Consulting, Training and Annoying Kernel Pedantry.
Web page: http://crashcourse.ca
Twitter: http://twitter.com/rpjday
"Kernel Newbie Corner" column @ linux.com: http://cli.gs/WG6WYX
========================================================================
From stickster at gmail.com Fri Jul 10 15:59:10 2009
From: stickster at gmail.com (Paul W. Frields)
Date: Fri, 10 Jul 2009 11:59:10 -0400
Subject: [publican-list] and the repository is where?
In-Reply-To:
References: <4A56CC91.7020106@redhat.com>
<20090710132936.GD28530@localhost.localdomain>
<20090710134722.GI28530@localhost.localdomain>
<1247237600.2520.8.camel@thunder.christensenplace.us>
<1247239703.2520.22.camel@thunder.christensenplace.us>
Message-ID: <20090710155910.GM28530@localhost.localdomain>
On Fri, Jul 10, 2009 at 11:35:16AM -0400, Robert P. J. Day wrote:
> On Fri, 10 Jul 2009, Eric Christensen wrote:
>
> > Bugzilla really isn't a nightmare (takes me about 10 seconds to
> > submit a patch). It provides us an easy way of tracking patches and
> > making sure that everything happens.
>
> *sigh*. i have no problem using BZ if i've found what i think is a
> significant issue, whereupon i *will* be as complete and detailed as
> possible because i want someone else more knowledgeable to take care
> of it.
>
> in *this* case, however, it actually takes less time to just create
> a patch of the appropriate form (of which i am still uncertain since
> no one has confirmed exactly what form of patch is proper on this ML)
> and just post it to the list so someone can apply it.
>
> seriously, if i have to go thru BZ to submit these types of patches,
> i'm not going to bother with any of it. i save BZ for reports that
> *matter*. i have no intention of inflicting BZ on myself for
> correcting trivial errors or typoes.
If I can make a suggestion... I use the 'bugzilla' command-line
utility often to file bugs, because it's fast and easy compared to the
Web browser. So for example:
$ bugzilla login # Then enter BZ username and password, makes a
# cookie that's used from here on out...
$ bugzilla info -c 'Fedora Documentation' # Tell me the components
# in this product (only
# if you don't know which)
$ bugzilla new -p 'Fedora Documentation' -v 'rawhide' \
-c 'security-guide' -s 'Security Guide missing foobar' \
-l "Looking at Security Guide, en-US 0.2. It doesn't have
a reference to foobar. Patch forthcoming."
The bug number spits back out to you, and you can visit it to attach
your file, which itself is a very fast operation nowadays, especially
since some HW and DB upgrades.
--
Paul W. Frields http://paul.frields.org/
gpg fingerprint: 3DA6 A0AC 6D58 FEC4 0233 5906 ACDB C937 BD11 3717
http://redhat.com/ - - - - http://pfrields.fedorapeople.org/
irc.freenode.net: stickster @ #fedora-docs, #fedora-devel, #fredlug
From stickster at gmail.com Fri Jul 10 16:02:05 2009
From: stickster at gmail.com (Paul W. Frields)
Date: Fri, 10 Jul 2009 12:02:05 -0400
Subject: [publican-list] and the repository is where?
In-Reply-To:
References: <4A56CC91.7020106@redhat.com>
<20090710132936.GD28530@localhost.localdomain>
<20090710134722.GI28530@localhost.localdomain>
<1247237600.2520.8.camel@thunder.christensenplace.us>
<1247239703.2520.22.camel@thunder.christensenplace.us>
Message-ID: <20090710160205.GN28530@localhost.localdomain>
On Fri, Jul 10, 2009 at 11:35:16AM -0400, Robert P. J. Day wrote:
> in *this* case, however, it actually takes less time to just create
> a patch of the appropriate form (of which i am still uncertain since
> no one has confirmed exactly what form of patch is proper on this ML)
> and just post it to the list so someone can apply it.
And I can't speak for patch email for the Publican repo, since it's
SVN. I'd assume 'svn diff -u | mail -s "Description of fix"' would be
OK. Git makes this dead-simple, but it's up to the maintainers for a
project to tell you what they prefer, otherwise.
--
Paul W. Frields http://paul.frields.org/
gpg fingerprint: 3DA6 A0AC 6D58 FEC4 0233 5906 ACDB C937 BD11 3717
http://redhat.com/ - - - - http://pfrields.fedorapeople.org/
irc.freenode.net: stickster @ #fedora-docs, #fedora-devel, #fredlug
From rpjday at crashcourse.ca Fri Jul 10 16:27:28 2009
From: rpjday at crashcourse.ca (Robert P. J. Day)
Date: Fri, 10 Jul 2009 12:27:28 -0400 (EDT)
Subject: [publican-list] and the repository is where?
In-Reply-To: <20090710155910.GM28530@localhost.localdomain>
References: <4A56CC91.7020106@redhat.com>
<20090710132936.GD28530@localhost.localdomain>
<20090710134722.GI28530@localhost.localdomain>
<1247237600.2520.8.camel@thunder.christensenplace.us>
<1247239703.2520.22.camel@thunder.christensenplace.us>
<20090710155910.GM28530@localhost.localdomain>
Message-ID:
On Fri, 10 Jul 2009, Paul W. Frields wrote:
> If I can make a suggestion... I use the 'bugzilla' command-line
> utility often to file bugs, because it's fast and easy compared to the
> Web browser. So for example:
i give up. seriously. i just don't have time for this.
rday
--
========================================================================
Robert P. J. Day Waterloo, Ontario, CANADA
Linux Consulting, Training and Annoying Kernel Pedantry.
Web page: http://crashcourse.ca
Twitter: http://twitter.com/rpjday
"Kernel Newbie Corner" column @ linux.com: http://cli.gs/WG6WYX
========================================================================
From jaredsmith at jaredsmith.net Fri Jul 10 18:14:23 2009
From: jaredsmith at jaredsmith.net (Jared Smith)
Date: Fri, 10 Jul 2009 14:14:23 -0400
Subject: [publican-list] and the repository is where?
In-Reply-To:
References: <4A56CC91.7020106@redhat.com>
<20090710132936.GD28530@localhost.localdomain>
<20090710134722.GI28530@localhost.localdomain>
<1247237600.2520.8.camel@thunder.christensenplace.us>
<1247239703.2520.22.camel@thunder.christensenplace.us>
<20090710155910.GM28530@localhost.localdomain>
Message-ID: <1247249663.2852.59.camel@hockey.jaredsmith.net>
On Fri, 2009-07-10 at 12:27 -0400, Robert P. J. Day wrote:
> i give up. seriously. i just don't have time for this.
Hi Robert... I'm not sure we've ever met, and I don't remember seeing
any comments from you previously on the publican list, so it's good to
meet you (well, as much as you can really meet someone in a mailing
list).
If you don't have time to send in a bugzilla ticket, email me the
patches and I'd be happy to open bugzilla tickets for each and every
one.
Seriously. I'd be happy to spend a little of my own time to save some
of yours.
May I suggest in passing, though, that you lose the attitude. I don't
know you from Adam, and I'm sure you're a really nice guy in real life,
and I'm sure you're infinitely smarter than I can ever hope to be.. but
based on what I've seen over the past few hours in the mailing list, I
can honestly say you're not doing yourself any favors.
Who am I, you might ask? I'm nobody... I'm just another guy who happens
to use Publican, follows the mailing list, and contributes patches from
time to time. But I'm also another guy who happened to be quite
appalled at the tone of your recent posts.
The methodology of open source development means that sometimes
documentation isn't correct or up-to-date, and sometimes mere mortals
make mistakes (heaven forbid!). As I see it, you're one of the few that
thinks that in open communities, he who shouts the loudest wins. And
the sense of entitlement ("You must give me access to the repository to
fix grammar problems even though I can't manage to capitalize my
sentences" and "I'd be happy to help and make suggestions, but only if
you guys cater to my whims") makes developers *less* likely for the
Publican developers (again, I'm not one) to listen to you, not more.
Now, I'm not saying that Publican is perfect... I'm simply saying that
the way we communicate will have an effect on how Publican gets to where
we want it to be.
My two cents... (before taxes)
-Jared
From jfearn at redhat.com Mon Jul 13 00:29:50 2009
From: jfearn at redhat.com (Jeffrey Fearn)
Date: Mon, 13 Jul 2009 10:29:50 +1000
Subject: [publican-list] newbie observations on building publican from SVN
In-Reply-To:
References:
Message-ID: <4A5A7FFE.9060405@redhat.com>
Hi Robert, I'm putting the finishing touches on a hobby project I've
been working on of rewriting publican in perl. This will change lots of
things, including making half the UG obsolete and removing all Makefiles.
The Red Hat docs team are organizing a public beta test to give the
rewrite a flogging.
I'll do my best to respond to the issues you have raised, but a few of
them will basically be "I already killed that bit" :)
Robert P. J. Day wrote:
> from the perspective of someone who built publican from the repo for
> the very first time a few minutes ago:
>
> * the README file suggests i can get make help with one of "make help"
> or "make help_params". neither of those targets seem to be supported.
This relates to commands you can run in a book not the publican build.
This has all completely changed so this file will have to be completely
rewritten.
> * the build on a fully-updated f11 x86_64 system generates numerous
> "... Legal_Notice.po MISSING Using en-US file" warnings. doesn't stop
> the build, though.
This is kind of correct, the Legal Notice file should never be
translated. But there isn't a way to mark pages as "never translate" ...
that would be a cool function :D
> * doing a straight "make" clearly attempts to *install* the
> constructed rpm. that's kind of unusual, isn't it? i'm more used to
> having to do that explicitly, with "make install". only after i
> looked at the Makefile did i see the more limited "make rpm" target.
The make files are heinous! The rewrite uses Module::Build and works as
expected.
Cheers, Jeff.
--
Jeff Fearn
Software Engineer
Engineering Operations
Red Hat, Inc
Freedom ... courage ... Commitment ... ACCOUNTABILITY
http://file.bne.redhat.com/~jfearn/
From jfearn at redhat.com Mon Jul 13 00:31:02 2009
From: jfearn at redhat.com (Jeffrey Fearn)
Date: Mon, 13 Jul 2009 10:31:02 +1000
Subject: [publican-list] publican-doc-0.45 users guide still reads "0.44"
In-Reply-To:
References:
Message-ID: <4A5A8046.1010408@redhat.com>
Robert P. J. Day wrote:
> not a big deal but, from the svn build, the file
> file:///usr/share/doc/publican-doc-0.45/en-US/index.html still reads
> "Publican 0.44" on the front page.
I am harassing the Red hat docs team leader for a writer to rewrite the
UG for the beta test, I will increase harassment.
Cheers, Jeff.
--
Jeff Fearn
Software Engineer
Engineering Operations
Red Hat, Inc
Freedom ... courage ... Commitment ... ACCOUNTABILITY
http://file.bne.redhat.com/~jfearn/
From jfearn at redhat.com Mon Jul 13 00:41:05 2009
From: jfearn at redhat.com (Jeffrey Fearn)
Date: Mon, 13 Jul 2009 10:41:05 +1000
Subject: [publican-list] random observations on svn checkout of users guide
In-Reply-To:
References:
Message-ID: <4A5A82A1.7050508@redhat.com>
Robert P. J. Day wrote:
> figured i might as well peruse the users guide from beginning to end
> so here's some random observations.
>
> * as i mentioned already, version 0.45 of the UG still has a title of
> "0.44"
>
> * section 1.2, "Source-code listings are also set in mono-spaced roman
> but add syntax highlighting as follows:"
>
> - in my browser, i see no example of "syntax highlighting". am i
> supposed to see something representing an example of
> highlighting there? it's just straight mono-spaced roman.
Publican is not a Fedora project and some of the functionality is not
available in Fedora due to packaging issues. In this case if you don't
have xslthl installed, which is not packaged for Fedora, then you won't
see highlighting.
The beta version uses a perl library for this, which is also not in
Fedora, but it should be easier to get that in to Fedora.
> * perhaps off-topic but will publican work with the relax ng schema of
> docbook 5.0? it's possible that's mentioned later in the UG and i
> just haven't got to it yet.
It would require a small amount of tweaking to support NG, but it will
require a massive amount of QA on the changes it introduces.
> * Chapter 2 refers to five different brand packages, yet yum sees only
> the following at the moment:
>
> $ yum search publican
> publican.noarch : Common files and scripts for publishing with DocBook XML
> publican-doc.noarch : Documentation for the Publican package
> publican-fedora.noarch : Publican documentation template files for fedora
> publican-genome.noarch : Common documentation files for genome
> publican-ovirt.noarch : Common documentation files for oVirt
> $
>
> where are the packages for gimp, redhat and jboss? are they in the
> works? and that UG table says nothing about publican-genome (whatever
> that is).
The Red Hat and JBoss brands never made it past Fedora packaging, but
they are available to RHEL users. publican-genome is a community brand
and not maintained by the publican team. I'm really happy
publican-genome got created as it is a shining example of exactly why we
went with this approach to branding.
Chapter 3 needs a complete rewrite since the beta completely changes the
interaction of the user.
> * Section 3.1:
>
> "Run the following command to install the publican package:
>
> # yum install publican publican-doc
>
> i would rephrase that as installing the package *and* its associated
> documentation package since, AFAICT, they can be installed
> independently, no?
>
> and just below that:
>
> # yum install publican-brand
>
> Replace brand with redhat, fedora, jboss, ovirt, or gimp.
>
> we've already noticed that some of those packages don't seem to
> exist, at least for a stock f11 x86_64 install.
Yup, Publican is not a Fedora project and the instructions cover things
available on different platforms. We probably need to make that clearer.
> * section 3.2 lists the create_book options "--help" and "--man" while
> the actual help output lists them as "-help" and "-man". both work
> but perhaps those should be made consistent to avoid confusion.
>
> also, that list of options in Section 3.2 doesn't mention "--lang".
>
> * still in Section 3.2, the instructions to create a new book fail to
> note that, after running that create_book command, you need to "cd
> Test_Book" before running ls. i'm sure readers will notice that right
> away but you might as well be explicit to be accurate.
>
> * Figure 3.1 lists an alleged new file "Appendix.xml". i see no such
> file after a book creation.
Cheers, Jeff.
--
Jeff Fearn
Software Engineer
Engineering Operations
Red Hat, Inc
Freedom ... courage ... Commitment ... ACCOUNTABILITY
http://file.bne.redhat.com/~jfearn/
From jfearn at redhat.com Mon Jul 13 00:42:47 2009
From: jfearn at redhat.com (Jeffrey Fearn)
Date: Mon, 13 Jul 2009 10:42:47 +1000
Subject: [publican-list] "make srpm-en-US" fails, "bad date in %changelog"
In-Reply-To:
References:
Message-ID: <4A5A8307.50409@redhat.com>
Robert P. J. Day wrote:
> not sure if this is a known issue but with a brand new generic book
> via "create_book --name Test_Book":
>
> $ make srpm-en-US
> ...
> END: xml-en-US Fri Jul 10 06:34:05 EDT 2009
> START: test-en-US Fri Jul 10 06:34:05 EDT 2009
> warning: failed to load external entity "tmp/en-US/xml/Feedback.xml"
> ...
> END: spec-en-US Fri Jul 10 06:34:06 EDT 2009
> START: srpm-en-US Fri Jul 10 06:34:06 EDT 2009
> error: bad date in %changelog: 1.0
> make: *** [srpm-en-US] Error 1
> $
>
> i thought that might have been this:
>
> https://bugzilla.redhat.com/show_bug.cgi?id=478950
>
> but it doesn't look like it.
The dates in the Revision History have to match the format expected by rpm.
The beta uses a perl date manipulation routine to refortmat this, so any
valid date should work.
Cheers, Jeff.
--
Jeff Fearn
Software Engineer
Engineering Operations
Red Hat, Inc
Freedom ... courage ... Commitment ... ACCOUNTABILITY
http://file.bne.redhat.com/~jfearn/
From jfearn at redhat.com Mon Jul 13 00:46:21 2009
From: jfearn at redhat.com (Jeffrey Fearn)
Date: Mon, 13 Jul 2009 10:46:21 +1000
Subject: [publican-list] and the repository is where?
In-Reply-To:
References: <4A56CC91.7020106@redhat.com> <20090710132936.GD28530@localhost.localdomain>
Message-ID: <4A5A83DD.4070801@redhat.com>
Robert P. J. Day wrote:
> On Fri, 10 Jul 2009, Paul W. Frields wrote:
>
>> It's a wiki! ;-) If you have a FAS account, log in to the wiki and
>> simply correct the instructions. Well, OK, I took care of this for
>> you already.
>
> or you could give me commit access to the repository and i could fix
> a lot of the things i'm currently reporting. you know, things like
> the numerous misspellings of "separate" as "seperate". niggly stuff
> like that. :-)
We really need to have a policy on how people get access. Like submit X
patches or buy Jeff X six pack[s] of Cider, something formal anyways.
Discuss!
Cheers, Jeff.
--
Jeff Fearn
Software Engineer
Engineering Operations
Red Hat, Inc
Freedom ... courage ... Commitment ... ACCOUNTABILITY
http://file.bne.redhat.com/~jfearn/
From jfearn at redhat.com Mon Jul 13 00:49:36 2009
From: jfearn at redhat.com (Jeffrey Fearn)
Date: Mon, 13 Jul 2009 10:49:36 +1000
Subject: [publican-list] and the repository is where?
In-Reply-To: <20090710134722.GI28530@localhost.localdomain>
References: <4A56CC91.7020106@redhat.com> <20090710132936.GD28530@localhost.localdomain>
<20090710134722.GI28530@localhost.localdomain>
Message-ID: <4A5A84A0.8050100@redhat.com>
Paul W. Frields wrote:
> On Fri, Jul 10, 2009 at 09:35:37AM -0400, Robert P. J. Day wrote:
>> On Fri, 10 Jul 2009, Paul W. Frields wrote:
>>
>>> It's a wiki! ;-) If you have a FAS account, log in to the wiki and
>>> simply correct the instructions. Well, OK, I took care of this for
>>> you already.
>> or you could give me commit access to the repository and i could fix
>> a lot of the things i'm currently reporting. you know, things like
>> the numerous misspellings of "separate" as "seperate". niggly stuff
>> like that. :-)
>
> True -- you can always send those things in as diffs, to this list for
> example. (I don't have the ability to give you commit access
> personally.)
>
> Unfortunately, that repo, as far as I can tell, no longer contains up
> to date Publican. The new Publican 1.0 that was announced isn't found
> in any public repo that I can see from the fh.o/publican site.
>
> Where's the code?
>
It's on my laptop. It will be checked in to the SVN repo before the beta.
Cheers, Jeff.
--
Jeff Fearn
Software Engineer
Engineering Operations
Red Hat, Inc
Freedom ... courage ... Commitment ... ACCOUNTABILITY
http://file.bne.redhat.com/~jfearn/
From jfearn at redhat.com Mon Jul 13 00:58:34 2009
From: jfearn at redhat.com (Jeffrey Fearn)
Date: Mon, 13 Jul 2009 10:58:34 +1000
Subject: [publican-list] so what *is* publican-genome?
In-Reply-To:
References:
Message-ID: <4A5A86BA.1000201@redhat.com>
Robert P. J. Day wrote:
> it's not mentioned here:
publican-genome is a community owned brand! I love this!
See: https://fedorahosted.org/genome/
They probably need to change the URLs in their spec file to point to the
genome project.
It's pretty hard to make a brand with the 0.x publican, so I'm not going
to harass people about them. The beta makes this much easier, still
probably need some finessing though.
> https://fedorahosted.org/publican/
>
> but it's a yum-installable package, although what it produces looks
> kind of crappy with the default book -- the section headings
> splattered over top of the "Genome" graphic with a couple sizable
> "oVirt" images on the first page.
>
> given that it's in the standard fedora yum repo, it really should
> work a bit better than that.
>
> rday
>
> p.s. i am not *trying* to be relentlessly annoying -- i am merely
> succeeding. mercifully, i am almost out of complaints. :-)
That's not relentlessly annoying...
BTW I'm Australian so that outback accent isn't so hard to achieve ;)
Cheers, Jeff.
--
Jeff Fearn
Software Engineer
Engineering Operations
Red Hat, Inc
Freedom ... courage ... Commitment ... ACCOUNTABILITY
http://file.bne.redhat.com/~jfearn/
From mhideo at redhat.com Mon Jul 13 22:07:09 2009
From: mhideo at redhat.com (Michael Hideo)
Date: Tue, 14 Jul 2009 08:07:09 +1000
Subject: [publican-list] publican-doc-0.45 users guide still reads "0.44"
In-Reply-To: <4A5A8046.1010408@redhat.com>
References:
<4A5A8046.1010408@redhat.com>
Message-ID: <4A5BB00D.8030001@redhat.com>
Jeffrey Fearn wrote:
> Robert P. J. Day wrote:
>> not a big deal but, from the svn build, the file
>> file:///usr/share/doc/publican-doc-0.45/en-US/index.html still reads
>> "Publican 0.44" on the front page.
>
> I am harassing the Red hat docs team leader for a writer to rewrite the
> UG for the beta test, I will increase harassment.
>
Hi Jeff,
I will circle back to this on thursday once i have regression tests
written. that is about as far ahead as i can plan right now.
- Mike
From rpjday at crashcourse.ca Tue Jul 14 13:31:32 2009
From: rpjday at crashcourse.ca (Robert P. J. Day)
Date: Tue, 14 Jul 2009 09:31:32 -0400 (EDT)
Subject: [publican-list] newbie observations on building publican from SVN
In-Reply-To: <4A5A7FFE.9060405@redhat.com>
References:
<4A5A7FFE.9060405@redhat.com>
Message-ID:
On Mon, 13 Jul 2009, Jeffrey Fearn wrote:
> Hi Robert, I'm putting the finishing touches on a hobby project I've
> been working on of rewriting publican in perl. This will change lots
> of things, including making half the UG obsolete and removing all
> Makefiles.
>
> The Red Hat docs team are organizing a public beta test to give the
> rewrite a flogging.
i'm guessing that that beta test will be announced here when it's
ready to go? i'd be happy to pound on it.
rday
--
========================================================================
Robert P. J. Day Waterloo, Ontario, CANADA
Linux Consulting, Training and Annoying Kernel Pedantry.
Web page: http://crashcourse.ca
Twitter: http://twitter.com/rpjday
"Kernel Newbie Corner" column @ linux.com: http://cli.gs/WG6WYX
========================================================================
From jfearn at redhat.com Tue Jul 14 22:00:41 2009
From: jfearn at redhat.com (Jeffrey Fearn)
Date: Wed, 15 Jul 2009 08:00:41 +1000
Subject: [publican-list] newbie observations on building publican from SVN
In-Reply-To:
References:
<4A5A7FFE.9060405@redhat.com>
Message-ID: <4A5D0009.9010305@redhat.com>
Robert P. J. Day wrote:
> On Mon, 13 Jul 2009, Jeffrey Fearn wrote:
>
>> Hi Robert, I'm putting the finishing touches on a hobby project I've
>> been working on of rewriting publican in perl. This will change lots
>> of things, including making half the UG obsolete and removing all
>> Makefiles.
>>
>> The Red Hat docs team are organizing a public beta test to give the
>> rewrite a flogging.
>
> i'm guessing that that beta test will be announced here when it's
> ready to go? i'd be happy to pound on it.
There will be a big announcement on this list detailing everything once
it's worked out.
Cheers Jeff.
--
Jeff Fearn
Software Engineer
Engineering Operations
Red Hat, Inc
Freedom ... courage ... Commitment ... ACCOUNTABILITY
http://file.bne.redhat.com/~jfearn/
From bugzilla at redhat.com Wed Jul 15 00:32:35 2009
From: bugzilla at redhat.com (bugzilla at redhat.com)
Date: Tue, 14 Jul 2009 20:32:35 -0400
Subject: [publican-list] [Bug 511404] New: [Feature Request]
Message-ID:
Please do not reply directly to this email. All additional
comments should be made in the comments box of this bug.
Summary: [Feature Request]
https://bugzilla.redhat.com/show_bug.cgi?id=511404
Summary: [Feature Request]
Product: Red Hat Enterprise Linux 5
Version: 5.4
Platform: All
OS/Version: Linux
Status: NEW
Severity: medium
Priority: medium
Component: publican
AssignedTo: jfearn at redhat.com
ReportedBy: ccurran at redhat.com
QAContact: ecs-dev-list at redhat.com
CC: publican-list at redhat.com
Classification: Red Hat
Target Release: ---
Description of problem:
As you may or may not know, the stepalternatives tag presently has no special
formatting. Presently it formats the same way as itemized list items format.
What I would love to see is the words "optional" or "alternative step" or
whatever Brian suggests placed in front of the text in the step. Perhaps some
light bold markup or similar.
There is a business case for this. It makes my life easier for explaining how
to use different features. Presently using admonitions or repeating the
procedure is the easiest way to write around it and get a similar effect. The
problem with this is using admonitions is distracting and may be interpreted as
no-core functionality.
Additional info:
Cider.
--
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 Jul 15 00:53:54 2009
From: bugzilla at redhat.com (bugzilla at redhat.com)
Date: Tue, 14 Jul 2009 20:53:54 -0400
Subject: [publican-list] [Bug 511404] [Feature Request]
In-Reply-To:
References:
Message-ID: <200907150053.n6F0rsp3026294@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=511404
David O'Brien changed:
What |Removed |Added
----------------------------------------------------------------------------
CC| |daobrien at redhat.com
--- Comment #1 from David O'Brien 2009-07-14 20:53:54 EDT ---
Putting a label on this tag will only limit its usefulness. If you add
"optional" to all tags then they can only be used as
optional. If you call them alternatives, then they can only be that. It will
also require revisiting and validating all those instances where the tag has
already been used. Relying on formatting is ok; adding textual labels is highly
questionable. There is also a team of people involved in working on our style
guide, not a single person.
--
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 Jul 15 01:50:22 2009
From: bugzilla at redhat.com (bugzilla at redhat.com)
Date: Tue, 14 Jul 2009 21:50:22 -0400
Subject: [publican-list] [Bug 511404] [Feature Request]
In-Reply-To:
References:
Message-ID: <200907150150.n6F1oM0G003825@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=511404
Jeff Fearn changed:
What |Removed |Added
----------------------------------------------------------------------------
AssignedTo|jfearn at redhat.com |mhideo at redhat.com
--- Comment #2 from Jeff Fearn 2009-07-14 21:50:21 EDT ---
FYI 1: stepalternative does have:
Attribute
Name: performance
Type Enumeration:
optional
required
Default: "required"
FYI 2: Neither optional or required are contained in the translation strings in
DocBook, meaning automated translation of the labels would require upstream
modification.
--
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 Jul 15 01:54:20 2009
From: bugzilla at redhat.com (bugzilla at redhat.com)
Date: Tue, 14 Jul 2009 21:54:20 -0400
Subject: [publican-list] [Bug 511404] [Feature Request]
In-Reply-To:
References:
Message-ID: <200907150154.n6F1sK5t026024@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=511404
--- Comment #3 from Christopher Curran 2009-07-14 21:54:20 EDT ---
Oh, I am aware I am not the only one working. Are you aware the tag is
presently unsupported?
*WARNING: Unvalidated tag: stepalternatives*
This tag may not be displayed correctly, may generate invalid xhtml, or may
breach Section 508 Accessibility standards.
The default is also "required", not optional.
Presently it formats with a bullet point, which in this writers view is
completely wrong. Updating the output to alphabet characters would be a partial
fix.
There is no reason why something tagged stepalternative --an alternative step--
could not have "Alternative step:" or similar appended to the front.
The textual tags require localized support, but I'm sure we can get that
with a quick ping around our translators.
--
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 Jul 16 03:40:27 2009
From: bugzilla at redhat.com (bugzilla at redhat.com)
Date: Wed, 15 Jul 2009 23:40:27 -0400
Subject: [publican-list] [Bug 486520] Preface headings and revision history
should use sentence caps
In-Reply-To:
References:
Message-ID: <200907160340.n6G3eRe8027923@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=486520
--- Comment #5 from Murray McAllister 2009-07-15 23:40:25 EDT ---
0) Identified because I used sentence case for a whole book and Preface and
Revision History did not.
1) The effect is every book will have the same heading style and be consistent.
2) No time and effort required since even people like myself can remember
sentence case rules.
3) For gain see 1).
--
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 Jul 16 04:17:43 2009
From: bugzilla at redhat.com (bugzilla at redhat.com)
Date: Thu, 16 Jul 2009 00:17:43 -0400
Subject: [publican-list] [Bug 486520] Preface headings and revision history
should use sentence caps
In-Reply-To:
References:
Message-ID: <200907160417.n6G4Hhd0004315@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=486520
David O'Brien changed:
What |Removed |Added
----------------------------------------------------------------------------
CC|publican-list at redhat.com |
--- Comment #6 from David O'Brien 2009-07-16 00:17:42 EDT ---
(In reply to comment #5)
> 0) Identified because I used sentence case for a whole book and Preface and
> Revision History did not.
This would indicate that the balance of the book was at odds with our standing
styles, given that the Preface (in particular) includes sections based on
templates that use initial caps.
>
> 1) The effect is every book will have the same heading style and be consistent.
You can achieve this effect by adhering to existing styles.
>
> 2) No time and effort required since even people like myself can remember
> sentence case rules.
The time and effort is required in determining and implementing a new style and
then ensuring that *it*, rather than a previous style, is adhered to.
>
> 3) For gain see 1).
It's true that our styles are not consistently applied across all books. That
doesn't mean we need to change. It's also true that there are many styles used
throughout the world. Again, doesn't mean we need to change. Review, sure. If
we identify problems, if there is general agreement, and the benefit is obvious
and outweighs the cost then sure, let's investigate a style change. There are
far too many other aspects of our documentation that need attention besides how
we present our headings.
--
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 Jul 17 00:16:57 2009
From: bugzilla at redhat.com (bugzilla at redhat.com)
Date: Thu, 16 Jul 2009 20:16:57 -0400
Subject: [publican-list] [Bug 486520] Preface headings and revision history
should use sentence caps
In-Reply-To:
References:
Message-ID: <200907170016.n6H0GvDu022027@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=486520
Jeff Fearn changed:
What |Removed |Added
----------------------------------------------------------------------------
CC| |publican-list 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 Fri Jul 17 00:24:26 2009
From: bugzilla at redhat.com (bugzilla at redhat.com)
Date: Thu, 16 Jul 2009 20:24:26 -0400
Subject: [publican-list] [Bug 486520] Preface headings and revision history
should use sentence caps
In-Reply-To:
References:
Message-ID: <200907170024.n6H0OQeG023838@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=486520
Jeff Fearn changed:
What |Removed |Added
----------------------------------------------------------------------------
CC| |jfearn at redhat.com
--- Comment #7 from Jeff Fearn 2009-07-16 20:24:25 EDT ---
Check this out:
http://search.cpan.org/~dconway/Text-Autoformat-1.666.0/lib/Text/Autoformat.pm#Case_transformations
Maybe we could automate styling the title of the output based on a parameter
... maybe.
e.g:
Param: title_format
Values: NULL, upper, lower, sentence, title, highlight
Default: NULL
Where NULL is "don't be playing with my stylez fool"
This way we could set defaults or overrides in the Brands as required, and we
wouldn't have to manually go and change 250 books :D
Big question is if this works for translations, and if so, which languages do
or don't require it.
Cheers, Jeff.
--
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 Jul 17 00:34:00 2009
From: bugzilla at redhat.com (bugzilla at redhat.com)
Date: Thu, 16 Jul 2009 20:34:00 -0400
Subject: [publican-list] [Bug 492499] Add a section on how to reach Support
/ GSS
In-Reply-To:
References:
Message-ID: <200907170034.n6H0Y0cn025769@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=492499
Ruediger Landmann changed:
What |Removed |Added
----------------------------------------------------------------------------
CC| |jfearn at redhat.com,
| |publican-list at redhat.com
Component|Installation_Guide |publican
AssignedTo|rlandman at redhat.com |mhideo at redhat.com
--- Comment #3 from Ruediger Landmann 2009-07-16 20:33:59 EDT ---
This is a great idea, but the issue is broader that just the Installation
Guide. Other documentation could benefit from this as well.
We could add a "To get more help" text to our Publican templates, to be
included as a standard element in the Preface of our books.
For example, the Red Hat brand version could point to GSS, the Fedora brand
version could point to http://fedoraforum.org/, and the JBoss brand version
could point both to GSS and to http://www.jboss.org/community/index.jspa
I'm happy to work up the required text.
--
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 Jul 17 00:41:05 2009
From: bugzilla at redhat.com (bugzilla at redhat.com)
Date: Thu, 16 Jul 2009 20:41:05 -0400
Subject: [publican-list] [Bug 486520] Preface headings and revision history
should use sentence caps
In-Reply-To:
References:
Message-ID: <200907170041.n6H0f5l0027340@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=486520
--- Comment #8 from Murray McAllister 2009-07-16 20:41:05 EDT ---
re comment #7 the use of values provides gateway to multiple different heading
styles.
--
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 Jul 17 00:52:16 2009
From: bugzilla at redhat.com (bugzilla at redhat.com)
Date: Thu, 16 Jul 2009 20:52:16 -0400
Subject: [publican-list] [Bug 492499] Add a section on how to reach Support
/ GSS
In-Reply-To:
References:
Message-ID: <200907170052.n6H0qGKG029352@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=492499
--- Comment #4 from Jeff Fearn 2009-07-16 20:52:15 EDT ---
You could change Feedback.xml title to be "Contact and Feedback" or similar and
add this section to that file.
This way you don't have to go back and modify all the existing books and the
next time they are rebuilt they get this section.
Cheers, Jeff.
--
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 Jul 20 01:30:38 2009
From: jfearn at redhat.com (Jeffrey Fearn)
Date: Mon, 20 Jul 2009 11:30:38 +1000
Subject: [publican-list] SVN repo locked!
Message-ID: <4A63C8BE.105@redhat.com>
Please consider the SVN repo to be locked until further notice. I will
be restructuring it for the Beta, so the layout will be changing somewhat.
No it's not really locked, but play along with me anyway :)
Cheers, Jeff.
--
Jeff Fearn
Software Engineer
Engineering Operations
Red Hat, Inc
Freedom ... courage ... Commitment ... ACCOUNTABILITY
http://file.bne.redhat.com/~jfearn/