[gentoo-commits] proj/devmanual:master commit in: general-concepts/news/

[gentoo-commits] proj/devmanual:master commit in: general-concepts/news/

[Markos Chandras]

commit:     c7a8133591a3ef0447e42121e347d7ded6511708
Author:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
AuthorDate: Sat Mar 17 10:06:48 2012 +0000
Commit:     Markos Chandras <hwoarang <AT> gentoo <DOT> org>
CommitDate: Sat Mar 17 10:04:44 2012 +0000
URL:        http://git.overlays.gentoo.org/gitweb/?p=proj/devmanual.git;a=commit;h=c7a81335

Update section on news items.

---
 general-concepts/news/text.xml |    6 +++---
 1 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/general-concepts/news/text.xml b/general-concepts/news/text.xml
index 77671fb..77c7f5f 100644
--- a/general-concepts/news/text.xml
+++ b/general-concepts/news/text.xml
@@ -27,9 +27,9 @@ read or delete news items can be found on the news.eselect man page.
     <li>Send the news item to the gentoo-dev mailing list and the Gentoo PR team (pr@gentoo.org) 72 hours in advance of commit.</li>
     <li>Wait for corrections or feedback that your news item is not of great importance and should be revoked (can be possible).</li>
     <li>Upon acceptance, create a detached armored GnuPG signature with gpg --local-user --detach-sign --armor YYYY-MM-DD-name.lang.txt</li>
