Skip to content

Commit

Permalink
Admin Guide: Fix broken links and obsolete info
Browse files Browse the repository at this point in the history 
Fixes #26617
  • Loading branch information
@dregad
dregad committed Mar 28, 2020
2 parents c2d6c3d + ed33487 commit 32e4728
Show file tree
Hide file tree
Showing 29 changed files with 96 additions and 101 deletions.
26 changes: 13 additions & 13 deletions docbook/Admin_Guide/en-US/About.xml
View file
Expand Up @@ -42,10 +42,10 @@

<para>
MantisBT is released under the terms of
<ulink url="http://www.gnu.org/copyleft/gpl.html">GNU General
<ulink url="https://www.gnu.org/copyleft/gpl.html">GNU General
Public License (GPL)</ulink>. MantisBT is free to use and modify.
It is free to redistribute as long as you abide by the distribution
terms of the <ulink url="http://www.gnu.org/copyleft/gpl.html">GPL</ulink>.
terms of the <ulink url="https://www.gnu.org/copyleft/gpl.html">GPL</ulink>.
</para>
</section>

Expand All @@ -59,14 +59,14 @@
has a package for MantisBT. If not, or if the package is
not up-to-date with the latest MantisBT version, then you may want
to download it directly from
<ulink url="http://www.mantisbt.org/download.php">here</ulink>.
<ulink url="https://mantisbt.org/download.php">here</ulink>.
</para>

<para>
For Windows, macOS and other operating systems, use the link provided
above to download MantisBT. The download is compressed in tar.gz
or zip format. Both formats can be unpacked using tools like
<ulink url="http://www.7-zip.org/">7-Zip</ulink> (in case of Windows).
<ulink url="https://www.7-zip.org/">7-Zip</ulink> (in case of Windows).
</para>


Expand Down Expand Up @@ -136,7 +136,7 @@
<itemizedlist>
<listitem>
<para>
<ulink url="http://www.mantisbt.org/forums/">Forums</ulink> - The
<ulink url="https://mantisbt.org/forums/">Forums</ulink> - The
forums are one of the most popular destinations for getting
MantisBT support. Start off by searching the forums for your
questions, if not found, then go ahead and submit a question.
Expand Down Expand Up @@ -182,7 +182,7 @@
</listitem>
<listitem>
<para>
<ulink url="http://www.mantisbt.org">Wiki</ulink> - The
<ulink url="https://mantisbt.org/wiki/doku.php/mantisbt:start">Wiki</ulink> - The
MantisBT Wiki has information related to "How To (recipes)",
FAQ, feature requirements, plugins etc.
</para>
Expand All @@ -193,8 +193,8 @@
or finding more information about a topic is to search across
all MantisBT website and the Internet via your favorite
search engine, e.g.
<ulink url="http://www.google.com">Google</ulink> or
<ulink url="http://www.bing.com">Bing</ulink>.
<ulink url="https://www.google.com">Google</ulink> or
<ulink url="https://www.bing.com">Bing</ulink>.
</para>
</listitem>
</itemizedlist>
Expand All @@ -203,7 +203,7 @@
<para>Support questions should not be sent directly to MantisBT
developers or through the MantisBT website's contact pages.
</para>
<para>Also, our <ulink url="http://mantisbt.org/bugs/">bug tracker</ulink>
<para>Also, our <ulink url="https://mantisbt.org/bugs/">bug tracker</ulink>
is reserved for reporting issues with the software, and
<emphasis>must not be used for support requests</emphasis>.
</para></note>
Expand All @@ -221,23 +221,23 @@
<listitem>
<para>
We send release announcements and important updates to users registered
on our <ulink url="http://www.mantisbt.org/bugs">official bugtracker</ulink>.
on our <ulink url="https://mantisbt.org/bugs">official bugtracker</ulink>.
To get onto our mailing list, users will have to signup there and verify
their email address. This same account can also be used to report, monitor,
and comment on issues relating to MantisBT.
</para>
</listitem>
<listitem>
<para>
<ulink url="http://www.mantisbt.org/blog/">MantisBT Blog</ulink>
<ulink url="https://mantisbt.org/blog/">MantisBT Blog</ulink>
is used to communicate announcements about new releases, topics
relating to MantisBT, etc. Users are encouraged to subscribe to
the RSS feed to know when new posts are posted there.
</para>
</listitem>
<listitem>
<para>
<ulink url="http://twitter.com/mantisbt">Twitter</ulink> is used to
<ulink url="https://twitter.com/mantisbt">Twitter</ulink> is used to
notify users about up-to-date details about what is happening with MantisBT development.
Twitter users are encouraged to follow "@mantisbt".
</para>
Expand All @@ -250,7 +250,7 @@

