Gentoo Logo
Gentoo Spaceship




Note: Due to technical difficulties, the Archives are currently not up to date. GMANE provides an alternative service for most mailing lists.
c.f. bug 424647
List Archive: gentoo-doc
Navigation:
Lists: gentoo-doc: < Prev By Thread Next > < Prev By Date Next >
Headers:
To: gentoo-doc@g.o
From: Joshua Saddler <nightmorph@g.o>
Subject: Re: writing doc for logcheck
Date: Sun, 9 May 2010 12:38:36 -0700
On Sun, 09 May 2010 19:37:35 +0200
"Paweł Hajdan, Jr." <phajdan.jr@g.o> wrote:
> Pinging you then. By the way, I have opened a stabilization bug and
> we're getting some first Arch Testers' reports. It would be nice to get
> the GuideXML quite ready for the inclusion. :)

Actually, it looks pretty good. You musta cleaned it up. Only a couple of things left:

1. In CL 1.5, add parentheses around the RED comment text, just like you did in CL 1.4.

2. Just to make it more clear, change "${EDITOR}" in CL 1.6 to "nano -w" -- we generally use nano for basic editing examples. Experienced users will already be using a different tools, but inexperienced users might not know what ${EDITOR} is.

3. Maybe add <c> tags around each instance of logcheck where it is referred to as a program name. For the *user* "logcheck" you can leave it as-is. You might also want to enclose syslog-ng in <c> tags, too, before CL 1.3.

4. MOST IMPORTANT: do **not** do "echo app-admin/logcheck ~arch >> whatever"
- This is wrong! You NEVER add the ~arch keyword!! Just list app-admin/logcheck in package.keywords. This applies to any package in Portage.
- So CL 1.2 should be:

# <i>echo app-admin/logcheck >> /etc/portage/package.keywords</i>

-----

Open a GDP bug once logcheck is stabilized, and we can add the revised guide to /doc/en/
Attachment:
signature.asc (PGP signature)
Replies:
Re: writing doc for logcheck
-- Paweł Hajdan, Jr.
References:
writing doc for logcheck
-- Paweł Hajdan, Jr.
Re: writing doc for logcheck
-- Joshua Saddler
Re: writing doc for logcheck
-- Paweł Hajdan, Jr.
Re: writing doc for logcheck
-- Joshua Saddler
Re: writing doc for logcheck
-- Paweł Hajdan, Jr.
Navigation:
Lists: gentoo-doc: < Prev By Thread Next > < Prev By Date Next >
Previous by thread:
Re: writing doc for logcheck
Next by thread:
Re: writing doc for logcheck
Previous by date:
Re: writing doc for logcheck
Next by date:
Re: Where can i download the latest trads (or trads.rb) from?


Updated Apr 08, 2012

Summary: Archive of the gentoo-doc mailing list.

Donate to support our development efforts.

Copyright 2001-2013 Gentoo Foundation, Inc. Questions, Comments? Contact us.