libtasn1: Add Possible Parameters. Part of issue #19.

This commit is contained in:
Zeckmathederg 2024-09-29 20:59:14 -06:00
parent 7c34697be4
commit 71c5f15f8f
3 changed files with 145 additions and 57 deletions

View File

@ -39,6 +39,19 @@
</listitem>
-->
<listitem>
<para>September 29th, 2024</para>
<itemizedlist>
<listitem>
<para>
[Zeckmathederg] - libtasn1: Add Possible Parameters. Part of issue
<ulink url="https://github.com/Zeckmathederg/glfs/issues/19">#19.
</ulink>
</para>
</listitem>
</itemizedlist>
</listitem>
<listitem>
<para>September 24th, 2024</para>
<itemizedlist>

View File

@ -76,17 +76,6 @@ make</userinput></screen>
</sect2>
<sect2 role="commands">
<title>Command Explanations</title>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../xincludes/static-libraries.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../xincludes/gtk-doc-rebuild-problem.xml"/>
</sect2>
<sect2 role="installation">
<title>32-bit Installation of libtasn1</title>
@ -120,6 +109,123 @@ ldconfig</userinput></screen>
</sect2>
<sect2 role="possible">
<title>Possible Parameters</title>
<para>
<parameter>--{en,dis}able-silent-rules</parameter>: This option changes
verbosity in the build output.
</para>
<para>
<parameter>--{en,dis}able-dependency-tracking</parameter>: This option
changes whether to accept slow dependency extractors.
</para>
<para>
<parameter>--disable-largefile</parameter>: This option disables support
for large files.
</para>
<para>
<parameter>--disable-year2038</parameter>: This option disables support
for timestamps beyond the year 2038.
</para>
<para>
<parameter>--disable-doc</parameter>: This option disables building
documentation.
</para>
<para>
<parameter>--{en,dis}able-shared</parameter>: This option toggles
building shared libraries (enabled by default).
</para>
<para>
<parameter>--{en,dis}able-static</parameter>: This option toggles
building static libraries (enabled by default).
</para>
<para>
<parameter>--enable-fast-install</parameter>: This option optimizes for
a faster installation (enabled by default).
</para>
<para>
<parameter>--disable-libtool-lock</parameter>: This option <quote>avoids
locking</quote> which can break building this package with multiple jobs.
</para>
<para>
<parameter>--enable-gtk-doc</parameter>: This option enables the use of
<command>gtk-doc</command> to build documentation (it is broken and
disabled by default).
</para>
<para>
<parameter>--enable-gtk-doc-html</parameter>: This option builds HTML
documentation (enabled by default).
</para>
<para>
<parameter>--enable-gtk-doc-pdf</parameter>: Same as <parameter>
--enable-gtk-doc-html</parameter> but builds as a PDF (disabled by
default).
</para>
<para>
<parameter>--enable-cross-guesses={conservative,risky}</parameter>: This
option changes the policy for cross-compilation guesses. It is
recommended to leave this alone unless you know what you're doing.
</para>
<para>
<parameter>--enable-ld-version-script</parameter>: This option enables
the linker version script (enabled by default if available).
</para>
<para>
<parameter>--disable-valgrind-tests</parameter>: This option disables
running tests with <application>Valgrind</application>.
</para>
<para>
<parameter>--enable-code-coverage</parameter>: This option enables
code coverage support.
</para>
<para>
<parameter>--disable-gcc-warnings</parameter>: This option disables GCC
warnings.
</para>
<para>
<parameter>--enable-fuzzing</parameter>: This option turns on fuzzing
for the building process.
</para>
<para>
<parameter>--with-aix-soname={aix,svr4,both}</parameter>: This option
changes the soname variant (default is aix).
</para>
<para>
<parameter>--with-gnu-ld</parameter>: This option assumes that the C
compiler uses GNU ld (disabled by default but will be automatically
detected).
</para>
</sect2>
<sect2 role="commands">
<title>Command Explanations</title>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../xincludes/static-libraries.xml"/>
</sect2>
<sect2 role="content">
<title>Contents</title>

View File