<para>
Our release numbering convention follows the guidelines of
<ulink url="http://semver.org/">Semantic Versioning</ulink>.
<ulink url="https://semver.org/">Semantic Versioning</ulink>.
Given a version number <emphasis>Major.Minor.Patch</emphasis>
and an optional <emphasis>Suffix</emphasis> (eg. 1.3.0-rc.1):
</para>
Expand Down
6 changes: 3 additions & 3 deletions docbook/Admin_Guide/en-US/Authentication.xml
View file
Expand Up @@ -21,8 +21,8 @@
<para>Note: while technically unlimited, the password's length is arbitrarily restricted to 1024 characters (PASSWORD_MAX_SIZE_BEFORE_HASH constant).</para>
<para>Values for $g_login_method:
<itemizedlist>
<listitem><para><emphasis><ulink url="http://en.wikipedia.org/wiki/MD5">MD5</ulink></emphasis> is the default - and recommended - method</para></listitem>
<listitem><para>Support for additional methods (e.g. <ulink url="http://en.wikipedia.org/wiki/SHA-1">SHA-1</ulink>) could be added in the future</para></listitem>
<listitem><para><emphasis><ulink url="https://en.wikipedia.org/wiki/MD5">MD5</ulink></emphasis> is the default method</para></listitem>
<listitem><para>Support for additional methods could be added in the future</para></listitem>
</itemizedlist>
</para>

Expand All @@ -32,7 +32,7 @@
<title>LDAP and Microsoft Active Directory</title>

