From 38f293795cde2a7e32524b08c591ba612853137f Mon Sep 17 00:00:00 2001 From: Michael Kerrisk Date: Wed, 2 Dec 2020 10:22:56 +0100 Subject: Tweak various pages to indicate that there's a comaintainer Signed-off-by: Michael Kerrisk --- contributing.html | 3 --- licenses.html | 2 +- linux-api-ml.html | 6 ++---- maintaining.html | 25 +++++++++---------------- missing_pages.html | 27 ++++++++++----------------- patches.html | 36 ++++++++++++++++++++---------------- reporting_bugs.html | 18 +++++++----------- todo.html | 2 +- 8 files changed, 50 insertions(+), 69 deletions(-) diff --git a/contributing.html b/contributing.html index 0100026..b0b8ec3 100644 --- a/contributing.html +++ b/contributing.html @@ -101,9 +101,6 @@ contributing | Review can include checking technical accuracy, and suggestions for improved wording, grammar, layout, and so on. - (This is an area where I especially need help. - As the project maintainer, I am far too often - the reviewer of last resort.)

diff --git a/licenses.html b/licenses.html index 5973b6c..c88b5d3 100644 --- a/licenses.html +++ b/licenses.html @@ -139,7 +139,7 @@ Subject: Re: [RFC v4] system_data_types.7: Document sigval, ssize_t, suseconds_t by including the following text at the top of the page source, and substituting the appropriate pieces. Licensing under GPLv2 is preferred, because so far only v2 of - the GPL is used in any man pages, and I'd prefer to avoid + the GPL is used in any man pages, and we'd prefer to avoid further license proliferation.

diff --git a/linux-api-ml.html b/linux-api-ml.html index 0f6d005..971b441 100644 --- a/linux-api-ml.html +++ b/linux-api-ml.html @@ -44,12 +44,10 @@ Linux man-pages:  

Following a session (Who own's the interface) - that I led at the 2008 Linux Plumbers Conference, + that led by Michael Kerrisk at the 2008 Linux Plumbers Conference, the linux-api mailing list () - was - created at my request - as a forum to discuss + was created as a forum to discuss changes that affect the Linux programming interface (API or ABI).

diff --git a/maintaining.html b/maintaining.html index 6bd9880..25cb8cd 100644 --- a/maintaining.html +++ b/maintaining.html @@ -46,11 +46,13 @@ Maintaining Linux man-pages The current man-pages maintainer is (since 2004) Michael Kerrisk (; - blog). + blog); + starting in 2020, Alejandro Colomar + () + has joined as comaintainer.

- One day, someone else will be the maintainer. - So, to make life easier for the next person: + This page provides some tips on how to maintain the Linux man-pages project (also useful for anyone who wants to help with work on man-pages). @@ -185,7 +187,7 @@ Maintaining Linux man-pages One of the biggest challenges is keeping up to date with changes in the kernel and glibc. There are a few ways to do this. - This section lists the things I find most useful. + This section lists some of the most useful ways.

@@ -246,8 +248,8 @@ Maintaining Linux man-pages Below are some other ways of trying to discover changes in the kernel and glibc. There's way too much information here to track (in particular, it's pretty much impossible to track all of - of the mailing lists), but I keep this list as a way - of reminding myself of where useful pieces of info could be found. + of the mailing lists), but the list below serves as a reminder of + some places where useful information could be found.

Looking ahead: linux-next

@@ -609,15 +611,6 @@ subscribe linux-net in the message body to majordomo@vger.kernel.org -

Other

- -

- Perhaps some other distributions have similar facilities, - but these are the - only ones I know about so far. -

- -

Testing new features

Test programs

@@ -831,7 +824,7 @@ subscribe linux-net in the message body to majordomo@vger.kernel.org and to a small group of people (e.g., maintainers, translators) who like to get notification of *every* man-pages release. - I manually maintain a list of those people. + I (mtk) manually maintain a list of those people.

diff --git a/missing_pages.html b/missing_pages.html index 0bf561e..3e0f988 100644 --- a/missing_pages.html +++ b/missing_pages.html @@ -42,17 +42,19 @@ Linux man-pages:  

Manual pages that are missing from Linux man-pages

- Below is a list of pages that I would like - to see in the man-pages set. + Below is a list of pages that probably should be added + to the man-pages set. If you are thinking of writing one or more of these pages, then:

diff --git a/reporting_bugs.html b/reporting_bugs.html index 14d30c8..a0ca910 100644 --- a/reporting_bugs.html +++ b/reporting_bugs.html @@ -127,15 +127,11 @@ bugs | Simple one-line or two-line errors (typos, spelling, grammar, etc.), or HTML rendering problems in the online pages - can be reported by sending an email message to -
- - (Please do not CC my - email address.) - and CC - - (no HTML mail please), -
+ can be reported by sending an email message to the + maintainers + and CCing + + (no HTML mail please), Please do not report such bugs via the bugzilla. @@ -182,8 +178,8 @@ bugs |
  • - Send a message to - + Send a message to the + maintainers and CC .
    diff --git a/todo.html b/todo.html index e5c829b..02be10d 100644 --- a/todo.html +++ b/todo.html @@ -138,7 +138,7 @@ Linux man-pages:   2 page would need to be carried through to the Section 3 page; inevitably, inconsistencies will arise.
    - Note: I am doubtful that the problem noted in + Note: I (mtk) am doubtful that the problem noted in the above point could be resolved via some "include" mechanism that includes relevant pieces from the Section 2 page into the Section 3 page. -- cgit v1.2.3