docs January 2014

docs@lists.stg.fedoraproject.org

22 participants
51 discussions

[PATCH 1/3] Security Guide: Remove references in Kerberos.xml to versions in package documentation directories
by Simon Clark 07 Feb '14

07 Feb '14

Following instructions in https://fedoraproject.org/wiki/Changes/UnversionedDocdirs remove all references to the version number from the per package documentation directory in /usr/share/doc leaving just the package's name. --- en-US/Kerberos.xml | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/en-US/Kerberos.xml b/en-US/Kerberos.xml index e15b872..572142d 100644 --- a/en-US/Kerberos.xml +++ b/en-US/Kerberos.xml @@ -285,7 +285,7 @@ Approximate clock synchronization between the machines on the network. </para> <para> - A clock synchronization program should be set up for the network, such as <command>ntpd</command>. Refer to <filename>/usr/share/doc/ntp-<replaceable><version-number></replaceable>/index.html</filename> for details on setting up Network Time Protocol servers (where <replaceable><version-number></replaceable> is the version number of the <filename>ntp</filename> package installed on your system). + A clock synchronization program should be set up for the network, such as <command>ntpd</command>. Refer to <filename>/usr/share/doc/ntp/index.html</filename> for details on setting up Network Time Protocol servers. </para> </listitem> <listitem> @@ -293,7 +293,7 @@ Domain Name Service (DNS). </para> <para> - You should ensure that the DNS entries and hosts on the network are all properly configured. Refer to the <citetitle>Kerberos V5 System Administrator's Guide</citetitle> in <filename>/usr/share/doc/krb5-server-<replaceable><version-number></replaceable></filename> for more information (where <replaceable><version-number></replaceable> is the version number of the <filename>krb5-server</filename> package installed on your system). + You should ensure that the DNS entries and hosts on the network are all properly configured. Refer to the <citetitle>Kerberos V5 System Administrator's Guide</citetitle> in <filename>/usr/share/doc/krb5-server/</filename> for more information. </para> </listitem> </itemizedlist> @@ -328,7 +328,7 @@ Ensure that time synchronization and DNS are functioning correctly on all client and server machines before configuring Kerberos. Pay particular attention to time synchronization between the Kerberos server and its clients. If the time difference between the server and client is greater than five minutes (this is configurable in Kerberos 5), Kerberos clients can not authenticate to the server. This time synchronization is necessary to prevent an attacker from using an old Kerberos ticket to masquerade as a valid user. </para> <para> - It is advisable to set up a Network Time Protocol (NTP) compatible client/server network even if Kerberos is not being used. &PRODUCT; includes the <filename>ntp</filename> package for this purpose. Refer to <filename>/usr/share/doc/ntp-<replaceable>version-number</replaceable>/index.html</filename> (where <replaceable>version-number</replaceable> is the version number of the <filename>ntp</filename> package installed on your system) for details about how to set up Network Time Protocol servers, and <ulink url="http://www.ntp.org">http://www.ntp.org</ulink> for more information about NTP. + It is advisable to set up a Network Time Protocol (NTP) compatible client/server network even if Kerberos is not being used. &PRODUCT; includes the <filename>ntp</filename> package for this purpose. Refer to <filename>/usr/share/doc/ntp/index.html</filename> for details about how to set up Network Time Protocol servers, and <ulink url="http://www.ntp.org">http://www.ntp.org</ulink> for more information about NTP. </para> </step> <step> @@ -759,12 +759,12 @@ Entry for principal host/slavekdc.example.com with kvno 3, encryption type DES c <itemizedlist> <listitem> <para> - The <citetitle>Kerberos V5 Installation Guide</citetitle> and the <citetitle>Kerberos V5 System Administrator's Guide</citetitle> in PostScript and HTML formats. These can be found in the <filename>/usr/share/doc/krb5-server-<replaceable><version-number></replaceable>/</filename> directory (where <replaceable><version-number></replaceable> is the version number of the <command>krb5-server</command> package installed on your system). + The <citetitle>Kerberos V5 Installation Guide</citetitle> and the <citetitle>Kerberos V5 System Administrator's Guide</citetitle> in PostScript and HTML formats. These can be found in the <filename>/usr/share/doc/krb5-server/</filename> directory. </para> </listitem> <listitem> <para> - The <citetitle>Kerberos V5 UNIX User's Guide</citetitle> in PostScript and HTML formats. These can be found in the <filename>/usr/share/doc/krb5-workstation-<replaceable><version-number></replaceable>/</filename> directory (where <replaceable><version-number></replaceable> is the version number of the <command>krb5-workstation</command> package installed on your system). + The <citetitle>Kerberos V5 UNIX User's Guide</citetitle> in PostScript and HTML formats. These can be found in the <filename>/usr/share/doc/krb5-workstation/</filename> directory. </para> </listitem> <listitem>