<para>Value for $g_login_method: <emphasis>LDAP</emphasis></para>
<para>Authentication is made against an <ulink url="http://en.wikipedia.org/wiki/LDAP">LDAP</ulink> or <ulink url="http://en.wikipedia.org/wiki/Active_Directory">Active Directory</ulink> server.</para>
<para>Authentication is made against an <ulink url="https://en.wikipedia.org/wiki/LDAP">LDAP</ulink> or <ulink url="https://en.wikipedia.org/wiki/Active_Directory">Active Directory</ulink> server.</para>
<para>The LDAP parameters should be setup as explained in <xref linkend="admin.config.auth.ldap" />.</para>
<para>An MD5 hash of the user's password will be stored in the database upon successful login, allowing fall-back to Standard Authentication when the LDAP server is not available.</para>
<para>The user's ID and password is checked against the Directory; if the credentials are valid, then the user is allowed to login and their user account in MantisBT is created automatically.</para>
Expand Down
12 changes: 6 additions & 6 deletions docbook/Admin_Guide/en-US/Customizing.xml
View file
Expand Up @@ -126,7 +126,7 @@ $s_CODE = STRING;
<para>Caption variable name.
This value is supplied to the lang_get() API; it is
therefore mandatory to set this to a
<ulink url="http://php.net/language.variables.basics.php">valid PHP identifier</ulink>
<ulink url="https://www.php.net/language.variables.basics.php">valid PHP identifier</ulink>
(i.e. only letters, numbers and underscores; no spaces)
if you intend to translate the field label
(see <xref linkend="admin.customize.customfields.localize" />).
Expand Down Expand Up @@ -171,7 +171,7 @@ $s_CODE = STRING;
</para>
</listitem>
<listitem>
<para>Regular expression to use for validating user input (use <ulink url="http://www.php.net/manual/en/reference.pcre.pattern.syntax.php">PCRE syntax</ulink>).
<para>Regular expression to use for validating user input (use <ulink url="https://www.php.net/manual/en/reference.pcre.pattern.syntax.php">PCRE syntax</ulink>).
</para>
</listitem>
<listitem>
Expand Down Expand Up @@ -343,7 +343,7 @@ $s_CODE = STRING;
<para>Define the custom field
(see <xref linkend="admin.customize.customfields.definitions" />),
keeping in mind that its name must be a
<ulink url="http://php.net/language.variables.basics.php">valid PHP identifier</ulink>.
<ulink url="https://www.php.net/language.variables.basics.php">valid PHP identifier</ulink>.
</para>
<para>As an example, we will use
<emphasis>my_start_date</emphasis>
Expand Down Expand Up @@ -408,16 +408,16 @@ switch( $g_active_language ) {
</para>
<para>The format for specific dates is an integer which
indicates the number of seconds since the
<ulink url="http://en.wikipedia.org/wiki/Unix_time">
<ulink url="https://en.wikipedia.org/wiki/Unix_time">
Unix Epoch</ulink> (January 1 1970 00:00:00 UTC),
which is the format consumed by the PHP
<ulink url="http://www.php.net/date">date()</ulink> method.
<ulink url="https://www.php.net/date">date()</ulink> method.
</para>
<para>The relative scenario expects default values like
{tomorrow}, {yesterday}, {+2 days}, {-3 days}, {next week}, etc.
The curly brackets indicate that this is a logical value
which is then evaluated using the PHP
<ulink url="http://www.php.net/strtotime">strtotime()</ulink>
<ulink url="https://www.php.net/strtotime">strtotime()</ulink>
function.
</para>
</section>
Expand Down
22 changes: 11 additions & 11 deletions docbook/Admin_Guide/en-US/Installation.xml
View file
Expand Up @@ -137,7 +137,7 @@
<para>Web Server</para>
<para>MantisBT is mainly tested with
<ulink url="https://docs.microsoft.com/en-us/iis">Microsoft IIS</ulink> and
<ulink url="http://www.apache.org/">Apache</ulink>.
<ulink url="https://www.apache.org/">Apache</ulink>.
However, it is expected to work with any recent web
server software.
</para>
Expand All @@ -148,12 +148,12 @@
administrator to add support for .PHP files. This should
be a trivial modification. Further details can be found
in the
<ulink url="http://www.php.net/manual/en/install.php">PHP documentation</ulink>
<ulink url="https://www.php.net/manual/en/install.php">PHP documentation</ulink>
</para>
</listitem>

<listitem>
<para><ulink url="http://www.php.net/">PHP</ulink></para>
<para><ulink url="https://www.php.net/">PHP</ulink></para>
<para>The web server must support PHP. It can be installed
as CGI or any other integration technology.
</para>
Expand Down Expand Up @@ -278,13 +278,13 @@
<entry morerows='4' valign='middle'>RDBMS</entry>
<entry>MySQL</entry>
<entry>5.5.35</entry>
<entry>5.6 or above</entry>
<entry>5.6 or later</entry>
<entry>PHP extension: mysqli</entry>
</row>
<row>
<entry>MariaDB</entry>
<entry>5.5.35</entry>
<entry>10.x or above</entry>
<entry>10.x or later</entry>
<entry>PHP extension: mysqli</entry>
</row>
<row>
Expand All @@ -310,7 +310,7 @@
<entry>PHP</entry>
<entry>PHP</entry>
<entry>5.5.x</entry>
<entry>7.0 or later</entry>
<entry>7.2 or later</entry>
<entry>See above for PHP extensions</entry>
</row>

Expand All @@ -330,7 +330,7 @@
<row>
<entry>nginx</entry>
<entry>1.10.x</entry>
<entry>1.10.x</entry>
<entry>1.16.x or later</entry>
<entry></entry>
</row>
<row>
Expand Down Expand Up @@ -420,7 +420,7 @@ gunzip <emphasis>filename.tar.gz</emphasis>
tar -xf <emphasis>filename.tar</emphasis>
</programlisting>
Other file archiving tools such as
<ulink url="http://www.7-zip.org/">7-Zip</ulink>
<ulink url="https://www.7-zip.org/">7-Zip</ulink>
should also be able to handle decompression of the archive.
</para>
<para>The extraction process should create a new directory like
Expand Down Expand Up @@ -676,7 +676,7 @@ find -maxdepth 1 ! -path . -type d -o -type l |
repeat this several times, until normal completion.
</para>
<para>Reference: MantisBT issue
<ulink url="http://www.mantisbt.org/bugs/view.php?id=12735">12735</ulink>.
<ulink url="https://mantisbt.org/bugs/view.php?id=12735">12735</ulink>.
</para>
</note>
</section>
Expand Down Expand Up @@ -767,9 +767,9 @@ find -maxdepth 1 ! -path . -type d -o -type l |
<warning>
<para>Omitting this important step will leave your MantisBT
instance exposed to several potentially severe attacks, e.g.
<ulink url="http://mantisbt.org/bugs/view.php?id=23173">
<ulink url="https://mantisbt.org/bugs/view.php?id=23173">
issue #23173</ulink> (if
<ulink url="http://php.net/manual/en/mysqli.configuration.php#ini.mysqli.allow-local-infile">
<ulink url="https://www.php.net/manual/en/mysqli.configuration.php#ini.mysqli.allow-local-infile">
mysqli.allow_local_infile</ulink>
is enabled in php.ini).
</para>
Expand Down
24 changes: 12 additions & 12 deletions docbook/Admin_Guide/en-US/Troubleshooting.xml
View file
Expand Up @@ -11,9 +11,9 @@
</para>

