Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 30689 - Another bunch of updates and corrections.
Summary: Another bunch of updates and corrections.
Status: RESOLVED FIXED
Alias: None
Product: [OLD] Docs-user
Classification: Unclassified
Component: Gentoo Security Guide (show other bugs)
Hardware: All Linux
: High normal (vote)
Assignee: Sven Vermeulen (RETIRED)
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2003-10-08 12:44 UTC by Sune Kloppenborg Jeppesen
Modified: 2003-10-12 04:50 UTC (History)
1 user (show)

See Also:
Package list:
Runtime testing required: ---


Attachments
Fix for bug. (gentoo-security-1.20-fix.diff,25.14 KB, patch)
2003-10-08 12:56 UTC, Sune Kloppenborg Jeppesen
Details | Diff
Fix for bug. (gentoo-security-1.20-fix.diff,65.84 KB, patch)
2003-10-09 11:55 UTC, Sune Kloppenborg Jeppesen
Details | Diff

Note You need to log in before you can comment on or make changes to this bug.
Description Sune Kloppenborg Jeppesen 2003-10-08 12:44:25 UTC
 
Comment 1 Sune Kloppenborg Jeppesen 2003-10-08 12:56:40 UTC
Created attachment 18956 [details, diff]
Fix for bug.

- Clear up language in several places.
- Added and corrected yet more tags.
- Removed link to Virtual private servers. Target page not updated in 2003
project seems stalled.
Comment 2 Zack Gilburd (RETIRED) gentoo-dev 2003-10-08 18:48:33 UTC
A couple of problems with the diff.

Notice where you add the <path> for /tmp?  You didn't do it for the second
occurance of "/tmp" later on in the line.

Where you tell the user to chmod the init script: Shouldn't the init script
already be +x?  If not, a bug needs to be filed about the chmodding.

On the line that starts "If the policy states...," you need a comma after
"week" becase you're using an if-then statement.

On the line "This will cause the kernel," "can contain payload with other
information then you think" should be worded "can contain payload with other
information than you think."

The line "Gcc trampoline support" should read "GCC trampoline support."

In fact, list items do not need to include periods.  It's a matter of preferrence,
but I do not add periods (nor inital capitals unless it's a proper word)
if the bullet is not a complete sentence.

The line that begins "And configure your MISC_OTHER": should not have double
punctuation at the end ("!" instead of "!.").

The line "Documentation can be found at <uri>http://www.pureftpd.org</uri>"
lacks a period at the end of the sentence.  Also I do not condone the usage
of passive tense.  If it read "One can find documentation," that would be
preferrable. (Apparently you use the clause "Documentation can be found"
often.  It does not really matter to me what tense you use, but passive is
not generally de facto.)

Other than that, you've done a good job.  I may have missed a few things
here or there, so I will look over it again later.

However, I ask that you make the above changes and submit a new patch.  I
will review the new patch and commit it, if approved.

Thanks





Comment 3 Sune Kloppenborg Jeppesen 2003-10-09 11:55:23 UTC
Created attachment 19024 [details, diff]
Fix for bug.

-All problems should be fixed in this patch. I have to mention that several
of
the issues pointed out was not introduced in the previous patch.
-The /etc/init.d/quotas file is not part of the standard init files and thus
have to be created. Therefor I think the chmod +x is in place.
-I've changed the documentation sentences to the one proposed and tried to
vary
it a bit. It is indeed used in quite a few places.

-A bunch of new corrections and updates. Geez I got carried away there:-)
-Fixed URL for SANS.
-Commented out most of the Bind section because it seems hopelessly out of
date. Will check others later.
-Kerneli seems rather inactive though there seems to be some activity on
their
mailing lists and a lot of spam there too. A search on Gentoo Forums only
returns 19 matches and none with kerneli in the subject. Is it worth having
the
chapter if nearly nobody are using it?
http://sourceforge.net/project/stats/index.php?report=months&group_id=30957

Not having English as your native language makes it a bit harder to get it
right. In that regard I have a question wether to write it's or it is and
don't
or do not?

Other than that thank you for the comments and I hope this will fix all issues.
Comment 4 Sven Vermeulen (RETIRED) gentoo-dev 2003-10-11 12:06:19 UTC
"It's" is an abbreviation for "It is". So "It's 20 degrees" == "It is 20
degrees".

"Its" is more possession-like. Like "his". So "The ISO and its ancestors".
Comment 5 Sven Vermeulen (RETIRED) gentoo-dev 2003-10-11 12:21:52 UTC
I'm currently at "@@ -839,20 +826,15 @@" of the patch (22%), will continue
tomorrow (see this comment as my personal bookmark :)
Comment 6 Sven Vermeulen (RETIRED) gentoo-dev 2003-10-12 04:50:38 UTC
Nice patch. Reviewed and committed.