2 3

Anaconda Addon Development Guide
by Vratislav Podzimek 04 Feb '14

04 Feb '14

Hello everybody, my name is Vratislav Podzimek and I am a member of the Anaconda installer team. The Anaconda installer now supports third-party extensions called addons and I have written a guide for implementation, deployment and testing of such addon. Now I would like this guide to be included as part of the official Fedora project documentation suite. Could anyone please tell me which steps are needed for that to happen? The guide is here: http://vpodzime.fedorapeople.org/anaconda-addon-development-guide/ with the sources here: https://github.com/vpodzime/anaconda-addon-development-guide Thanks, -- Vratislav Podzimek Anaconda Rider | Red Hat, Inc. | Brno - Czech Republic

3 5

[PATCH 3/3] Security Guide: Remove references in Tcp_Wrappers.xml to version numbers in package documentation directories
by Simon Clark 31 Jan '14

31 Jan '14

1 0

[PATCH 2/3] Security Guide: Remove references in Pam.xml to version numbers in package documentation directories
by Simon Clark 31 Jan '14

31 Jan '14

1 0

[PATCH 3/3] Packagers Guide: Remove Spec_File_Reference.pot references to versions in package documentation directories
by Simon Clark 31 Jan '14

31 Jan '14

1 0

[PATCH 2/3] Packagers Guide: Remove Spec_File_Reference.xml references to versions in package documentation directories
by Simon Clark 31 Jan '14

31 Jan '14

1 0

[PATCH 1/3] Packagers Guide: Remove Creating_and_Building_Packages.xml references to versions in package documentation directories
by Simon Clark 31 Jan '14

31 Jan '14

1 0

Source string contextualization
by Nilamdyuti Goswami 30 Jan '14

30 Jan '14

Hi all, While translating some of the fedora packages we often come across some source strings whose context or meaning is not clear. This results in wrong translations which is discovered later while using the actual application. This in turn effects the concerned application. To solve this issue, we have formed a Fedora SIG named "Source String Contextualizing Group" [1] aimed at providing concise yet meaningful description of the concerned source strings in the source code itself to ensure the correctness and quality in the resulting translations. We welcome feedback and suggestions. Regards, Nilamdyuti Goswami [1]: https://fedoraproject.org/wiki/SSCG

4 6

[PATCH 3/3] Musicians Guide: Remove LilyPond.xml references to versions in package documentation directories
by Simon Clark 28 Jan '14

28 Jan '14

1 0

[PATCH 2/3] Musician's Guide: Remove Frescobaldi.xml references to versions in package documentation directories
by Simon Clark 28 Jan '14

28 Jan '14

Following instructions in https://fedoraproject.org/wiki/Changes/UnversionedDocdirs remove the version number from all references to the per package documentation directory in /usr/share/doc leaving just the package's name. --- en-US/Frescobaldi.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/en-US/Frescobaldi.xml b/en-US/Frescobaldi.xml index 7cabe7f..97fa91e 100644 --- a/en-US/Frescobaldi.xml +++ b/en-US/Frescobaldi.xml @@ -69,7 +69,7 @@ <listitem><para>You can change "LilyPond documentation" if you don't want the right-side-bar "LilyPond Documentation" thing to internet it every time <itemizedlist> <listitem><para>install the 'lilypond-doc' package (it's 44 MB)</para></listitem> - <listitem><para>put "/usr/share/doc/lilypond-doc-2.12.2/index.html" in the field (or in another language if that's what you want)</para></listitem> + <listitem><para>put "/usr/share/doc/lilypond-doc/index.html" in the field (or in another language if that's what you want)</para></listitem> <listitem><para>this will need to be updated when LilyPond is updated; if you don't update it, then the built-in "LilyPond Documentation" tab will simply show up blank, instead of with the user guide - so it's harmless if you forget to update</para></listitem> </itemizedlist> </para></listitem>

1 0

2024

2023

2022

2021

2020

2019

2018

2017

2016

2015

2014

2013

2012

2011

2010

2009

2008

2007

2006

2005

2004

2003

2002

docs January 2014