bug-gnulib
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Slight typographical improvements to README-release


From: Jim Meyering
Subject: Re: Slight typographical improvements to README-release
Date: Tue, 29 May 2012 11:24:42 +0200

Reuben Thomas wrote:
> The following makes README-release slightly easier to read, in
> particular tweaking a Savannah instruction.
>
>>From b5e8e05c3c1f112f5fdb96a826b8d0cba0588459 Mon Sep 17 00:00:00 2001
> From: Reuben Thomas <address@hidden>
> Date: Tue, 29 May 2012 09:09:28 +0100
> Subject: [PATCH] README-release: make it more legible
>
> * top/README-release: improve typography slightly.
> ---
>  ChangeLog          |    5 +++++
>  top/README-release |   12 +++++++++---
>  2 files changed, 14 insertions(+), 3 deletions(-)
>
> diff --git a/ChangeLog b/ChangeLog
> index 647c832..2453b7e 100644
> --- a/ChangeLog
> +++ b/ChangeLog
> @@ -1,3 +1,8 @@
> +2012-05-29  Reuben Thomas  <address@hidden>
> +
> +     README-release: make it more legible
> +     * top/README-release: improve typography slightly.
> +
>  2012-05-27  Paul Eggert  <address@hidden>
>
>       manywarnings: remove duplicate -Wmultichar entry
> diff --git a/top/README-release b/top/README-release
> index 29ba260..b4f6793 100644
> --- a/top/README-release
> +++ b/top/README-release
> @@ -68,11 +68,16 @@ Once all the builds and tests have passed,
>    announcement link in the email message.
>
>    From here:
> +
>      https://savannah.gnu.org/projects/@PACKAGE@/
> -  click on "submit news", then write something like the following:
> +
> +  click on "News→Submit", then write something like the following:
>    (If there is no such button, then enable "News" for the project via
> -   the Main -> "Select Features" menu item, or via this link:
> -   https://savannah.gnu.org/project/admin/address@hidden@)
> +  the "Main→Select Features" menu item, or via this link:
> +
> +    https://savannah.gnu.org/project/admin/address@hidden@
> +
> +  )

Thanks, inserting newlines is fine, but I'd rather avoid the non-ascii arrows.
BTW, there is a "Submit News" button on a project's front page.
(at least when the NEWS feature is enabled)

That parenthetical NEWS-related section is too long for my taste,
so I propose to move it into a footnote.  What do you think of
my squashing the following addition into your patch?
Also, I found a direct "submit news" URL, so with this
there's one less visual-search-and-click required.

>From 78a91bca1e8e7427d524bbbbaec13745b9d46426 Mon Sep 17 00:00:00 2001
From: Jim Meyering <address@hidden>
Date: Tue, 29 May 2012 11:12:11 +0200
Subject: [PATCH] move news-what-if into footnote; use "->", not UTF8
 right-arrow

---
 top/README-release | 21 ++++++++++-----------
 1 file changed, 10 insertions(+), 11 deletions(-)

diff --git a/top/README-release b/top/README-release
index b4f6793..9eddf62 100644
--- a/top/README-release
+++ b/top/README-release
@@ -65,19 +65,11 @@ Once all the builds and tests have passed,
     git push origin master tag v$v

 * Announce it on Savannah first, so you can include the savannah.org
-  announcement link in the email message.
+  announcement link in the email message.  Visit this page:[1]

-  From here:
+    https://savannah.gnu.org/news/address@hidden@

-    https://savannah.gnu.org/projects/@PACKAGE@/
-
-  click on "News→Submit", then write something like the following:
-  (If there is no such button, then enable "News" for the project via
-  the "Main→Select Features" menu item, or via this link:
-
-    https://savannah.gnu.org/project/admin/address@hidden@
-
-  )
+  and write something like the following:

     Subject: @address@hidden released [stable]
     +verbatim+
@@ -97,3 +89,10 @@ Once all the builds and tests have passed,
   by running this:

     build-aux/gnu-web-doc-update
+
+-----
+[1] When adding a news item, use the link above or select the
+News->Submit menu item from https://savannah.gnu.org/projects/@PACKAGE@/
+If there is no such item, then enable "News" for the project via the
+"Main->Select Features" menu item, or via this link:
+https://savannah.gnu.org/project/admin/address@hidden@
--
1.7.10.2.605.gbefc5ed



reply via email to

[Prev in Thread] Current Thread [Next in Thread]