<para>Useful additional reference information and support may also be
found on the <ulink url="http://www.mantisbt.org/">MantisBT website</ulink>,
more specifically the <ulink url="http://www.mantisbt.org/forums/">Forums</ulink>
and the <ulink url="http://www.mantisbt.org/bugs/">Bugtracker</ulink>.
found on the <ulink url="https://mantisbt.org/">MantisBT website</ulink>,
more specifically the <ulink url="https://mantisbt.org/forums/">Forums</ulink>
and the <ulink url="https://mantisbt.org/bugs/">Bugtracker</ulink>.
</para>

<section id="admin.troubleshooting.errors">
Expand Down Expand Up @@ -45,17 +45,17 @@
What happens is driven by several php.ini configuration settings:
<itemizedlist>
<listitem><para>The ratio
<ulink url="http://php.net/session.gc-probability">
<ulink url="https://www.php.net/session.gc-probability">
session.gc_probability</ulink>
divided by
<ulink url="http://php.net/session.gc-divisor">
<ulink url="https://www.php.net/session.gc-divisor">
session.gc_divisor</ulink>,
which determines the probability that the garbage collection process
will start when a session is initialized.
</para>
</listitem>
<listitem><para>
<ulink url="http://php.net/session.gc-maxlifetime">
<ulink url="https://www.php.net/session.gc-maxlifetime">
session.gc_maxlifetime</ulink> which specifies (as the name does not indicate)
the <emphasis>minimum</emphasis> validity of session data.
</para>
Expand All @@ -73,7 +73,7 @@
<para>As a workaround, the Administrator can
<itemizedlist>
<listitem><para>Increase the value of
<ulink url="http://php.net/session.gc-maxlifetime">session.gc_maxlifetime</ulink></para>
<ulink url="https://www.php.net/session.gc-maxlifetime">session.gc_maxlifetime</ulink></para>
</listitem>
<listitem><para>Set $g_form_security_validation = OFF.
<emphasis>Note that for security reasons, it is strongly recommended not to do this.</emphasis>
Expand All @@ -93,15 +93,15 @@
<itemizedlist>
<listitem>
<para>MantisBT issues
<ulink url="http://www.mantisbt.org/bugs/view.php?id=12381">12381</ulink>,
<ulink url="http://www.mantisbt.org/bugs/view.php?id=12492">12492</ulink>,
<ulink url="http://www.mantisbt.org/bugs/view.php?id=13106">13106</ulink>,
<ulink url="http://www.mantisbt.org/bugs/view.php?id=13246">13246</ulink>
<ulink url="https://mantisbt.org/bugs/view.php?id=12381">12381</ulink>,
<ulink url="https://mantisbt.org/bugs/view.php?id=12492">12492</ulink>,
<ulink url="https://mantisbt.org/bugs/view.php?id=13106">13106</ulink>,
<ulink url="https://mantisbt.org/bugs/view.php?id=13246">13246</ulink>
</para>
</listitem>
<listitem>
<para>
<ulink url="https://www.mantisbt.org/forums/search.php?keywords=2800">MantisBT forums</ulink>
<ulink url="https://mantisbt.org/forums/search.php?keywords=2800">MantisBT forums</ulink>
</para>
</listitem>
</itemizedlist>
Expand Down
2 changes: 1 addition & 1 deletion docbook/Admin_Guide/en-US/User_Management.xml
View file
Expand Up @@ -366,7 +366,7 @@
<para><emphasis>Language</emphasis>:
The preferred language of the user. This
language is used by the GUI and in email notifications. Note
that MantisBT uses UTF8 for encoding the data, hence the
that MantisBT uses UTF-8 for encoding the data, hence the
user could for example use MantisBT with a Chinese interface,
while logging issue data in German.
</para>
Expand Down
2 changes: 1 addition & 1 deletion docbook/Admin_Guide/en-US/config/auth.xml
View file
Expand Up @@ -93,7 +93,7 @@
<listitem>
<para>Protocol can be either
<filename>ldap</filename> or
<filename>ldaps</filename> (for SSL encryption).
<filename>ldaps</filename> (for SSL/TLS encryption).
If omitted, then an unencrypted connection will be established on port 389.
</para>
</listitem>
Expand Down
2 changes: 1 addition & 1 deletion docbook/Admin_Guide/en-US/config/database.xml
View file
Expand Up @@ -106,7 +106,7 @@
issues on RDBMS restricting the size of its identifiers, such as
Oracle (which imposed a maximum size of 30 characters until version
12.1; starting with 12cR2 this
<ulink url="http://docs.oracle.com/database/122/SQLRF/Database-Object-Names-and-Qualifiers.htm#SQLRF51129">
<ulink url="https://docs.oracle.com/en/database/oracle/oracle-database/12.2/sqlrf/Database-Object-Names-and-Qualifiers.html#GUID-75337742-67FD-4EC0-985F-741C93D918DA">
limit has been increased to 128</ulink>).
</para>
</warning>
Expand Down
4 changes: 2 additions & 2 deletions docbook/Admin_Guide/en-US/config/date.xml
View file
Expand Up @@ -10,7 +10,7 @@
formatting.
</para>
<para>Please refer to the
<ulink url="http://www.php.net/manual/en/function.date.php#refsect1-function.date-parameters">
<ulink url="https://www.php.net/manual/en/function.date.php#refsect1-function.date-parameters">
PHP manual
</ulink> for details on available formatting options.
</para>
Expand Down Expand Up @@ -52,7 +52,7 @@
<note><para>The formatting convention for the DateTime picker is
different from the one used for the other date settings
described above; see
<ulink url="http://momentjs.com/docs/#/displaying/format/">
<ulink url="https://momentjs.com/docs/#/displaying/format/">
Moment.js documentation
</ulink>
for details.
Expand Down
2 changes: 1 addition & 1 deletion docbook/Admin_Guide/en-US/config/display.xml
View file
Expand Up @@ -47,7 +47,7 @@
'opensearch_XXX_short' language string, the resulting text
is 16 characters or less, to be compliant with the limit for
the ShortName element as defined in the
<ulink url="http://www.opensearch.org/Specifications/OpenSearch/1.1">
<ulink url="https://github.com/dewitt/opensearch/blob/master/opensearch-1-1-draft-6.md">
OpenSearch specification
</ulink>.
</para>
Expand Down
2 changes: 1 addition & 1 deletion docbook/Admin_Guide/en-US/config/duedate.xml
View file
Expand Up @@ -27,7 +27,7 @@
<listitem>
<para>Default due date value for newly submitted issues:
Empty string for no due date set.
Related date that is accepted by <ulink url="http://php.net/manual/en/function.strtotime.php">strtotime()</ulink>,
Related date that is accepted by <ulink url="https://www.php.net/manual/en/function.strtotime.php">strtotime()</ulink>,
e.g. 'today' or '+2 days'. Default is ''.
</para>
</listitem>
Expand Down

0 comments on commit 32e4728

Please sign in to comment.