@ -9,17 +9,6 @@
-->
<!ENTITY TEMPLATE-download-http "https://">
<!ENTITY TEMPLATE-md5sum "MD5 sum">
<!ENTITY TEMPLATE-size "?? MB">
<!ENTITY TEMPLATE-buildsize "?? MB">
<!ENTITY TEMPLATE-time "?? SBU">
<!-- SBU should be rounded to nearer integer if greater than 10, to one
decimal if less than 10, and should be "less than 0.1 SBU" if
less than 0.1. If the SBU without parallelisation is too long,
it is acceptable to give the value "with parallelism=N", where
N is the number of threads used. Note that some build systems
automatically fix N equal to the number of available CPU cores
on the machine. -->
]>
<!-- Try to keep the indentation used in this file-->
@ -59,26 +48,6 @@
Download (HTTP): <ulink url="&TEMPLATE-download-http;"/>
</para>
</listitem>
<listitem>
<para>
Download MD5 sum: &TEMPLATE-md5sum;
</para>
</listitem>
<listitem>
<para>
Download size: &TEMPLATE-size;
</para>
</listitem>
<listitem>
<para>
Estimated disk space required: &TEMPLATE-buildsize;
</para>
</listitem>
<listitem>
<para>
Estimated build time: &TEMPLATE-time;
</para>
</listitem>
</itemizedlist>
<!-- As required -->
@ -96,7 +65,7 @@
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required">
<xref linkend="BLFS_DEPENDENCY"/> <!-- notice no period as this is not
<xref linkend="GLFS_DEPENDENCY"/> <!-- notice no period as this is not
a sentence. If there are more than two, they must be separated by commas
with the last member having "and" in front of it. The use of a serial
comma is preferred (a comma after the next to last member before the
@ -117,7 +86,7 @@
<!-- As required -->
<bridgehead renderas="sect4">Recommended</bridgehead>
<para role="recommended">
<xref linkend="BLFS_DEPENDENCY"/> <!-- notice no period as this is not
<xref linkend="GLFS_DEPENDENCY"/> <!-- notice no period as this is not
a sentence. See above for the use of "and" and commas. Normally, neither
required nor recommended dependencies should be <ulink>. -->
<xref linkend="ANOTHER_RECOMMENDED_DEP"/> (required if building
@ -130,7 +99,7 @@
<!-- As required -->
<bridgehead renderas="sect4">Optional</bridgehead>
<para role="optional">
<xref linkend="BLFS_DEPENDENCY"/> and
<xref linkend="GLFS_DEPENDENCY"/> and
<ulink url="http://www.some.url/">EXTERNAL DEPENDENCY</ulink>
<!-- notice no period as this is not a sentence. See above for the use
of commas and "and". The order should be <xref> before <ulink>.-->
@ -138,11 +107,6 @@
dependency. -->
</para>
<!-- Only use this if you want to note something in the wiki
<para condition="html" role="usernotes">
Editor Notes: <ulink url="&blfs-wiki;/TEMPLATE"/>
</para>
-->
</sect2>
<!-- Optional section for packages that need a specific kernel
@ -250,6 +214,16 @@ make</userinput></screen>
mv doc/* /usr/share/doc/template-&template-version;</userinput></screen>
</sect2>
<sect2 role="possible">
<title>Possible Parameters</title>
<para>
<parameter>--PARAMETER</parameter>: This parameter is optional and may be
something the reader will want to set.
</para>
</sect2>
<!--Optional section-->
<sect2 role="commands">
<title>Command Explanations</title>
@ -258,7 +232,7 @@ mv doc/* /usr/share/doc/template-&template-version;</userinput></screen>
href="../../xincludes/static-libraries.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../xincludes/gtk-doc-rebuild.xml"/>
href="../../xincludes/gtk-doc-rebuild.xml"/>
<para>
<command>COMMAND</command>: This command does something.
@ -266,15 +240,10 @@ mv doc/* /usr/share/doc/template-&template-version;</userinput></screen>
<para>
<parameter>--PARAMETER</parameter>: This parameter does something
mandatory for BLFS purposes. It will be in the instructions above. It is
mandatory for GLFS purposes. It will be in the instructions above. It is
not optional and is why it is listed as a parameter and not an option.
</para>
<para>
<option>--OPTION</option>: This option does something optionally per the
user's desires. It is not listed in the instructions above, but instead,
is listed here because many (some) readers may want to include it.
</para>
</sect2>
<!--Optional section-->