diff --git a/docs/source/simplesamlphp-changelog.xml b/docs/source/simplesamlphp-changelog.xml index 8d58695cfd0d3e1e2784cc54bb1d468c2da9641c..a1e4be7db3e5382092123bf014e2c98fbbded4a2 100644 --- a/docs/source/simplesamlphp-changelog.xml +++ b/docs/source/simplesamlphp-changelog.xml @@ -4,12 +4,6 @@ <article> <title>simpleSAMLphp changelog</title> - <section> - <title>History</title> - - <para></para> - </section> - <section> <title>Change log</title> @@ -19,7 +13,7 @@ <section> <title>Version 1.1</title> - <para>Released 2008-06-??. Revision ???.</para> + <para>Released 2008-06-19. Revision 673.</para> <para>When upgrading to version 1.1 from version 1.0, you should update the configuration files. Many options have been added, and some have @@ -36,6 +30,10 @@ IdP choice they make in the discovery service, will not work without updating the templates.</para> + <para>New localizations in version 1.1: Sami, Svenska (swedish), + Suomeksi (finnish), Nederlands, Luxembourgish, Slovenian, Hrvatski + (Croatian), Magyar (Hungarian).</para> + <section> <title>New features</title> @@ -129,8 +127,8 @@ </listitem> <listitem> - <para>Add support for overriding autogenerated metadata - values, such as the <literal>AssertionConsumerService</literal> + <para>Add support for overriding autogenerated metadata values, + such as the <literal>AssertionConsumerService</literal> address.</para> </listitem> @@ -171,8 +169,8 @@ </listitem> <listitem> - <para>CAS authentication module: Add support for getting attributes - from response by specifying XPath mappings.</para> + <para>CAS authentication module: Add support for getting + attributes from response by specifying XPath mappings.</para> </listitem> <listitem> @@ -200,7 +198,8 @@ </listitem> <listitem> - <para>Major improvements to the Feide authentication module.</para> + <para>Major improvements to the Feide authentication + module.</para> </listitem> <listitem> @@ -247,8 +246,8 @@ </listitem> <listitem> - <para>Ensure that changed sessions with changed SP associations are - written to memcache.</para> + <para>Ensure that changed sessions with changed SP associations + are written to memcache.</para> </listitem> <listitem> @@ -281,7 +280,6 @@ </section> </section> - <section> <title>Version 1.0</title> @@ -426,4 +424,10 @@ </itemizedlist> </section> </section> + + <section> + <title>The history of simpleSAMLphp</title> + + <para>TODO.</para> + </section> </article> \ No newline at end of file diff --git a/docs/source/simplesamlphp-idp.xml b/docs/source/simplesamlphp-idp.xml index 84cfa7b8e993e16e8a315c94680731f35be9f299..33ee032e3ed01b1ae8d3274f8dfe1aea8eb012d2 100644 --- a/docs/source/simplesamlphp-idp.xml +++ b/docs/source/simplesamlphp-idp.xml @@ -7,7 +7,7 @@ <articleinfo> <date>2007-10-15</date> - <pubdate>Tue Jun 3 12:15:38 2008</pubdate> + <pubdate>Thu Jun 19 08:20:30 2008</pubdate> <author> <firstname>Andreas Ă…kre</firstname> diff --git a/docs/source/simplesamlphp-maintenance.xml b/docs/source/simplesamlphp-maintenance.xml index c1643be3841532ed381b1ba5a9f2e22d4942e412..7cfdcff78a63113875005585f8978c53fb3ddf88 100644 --- a/docs/source/simplesamlphp-maintenance.xml +++ b/docs/source/simplesamlphp-maintenance.xml @@ -7,7 +7,7 @@ <articleinfo> <date>2007-08-30</date> - <pubdate>Tue Jun 3 12:14:40 2008</pubdate> + <pubdate>Thu Jun 19 08:34:38 2008</pubdate> <author> <firstname>Andreas Ă…kre</firstname> @@ -19,7 +19,7 @@ </articleinfo> <warning> - <para>This document still in the writing stage.</para> + <para>This document is still in progress.</para> </warning> <section> @@ -49,8 +49,8 @@ <para>The <literal>session.handler</literal> configuration option in <filename>config.php</filename> allows you to select which session handler - SimpleSAMLphp should use to store the session information. Currently, - two session handlers are included in the distribution:</para> + SimpleSAMLphp should use to store the session information. Currently, two + session handlers are included in the distribution:</para> <itemizedlist> <listitem> @@ -259,8 +259,8 @@ <listitem> <para>If you during testing have been using a certificate that has - been exposed (notably: the one found in the simpleSAMLphp distribution): - Obtain and install a new one.</para> + been exposed (notably: the one found in the simpleSAMLphp + distribution): Obtain and install a new one.</para> </listitem> <listitem> @@ -291,73 +291,69 @@ <section> <title>Multi-language support</title> - <para>To add support for a new language, add your new language to the - <literal>language.available</literal> configuration parameter in - <filename>config.php</filename>:</para> - - <programlisting> /* + <para>To add support for a new language, add your new language to the + <literal>language.available</literal> configuration parameter in + <filename>config.php</filename>:</para> + + <programlisting> /* * Languages available and which language is default */ 'language.available' => array('en', 'no', 'da', 'es', 'xx'), 'language.default' => 'en',</programlisting> - - <para>Please use the standarized two-character <ulink - url="http://en.wikipedia.org/wiki/List_of_ISO_639-1_codes">language codes - as specified in ISO-639-1</ulink>.</para> - - <para>You also can set the default language. You should ensure - that the default language is complete, as it is used as a fallback when - a text is not available in the language selected by the user.</para> - - <tip> - <para>This may change in the future. We may distinguish between the - fallback-lanauge (which is usually English) and the default language.</para> - </tip> - - <para>All strings that can - be localized are found in the files <filename>dictionaries/</filename>. - Add a new entry for each string, with your language code, like - this:</para> - - <programlisting>'user_pass_header' => array( + + <para>Please use the standarized two-character <ulink + url="http://en.wikipedia.org/wiki/List_of_ISO_639-1_codes">language codes + as specified in ISO-639-1</ulink>.</para> + + <para>You also can set the default language. You should ensure that the + default language is complete, as it is used as a fallback when a text is + not available in the language selected by the user.</para> + + <tip> + <para>This may change in the future. We may distinguish between the + fallback-lanauge (which is usually English) and the default + language.</para> + </tip> + + <para>All strings that can be localized are found in the files + <filename>dictionaries/</filename>. Add a new entry for each string, with + your language code, like this:</para> + + <programlisting>'user_pass_header' => array( 'en' => 'Enter your username and password', 'no' => 'Skriv inn brukernavn og passord', 'xx' => 'Pooa jujjique jamba', ),</programlisting> - - <para>You can translate as many of the texts as you would like; a full translation is - not required unless you want to make this the default language. From the end users - point of view, it looks best if all text fragments used in a given screen or form - is in one single language. - </para> - - <para>Note that themes used for customization of the web frontend (see below) - also may contain language specific texts which you would like to include in your - translation. Language independent themes may be created by putting all theme - texts in a file in the <filename>dictionaries</filename> directory. - </para> + <para>You can translate as many of the texts as you would like; a full + translation is not required unless you want to make this the default + language. From the end users point of view, it looks best if all text + fragments used in a given screen or form is in one single language.</para> + + <para>Note that themes used for customization of the web frontend (see + below) also may contain language specific texts which you would like to + include in your translation. Language independent themes may be created by + putting all theme texts in a file in the <filename>dictionaries</filename> + directory.</para> </section> <section> <title>Customizing the web frontend with themes</title> <para>All XHTML templates are stored in the - <filename>templates/</filename> directory, one - subdirectory for each theme. The default theme is named - <literal>default</literal>. An sample theme is provided, named - <literal>feidernd</literal>.</para> + <filename>templates/</filename> directory, one subdirectory for each + theme. The default theme is named <literal>default</literal>. An sample + theme is provided, named <literal>feidernd</literal>.</para> <para>It is possible to define a new theme, where only some of the pages - are customized. For the rest of the pages, the default theme is used. - The <literal>feidernd</literal> theme is a good example of this: - Only the login page is customized.</para> + are customized. For the rest of the pages, the default theme is used. The + <literal>feidernd</literal> theme is a good example of this: Only the + login page is customized.</para> - <para>In <filename>config.php</filename> you specify the theme to use, - as well as a theme base. The theme base is the fallback - theme that should be used when the selected theme does not include the - specific template needed to render a page. Here is an example of a - configuration:</para> + <para>In <filename>config.php</filename> you specify the theme to use, as + well as a theme base. The theme base is the fallback theme that should be + used when the selected theme does not include the specific template needed + to render a page. Here is an example of a configuration:</para> <programlisting> /* * Which theme directory should be used? The base is fallback (leave it to default). @@ -368,20 +364,20 @@ <important> <para>The feidernd theme is based on the wordpress login form style. Feel free to use this as a base for making your own login form. However: - Please do not use the feidernd theme unmodified - it contains the - Feide logo, which of course should be used to identify Feide services, - not services provided by your institution.</para> + Please do not use the feidernd theme unmodified - it contains the Feide + logo, which of course should be used to identify Feide services, not + services provided by your institution.</para> </important> </section> - + <section> <title>Support</title> - <para>If you need help to make this work, or want to discuss - simpleSAMLphp with other users of the software you are fortunate: Around - simpleSAMLphp there is a great Open source community, and you are welcome - to join! Both for asking question, answer other questions, request - improvements or contribute with code or plugins of your own.</para> + <para>If you need help to make this work, or want to discuss simpleSAMLphp + with other users of the software you are fortunate: Around simpleSAMLphp + there is a great Open source community, and you are welcome to join! Both + for asking question, answer other questions, request improvements or + contribute with code or plugins of your own.</para> <itemizedlist> <listitem> diff --git a/docs/source/simplesamlphp-sp.xml b/docs/source/simplesamlphp-sp.xml index d3860e8920cc935d1bf76c630d431a6756381492..cd35ea73d59a8f3089010c83e38996692fcd573f 100644 --- a/docs/source/simplesamlphp-sp.xml +++ b/docs/source/simplesamlphp-sp.xml @@ -7,7 +7,7 @@ <articleinfo> <date>2007-10-15</date> - <pubdate>Fri Jun 6 00:43:25 2008</pubdate> + <pubdate>Thu Jun 19 08:35:05 2008</pubdate> <author> <firstname>Andreas Ă…kre</firstname> @@ -18,12 +18,6 @@ </author> </articleinfo> - <note> - <para>This document is in progress of being updated to correspond to - simpleSAMLphp version 1.0. simpleSAMLphp version 1.0 is scheduled to be - released in March 2008.</para> - </note> - <section> <title>simpleSAMLphp documentation</title> @@ -805,9 +799,9 @@ <glossterm>icon</glossterm> <glossdef> - <para>An icon for this IdP. This is a URL to a icon which will - be displayed next to this IdP in the IdP discovery service. The - URL can be absolute or relative. If it is relative, it will be + <para>An icon for this IdP. This is a URL to a icon which will be + displayed next to this IdP in the IdP discovery service. The URL + can be absolute or relative. If it is relative, it will be relative to the simpleSAMPphp www-directory. This field is optional.</para> </glossdef>