From 71c5f15f8fd50feea3164f8ff57aded265c6098d Mon Sep 17 00:00:00 2001
From: Zeckmathederg <zeckma.tech@gmail.com>
Date: Sun, 29 Sep 2024 20:59:14 -0600
Subject: [PATCH] libtasn1: Add Possible Parameters. Part of issue #19.

---
 introduction/welcome/changelog.xml |  13 +++
 shareddeps/net/libtasn1.xml        | 128 ++++++++++++++++++++++++++---
 template/template.xml              |  61 ++++----------
 3 files changed, 145 insertions(+), 57 deletions(-)

diff --git a/introduction/welcome/changelog.xml b/introduction/welcome/changelog.xml
index 3223eedd82..2f8b13b1d9 100644
--- a/introduction/welcome/changelog.xml
+++ b/introduction/welcome/changelog.xml
@@ -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>
diff --git a/shareddeps/net/libtasn1.xml b/shareddeps/net/libtasn1.xml
index 688dcfbcb2..092cce915a 100644
--- a/shareddeps/net/libtasn1.xml
+++ b/shareddeps/net/libtasn1.xml
@@ -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>
 
diff --git a/template/template.xml b/template/template.xml
index a43ed81eaa..4cb2ab1328 100644
--- a/template/template.xml
+++ b/template/template.xml
@@ -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-->