s.org
Subject: Re: [OpenAFS] Documentation project comments
ted creedon <[EMAIL PROTECTED]> writes:
> Progress on a long forgotten front.
> If any material improvements to the text are made please forward so
> they can be incorporated..
I'm quite sure that improvements have been
ted creedon <[EMAIL PROTECTED]> writes:
> Progress on a long forgotten front.
> If any material improvements to the text are made please forward so they
> can be incorporated..
I'm quite sure that improvements have been made to at least some of the
text; I know that I rewrote the pts man page in
On 6/11/05, ted creedon <[EMAIL PROTECTED]> wrote:
> Progress on a long forgotten front.
>
> If any material improvements to the text are made please forward so they can
> be incorporated..
> tedc
Once again: this is supposed to be an open-source group-oriented project.
Documentation that only
@openafs.org
Subject: Re: [OpenAFS] Documentation project comments
Russ Allbery <[EMAIL PROTECTED]> writes:
> Russ Allbery <[EMAIL PROTECTED]> writes:
>> I'll mail Alf and ask if there's anything newer than the last time I
>> looked, and start plugging away at
Russ Allbery <[EMAIL PROTECTED]> writes:
> Russ Allbery <[EMAIL PROTECTED]> writes:
>> I'll mail Alf and ask if there's anything newer than the last time I
>> looked, and start plugging away at this.
> I now have in my hot little hands a tarball that should make a good
> starting point, and I loo
ted creedon <[EMAIL PROTECTED]> writes:
> If there is a Latex to man ir info, shouldn't be too bad.
> There are 800 pages in the Admin Reference
Yes, and most of them need significant work to update. Changing the
format of the documentation is only about 10% of the actual work that
needs to
ted creedon <[EMAIL PROTECTED]> writes:
> Here's what you won't have in the POD's:
Please note that all I'm trying to do is produce man pages. That means a
man page for each command or subcommand and a man page for each
configuration file. I'm not trying to duplicate the installation
instructio
Subject: Re: [OpenAFS] Documentation project comments
On Friday, June 10, 2005 03:25:24 PM -0700 Russ Allbery <[EMAIL PROTECTED]>
wrote:
> So that people know, if I write the man pages I'll write them all in
> POD, based initially on the web page reference manual, and then
On Friday, June 10, 2005 04:37:18 PM -0700 ted creedon
<[EMAIL PROTECTED]> wrote:
E-mail directly with questions.
I have a better idea. There is a mailing list, [EMAIL PROTECTED],
set up for discussion related to working on the documentation. I'd much
rather see active discussion there th
On Friday, June 10, 2005 03:25:24 PM -0700 Russ Allbery <[EMAIL PROTECTED]>
wrote:
So that people know, if I write the man pages I'll write them all in POD,
based initially on the web page reference manual, and then use pod2man to
convert them to man pages. One of the many pod2html converte
ge-
From: [EMAIL PROTECTED] [mailto:[EMAIL PROTECTED]
On Behalf Of Russ Allbery
Sent: Friday, June 10, 2005 3:25 PM
To: openafs-info@openafs.org
Subject: Re: [OpenAFS] Documentation project comments
Esther Filderman <[EMAIL PROTECTED]> writes:
> On 6/10/05, chas williams - CONTRACTOR <
an
Cc: openafs-info@openafs.org
Subject: Re: [OpenAFS] Documentation project comments
In message <[EMAIL PROTECTED]>,Esther Filderman
writes:
>available online. Requiring people to download giant postscript or pdf
>files to look up one command is ludicrious.
>
>Making things look p
ent: Friday, June 10, 2005 12:08 PM
To: openafs-info@openafs.org
Subject: Re: [OpenAFS] Documentation project comments
On 6/10/05, ted creedon <[EMAIL PROTECTED]> wrote:
> For what its worth, I think html documentation with hyperlinks is not
> the best way to go. It just happened to get do
Russ Allbery <[EMAIL PROTECTED]> writes:
> I'll mail Alf and ask if there's anything newer than the last time I
> looked, and start plugging away at this.
I now have in my hot little hands a tarball that should make a good
starting point, and I look it over and submit it to openafs-bugs for
inclu
Esther Filderman <[EMAIL PROTECTED]> writes:
> On 6/10/05, chas williams - CONTRACTOR <[EMAIL PROTECTED]> wrote:
>> is there any hope of someone doing something with the man pages?
>> yes, i am a dinosaur, i still like man pages.
> I think Russ Allbery was working on man pages a while ago. Oh, Ru
Esther Filderman wrote:
On 6/10/05, ted creedon <[EMAIL PROTECTED]> wrote:
For what its worth, I think html documentation with hyperlinks is not the
best way to go. It just happened to get done first on the second round of
conversions.
Yes, you've made your bias clear since you started this.
On 6/10/05, chas williams - CONTRACTOR <[EMAIL PROTECTED]> wrote:
>
> is there any hope of someone doing something with the man pages?
> yes, i am a dinosaur, i still like man pages.
>
I think Russ Allbery was working on man pages a while ago. Oh, Russ,
whatever happened?
___
In message <[EMAIL PROTECTED]>,Esther Filderman writes:
>available online. Requiring people to download giant postscript or
>pdf files to look up one command is ludicrious.
>
>Making things look pretty is fine, but they also have to be usable.
>In the end, HTML is likely going to be the most used
On 6/10/05, ted creedon <[EMAIL PROTECTED]> wrote:
> For what its worth, I think html documentation with hyperlinks is not the
> best way to go. It just happened to get done first on the second round of
> conversions.
Yes, you've made your bias clear since you started this. While I
sincerely appre
y, June 10, 2005 9:58 AM
To: openafs-info@openafs.org
Subject: Re: [OpenAFS] Documentation project comments
> Recompiling with the Springer Verlag sving6.sty document class
> produces textbook quality compositions with automatically numbered
> tables of contents, indexes and appen
Recompiling with the Springer Verlag sving6.sty document class produces
textbook quality compositions with automatically numbered tables of
contents, indexes and appendicies. The current version uses the article
class to support the hyperref package and the downstream converters.
Just going to
ted creedon wrote:
> Sources sent to [EMAIL PROTECTED]
>
> Anyone else interested can respond. It's a 3.5M targz file.
>
> tedc
>
Ted:
You already had an existing ticket in RT for this project. (#2830)
You should attach the documentation plus instructions to that ticket.
FYI, the new ticket y
c
-Original Message-
From: [EMAIL PROTECTED] [mailto:[EMAIL PROTECTED]
On Behalf Of Derrick J Brashear
Sent: Friday, June 10, 2005 6:40 AM
To: openafs-info@openafs.org
Subject: RE: [OpenAFS] Documentation project
On Fri, 10 Jun 2005, ted creedon wrote:
> 1. Explain "codify". If
On Fri, 10 Jun 2005, ted creedon wrote:
1. Explain "codify". If you mean "tell us what tricks we need to know"
that's why I suggested a BOF at the conference.
Is it a small set of same or similar transforms which can be scripted?
2. Hand edits will be required but more importantly, trial "l
. The good news is there is a latex set of docs available... In 284
separate files for the AdminReference alone.
tedc
-Original Message-
From: [EMAIL PROTECTED] [mailto:[EMAIL PROTECTED]
On Behalf Of Derrick J Brashear
Sent: Thursday, June 09, 2005 7:39 PM
To: openafs-info@openafs.org
Sub
8:09 PM
To: ted creedon
Cc: openafs-info@openafs.org
Subject: Re: [OpenAFS] Documentation project
On Thursday, June 09, 2005 01:31:06 PM -0700 ted creedon
<[EMAIL PROTECTED]> wrote:
> ... but I don't think anyone but me will be dong updates anyway.
That doesn't sound like a
On Thursday, June 09, 2005 01:31:06 PM -0700 ted creedon
<[EMAIL PROTECTED]> wrote:
... but I don't think anyone but me will be dong updates anyway.
That doesn't sound like a reasonable assumption to me, either in theory or
in practice.
This is an open-source project, and it needs to be po
On Thu, 9 Jun 2005, ted creedon wrote:
The AFS html part is about as done as its going to get. It actually looks
useful.
Hyperlinks work, minor hacks required but I don't think anyone but me will
be dong updates anyway. PDF links will require some more work since the
links are in the form direc
-Original Message-
From: [EMAIL PROTECTED] [mailto:[EMAIL PROTECTED]
On Behalf Of Esther Filderman
Sent: Friday, June 03, 2005 11:03 PM
To: openafs-info@openafs.org
Subject: Re: [OpenAFS] Documentation project update
On 6/3/05, ted creedon <[EMAIL PROTECTED]> wrote:
> All,
On 6/3/05, ted creedon <[EMAIL PROTECTED]> wrote:
> All,
>
> The documentation project is finished except for hyperlinks.
That's a very nice planet you live on.
> The conversion from IBM htm to tex is stable and the conversion from tex to
> html, dvi or pdf is also stable.
Oh, you mean the proj
30 matches
Mail list logo