Allow overriding bibliography style

CHANGES.md

@@ -30,6 +30,7 @@ This file describes changes in the AutoDoc package.
     Markdown-like text; `@listing`, `@example`, and `@log` info strings
     select the corresponding GAPDoc element
   - Add `@Index` command for generating index entries
+  - Allow overriding the LaTeX bibliography style via `scaffold.bibstyle`
   - In Markdown-like inline backtick code spans, emit
     `<Keyword>...</Keyword>` for GAP keywords (as returned by
     `ALL_KEYWORDS()`), otherwise as before `<Code>...</Code>`

gap/AutoDocMainFunction.gi

@@ -134,7 +134,11 @@ InstallGlobalFunction( CreateMainPage,
     fi;
 
     if IsBound( opt.bib ) and opt.bib <> false then
-        AppendTo( filestream, "<Bibliography Databases=\"", opt.bib, "\"/>\n" );
+        AppendTo( filestream, "<Bibliography Databases=\"", opt.bib, "\"" );
+        if IsBound( opt.bibstyle ) then
+            AppendTo( filestream, " Style=\"", opt.bibstyle, "\"" );
+        fi;
+        AppendTo( filestream, "/>\n" );
     fi;
 
     if IsBound( opt.index ) and opt.index = true then

gap/Magic.gd

@@ -148,6 +148,15 @@
 #!             then it is assumed that you want to use this as your bibliography.
 #!         </Item>
 #!
+#!         <Mark><A>bibstyle</A></Mark>
+#!         <Item>
+#!             Overrides the bibliography style used for LaTeX output.
+#!             This is written as the <C>Style</C> attribute of the generated
+#!             <C>&lt;Bibliography .../&gt;</C> element, so valid values are the
+#!             bibliography style names understood by &GAPDoc; and BibTeX, such
+#!             as <C>alpha</C>, <C>alphaurl</C>, or <C>plain</C>.
+#!         </Item>
+#!
 #!         <Mark><A>entities</A></Mark>
 #!         <Item>
 #!             A record whose keys are taken as entity names, set to the corresponding

tst/AutoDocTest/makedoc-entities-list.g

@@ -11,6 +11,7 @@ AutoDoc(rec(
     includes := [ "chapter1.xml" ],
     appendix := [ "appendix1.xml" ],
     bib := "AutoDocTest.bib",
+    bibstyle := "alphaurl",
     entities := [
       "Legacy Package",
       [ "Package", "LegacyListEntity" ],

tst/AutoDocTest/makedoc-entities-record.g

@@ -11,6 +11,7 @@ AutoDoc(rec(
     includes := [ "chapter1.xml" ],
     appendix := [ "appendix1.xml" ],
     bib := "AutoDocTest.bib",
+    bibstyle := "alphaurl",
     entities := rec(
       AutoDocTestTag := "<Package>RecordEntity</Package>",
       RECORDNOTE := "record entity",

tst/AutoDocTest/makedoc.g

@@ -11,5 +11,6 @@ AutoDoc(rec(
     includes := [ "chapter1.xml" ],
     appendix := [ "appendix1.xml" ],
     bib := "AutoDocTest.bib",
+    bibstyle := "alphaurl",
   ),
 ));

tst/AutoDocTest/tst/manual-entities-list.expected/AutoDocTest.xml

@@ -15,6 +15,6 @@
 </Body>
 <#Include SYSTEM "appendix1.xml">
 <#Include SYSTEM "_AutoDocAppendicesMainFile.xml">
-<Bibliography Databases="AutoDocTest.bib"/>
+<Bibliography Databases="AutoDocTest.bib" Style="alphaurl"/>
 <TheIndex/>
 </Book>

tst/AutoDocTest/tst/manual-entities-record.expected/AutoDocTest.xml

@@ -15,6 +15,6 @@
 </Body>
 <#Include SYSTEM "appendix1.xml">
 <#Include SYSTEM "_AutoDocAppendicesMainFile.xml">
-<Bibliography Databases="AutoDocTest.bib"/>
+<Bibliography Databases="AutoDocTest.bib" Style="alphaurl"/>
 <TheIndex/>
 </Book>

tst/AutoDocTest/tst/manual.expected/AutoDocTest.xml

@@ -15,6 +15,6 @@
 </Body>
 <#Include SYSTEM "appendix1.xml">
 <#Include SYSTEM "_AutoDocAppendicesMainFile.xml">
-<Bibliography Databases="AutoDocTest.bib"/>
+<Bibliography Databases="AutoDocTest.bib" Style="alphaurl"/>
 <TheIndex/>
 </Book>

tst/manual.expected/_Chapter_Reference.xml

@@ -171,6 +171,14 @@
              If this key is not set, but there is a file <F>doc/PACKAGENAME.bib</F>
              then it is assumed that you want to use this as your bibliography.
          </Item>
+         <Mark><A>bibstyle</A></Mark>
+         <Item>
+             Overrides the bibliography style used for LaTeX output.
+             This is written as the <C>Style</C> attribute of the generated
+             <C>&lt;Bibliography .../&gt;</C> element, so valid values are the
+             bibliography style names understood by &GAPDoc; and BibTeX, such
+             as <C>alpha</C>, <C>alphaurl</C>, or <C>plain</C>.
+         </Item>
          <Mark><A>entities</A></Mark>
          <Item>
              A record whose keys are taken as entity names, set to the corresponding