-    <li>Create a directory structure for your item in the Gentoo News repository gentoo-news: YYYY (e.g. 2011 for a news item published in 2011).</li>
-    <li>Add both the signature and the news file to that directory.</li>
-    <li>Commit both items to the svn gentoo-news repository.</li>
+    <li>Create a directory structure for your item in the gentoo-news repository (<c>git+ssh://git@git.gentoo.org/proj/gentoo-news.git</c>): YYYY/YYYY-MM-DD-name/.</li>
+    <li>Add both the news file and the signature to that directory.</li>
+    <li>Commit and push your changes to the gentoo-news repository.</li>
 </ul>
 </p>
 </body>

[gentoo-commits] proj/devmanual:master commit in: general-concepts/news/

[Markos Chandras]

commit:     7bad4cc0f3172ff570b45a0e49721574b89b1216
Author:     Manuel Rüger <mrueg <AT> gentoo <DOT> org>
AuthorDate: Sun Mar 16 11:57:10 2014 +0000
Commit:     Markos Chandras <hwoarang <AT> gentoo <DOT> org>
CommitDate: Sun Mar 16 11:57:10 2014 +0000
URL:        http://git.overlays.gentoo.org/gitweb/?p=proj/devmanual.git;a=commit;h=7bad4cc0

Add a verification step for the signature

---
 general-concepts/news/text.xml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/general-concepts/news/text.xml b/general-concepts/news/text.xml
index 77c7f5f..b060a91 100644
--- a/general-concepts/news/text.xml
+++ b/general-concepts/news/text.xml
@@ -27,6 +27,7 @@ read or delete news items can be found on the news.eselect man page.
     <li>Send the news item to the gentoo-dev mailing list and the Gentoo PR team (pr@gentoo.org) 72 hours in advance of commit.</li>
     <li>Wait for corrections or feedback that your news item is not of great importance and should be revoked (can be possible).</li>
     <li>Upon acceptance, create a detached armored GnuPG signature with gpg --local-user --detach-sign --armor YYYY-MM-DD-name.lang.txt</li>
+    <li>Verify that your signature is correct with gpg --verify YYYY-MM-DD-name.lang.txt.asc YYYY-MM-DD-name.lang.txt</li>
     <li>Create a directory structure for your item in the gentoo-news repository (<c>git+ssh://git@git.gentoo.org/proj/gentoo-news.git</c>): YYYY/YYYY-MM-DD-name/.</li>
     <li>Add both the news file and the signature to that directory.</li>
     <li>Commit and push your changes to the gentoo-news repository.</li>

[gentoo-commits] proj/devmanual:master commit in: general-concepts/news/

[Markos Chandras]

commit:     7bad4cc0f3172ff570b45a0e49721574b89b1216
Author:     Manuel Rüger <mrueg <AT> gentoo <DOT> org>
AuthorDate: Sun Mar 16 11:57:10 2014 +0000
Commit:     Markos Chandras <hwoarang <AT> gentoo <DOT> org>
CommitDate: Sun Mar 16 11:57:10 2014 +0000
URL:        http://sources.gentoo.org/gitweb/?p=proj/devmanual.git;a=commit;h=7bad4cc0

Add a verification step for the signature

---
 general-concepts/news/text.xml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/general-concepts/news/text.xml b/general-concepts/news/text.xml
index 77c7f5f..b060a91 100644
--- a/general-concepts/news/text.xml
+++ b/general-concepts/news/text.xml
@@ -27,6 +27,7 @@ read or delete news items can be found on the news.eselect man page.
     <li>Send the news item to the gentoo-dev mailing list and the Gentoo PR team (pr@gentoo.org) 72 hours in advance of commit.</li>
     <li>Wait for corrections or feedback that your news item is not of great importance and should be revoked (can be possible).</li>
     <li>Upon acceptance, create a detached armored GnuPG signature with gpg --local-user --detach-sign --armor YYYY-MM-DD-name.lang.txt</li>
+    <li>Verify that your signature is correct with gpg --verify YYYY-MM-DD-name.lang.txt.asc YYYY-MM-DD-name.lang.txt</li>
     <li>Create a directory structure for your item in the gentoo-news repository (<c>git+ssh://git@git.gentoo.org/proj/gentoo-news.git</c>): YYYY/YYYY-MM-DD-name/.</li>
     <li>Add both the news file and the signature to that directory.</li>
     <li>Commit and push your changes to the gentoo-news repository.</li>

[gentoo-commits] proj/devmanual:master commit in: general-concepts/news/

[Justin Lecher]

commit:     14edbff75c9483cf61512907dd7c0304941b098b
Author:     Manuel Rüger <mrueg <AT> rueg <DOT> eu>
AuthorDate: Wed Aug 26 14:31:03 2015 +0000
Commit:     Justin Lecher <jlec <AT> gentoo <DOT> org>
CommitDate: Wed Aug 26 14:31:03 2015 +0000
URL:        https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=14edbff7

Update git repository URI

 general-concepts/news/text.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/general-concepts/news/text.xml b/general-concepts/news/text.xml
index de476a6..aabeec9 100644
--- a/general-concepts/news/text.xml
+++ b/general-concepts/news/text.xml
@@ -28,7 +28,7 @@ read or delete news items can be found on the news.eselect man page.
     <li>Wait for corrections or feedback that your news item is not of great importance and should be revoked (can be possible).</li>
     <li>Upon acceptance, create a detached armored GnuPG signature with gpg --local-user --detach-sign --armor YYYY-MM-DD-name.lang.txt</li>
     <li>Verify that your signature is correct with gpg --verify YYYY-MM-DD-name.lang.txt.asc YYYY-MM-DD-name.lang.txt</li>
-    <li>Create a directory structure for your item in the gentoo-news repository (<c>git+ssh://git@git.gentoo.org/proj/gentoo-news.git</c>): YYYY/YYYY-MM-DD-name/.</li>
+    <li>Create a directory structure for your item in the gentoo-news repository (<c>git+ssh://git@git.gentoo.org/data/gentoo-news.git</c>): YYYY/YYYY-MM-DD-name/.</li>
     <li>Add both the news file and the signature to that directory.</li>
     <li>Commit and push your changes to the gentoo-news repository.</li>
 </ul>

[gentoo-commits] proj/devmanual:master commit in: general-concepts/news/

[Ulrich Müller]

commit:     1ca9b99efeabac3522d976ea94caef5b6b227c5d
Author:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
AuthorDate: Tue Nov 28 22:50:30 2017 +0000
Commit:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
CommitDate: Tue Nov 28 22:50:30 2017 +0000
URL:        https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=1ca9b99e

general-concepts/news: Fix XML, rewrap long lines.

No text changes.

 general-concepts/news/text.xml | 59 ++++++++++++++++++++++++++++++------------
 1 file changed, 43 insertions(+), 16 deletions(-)

diff --git a/general-concepts/news/text.xml b/general-concepts/news/text.xml
index 2484ea8..2961084 100644
--- a/general-concepts/news/text.xml
+++ b/general-concepts/news/text.xml
@@ -5,14 +5,16 @@
 
 <body>
 <p>
-Gentoo News Items were created to provide a communication medium to push critical 
-messages to users via the rsync tree.  The original proposal for news items is outlined
-in <uri link="https://www.gentoo.org/glep/glep-0042.html">GLEP 42: Critical News Reporting.</uri>
+Gentoo News Items were created to provide a communication medium to push
+critical messages to users via the rsync tree. The original proposal for news
+items is outlined in <uri link="https://www.gentoo.org/glep/glep-0042.html">
+GLEP 42: Critical News Reporting.</uri>
 </p>
 
 <p>
-News Items can be read using the eselect command. More information on use of this tool to 
-read or delete news items can be found on the news.eselect man page.
+News Items can be read using the eselect command. More information on use
+of this tool to read or delete news items can be found on the news.eselect
+man page.
 </p>
 </body>
 
@@ -20,19 +22,44 @@ read or delete news items can be found on the news.eselect man page.
 <title>Adding a news item</title>
 <body>
 
-<p>
 <ul>
-    <li>Choose a file name in the proper format: YYYY-MM-DD-name.lang.txt, where the date is followed by a name (a-z, 0-9, + (plus), - (hyphen) and _ (underscore)), the two-letter ISO language code (en for English must be chosen as default) and the file extension txt.</li>
-    <li>Write the news item, which is similar to a RFC-compliant email. Details concerning what is allowed can be found in the appropriate GLEP section. As a note: Exceptions depending on installed packages or activated profiles is possible.</li>
-    <li>Send the news item to the gentoo-dev mailing list and the Gentoo PR team (pr@gentoo.org) 72 hours in advance of commit.</li>
-    <li>Wait for corrections or feedback that your news item is not of great importance and should be revoked (can be possible).</li>
-    <li>Upon acceptance, create a detached armored GnuPG signature with gpg --local-user --detach-sign --armor YYYY-MM-DD-name.lang.txt</li>
-    <li>Verify that your signature is correct with gpg --verify YYYY-MM-DD-name.lang.txt.asc YYYY-MM-DD-name.lang.txt</li>
-    <li>Create a directory structure for your item in the gentoo-news repository (<c>git+ssh://git@git.gentoo.org/data/gentoo-news.git</c>): YYYY/YYYY-MM-DD-name/.</li>
-    <li>Add both the news file and the signature to that directory.</li>
-    <li>Commit and push your changes to the gentoo-news repository.</li>
+  <li>
+    Choose a file name in the proper format: YYYY-MM-DD-name.lang.txt,
+    where the date is followed by a name (a-z, 0-9, + (plus), - (hyphen)
+    and _ (underscore)), the two-letter ISO language code (en for English
+    must be chosen as default) and the file extension txt.
+  </li>
+  <li>
+    Write the news item, which is similar to a RFC-compliant email. Details
+    concerning what is allowed can be found in the appropriate GLEP section.
+    As a note: Exceptions depending on installed packages or activated
+    profiles is possible.
+  </li>
+  <li>
+    Send the news item to the gentoo-dev mailing list and the Gentoo PR team
+    (pr@gentoo.org) 72 hours in advance of commit.
+  </li>
+  <li>
+    Wait for corrections or feedback that your news item is not of great
+    importance and should be revoked (can be possible).
+  </li>
+  <li>
+    Upon acceptance, create a detached armored GnuPG signature with
+    gpg --local-user --detach-sign --armor YYYY-MM-DD-name.lang.txt
+  </li>
+  <li>
+    Verify that your signature is correct with
+    gpg --verify YYYY-MM-DD-name.lang.txt.asc YYYY-MM-DD-name.lang.txt
+  </li>
+  <li>
+    Create a directory structure for your item in the gentoo-news repository
+    (<c>git+ssh://git@git.gentoo.org/data/gentoo-news.git</c>):
+    YYYY/YYYY-MM-DD-name/.
+  </li>
+  <li>Add both the news file and the signature to that directory.</li>
+  <li>Commit and push your changes to the gentoo-news repository.</li>
 </ul>
-</p>
+
 </body>
 </section>
 

[gentoo-commits] proj/devmanual:master commit in: general-concepts/news/

[Ulrich Müller]

commit:     c7d9fa9dbb2128425d4bfe1c7fa361b0ca48fdd5
Author:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
AuthorDate: Thu Dec 21 13:49:18 2017 +0000
Commit:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
CommitDate: Thu Dec 21 13:49:18 2017 +0000
URL:        https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=c7d9fa9d

general-concepts/news: Fix grammar.

 general-concepts/news/text.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/general-concepts/news/text.xml b/general-concepts/news/text.xml
index 2961084..d1af53e 100644
--- a/general-concepts/news/text.xml
+++ b/general-concepts/news/text.xml
@@ -33,7 +33,7 @@ man page.
     Write the news item, which is similar to a RFC-compliant email. Details
     concerning what is allowed can be found in the appropriate GLEP section.
     As a note: Exceptions depending on installed packages or activated
-    profiles is possible.
+    profiles are possible.
   </li>
   <li>
     Send the news item to the gentoo-dev mailing list and the Gentoo PR team

[gentoo-commits] proj/devmanual:master commit in: general-concepts/news/

[Ulrich Müller]

commit:     8db770b1f0bd7f06151cf4285077695583e285f0
Author:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
AuthorDate: Thu Dec 21 13:52:03 2017 +0000
Commit:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
CommitDate: Fri Dec 22 11:19:29 2017 +0000
URL:        https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=8db770b1

general-concepts/news: Bring in line with updated GLEP 42.

Acked-by: Göktürk Yüksek <gokturk <AT> gentoo.org>
Closes: https://bugs.gentoo.org/641928

 general-concepts/news/text.xml | 24 ++++++++++--------------
 1 file changed, 10 insertions(+), 14 deletions(-)

diff --git a/general-concepts/news/text.xml b/general-concepts/news/text.xml
index d1af53e..06b5866 100644
--- a/general-concepts/news/text.xml
+++ b/general-concepts/news/text.xml
@@ -24,10 +24,14 @@ man page.
 
 <ul>
   <li>
-    Choose a file name in the proper format: YYYY-MM-DD-name.lang.txt,
-    where the date is followed by a name (a-z, 0-9, + (plus), - (hyphen)
-    and _ (underscore)), the two-letter ISO language code (en for English
-    must be chosen as default) and the file extension txt.
+    Choose a filename in the proper format:
+    <c>YYYY-MM-DD-shortname.lang.txt</c>, i.e. the date, followed by a very
+    short name of at most 20 characters and consisting only of <c>a-z</c>,
+    <c>0-9</c>, <c>+</c> (plus), <c>-</c> (hyphen) and <c>_</c> (underscore).
+    This is followed by <c>lang</c> which is an
+    <uri link="https://tools.ietf.org/rfc/bcp/bcp47.txt">IETF language
+    tag</uri>. Always use <c>en</c> for English, unless you are translating
+    a news item. Finally, the filename ends with the extension <c>txt</c>.
   </li>
   <li>
     Write the news item, which is similar to a RFC-compliant email. Details
@@ -44,19 +48,11 @@ man page.
     importance and should be revoked (can be possible).
   </li>
   <li>
-    Upon acceptance, create a detached armored GnuPG signature with
-    gpg --local-user --detach-sign --armor YYYY-MM-DD-name.lang.txt
-  </li>
-  <li>
-    Verify that your signature is correct with
-    gpg --verify YYYY-MM-DD-name.lang.txt.asc YYYY-MM-DD-name.lang.txt
-  </li>
-  <li>
     Create a directory structure for your item in the gentoo-news repository
     (<c>git+ssh://git@git.gentoo.org/data/gentoo-news.git</c>):
-    YYYY/YYYY-MM-DD-name/.
+    <c>YYYY-MM-DD-shortname/</c>.
   </li>
-  <li>Add both the news file and the signature to that directory.</li>
+  <li>Add the news file to that directory.</li>
   <li>Commit and push your changes to the gentoo-news repository.</li>
 </ul>