Support applying options to multiple examples as

suggested in #640

Signed-off-by: Hanson Char <[email protected]>

.gitignore

@@ -12,3 +12,4 @@
 *.zip
 
 build/*
+tex/generic/pgf/pgf.revision.tex

doc/generic/pgf/CHANGELOG.md

@@ -11,6 +11,8 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 ### Added
 
 - Add `RGB` and `gray` color model support for ConTeXt #1130
+- Support an apply-all feature (suggested in issue #640) to
+  apply a single definition of options to multiple examples.
 
 ### Fixed
 
@@ -27,6 +29,7 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 - Resolve overfull hboxes >=20pt in the manual
 - Adapt `\graphicspath` setting for flattened doc tree #1191
 - Promote warning "Plot data file \`...' not found" to error
+- Ignore file `tex/generic/pgf/pgf.revision.tex` in git
 
 ### Contributors
 
@@ -40,6 +43,7 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 - Yukai Chou (@muzimuzhi)
 - Alexander Grahn
 - Max Chernoff
+- Hanson Char
 
 ## [3.1.10] - 2023-01-13 Henri Menke
 

tex/generic/pgf/graphdrawing/lua/pgf/gd/force/ControlElectric.lua

@@ -29,7 +29,7 @@ declare {
   type = "number",
   initial = 1,
 
-  summary = [["
+  summary = [[
     Defines the electric charge of the node. The stronger the
     |electric charge| of a node the stronger the repulsion between the
     node and others in the graph. A negative |electric charge| means that
@@ -38,24 +38,24 @@ declare {
     |spring electrical layout| algorithm works.
     Two typical effects of increasing the |electric charge| are distortion
     of symmetries and an upscaling of the drawings.
-  "]],
+  ]],
   examples = {
+    options = [[ preamble={\usetikzlibrary{graphs,graphdrawing} \usegdlibrary{force}} ]],
     {
-      options = [["preamble={\usetikzlibrary{graphs,graphdrawing} \usegdlibrary{force}}"]],
-      code = [["
+      code = [[
         \tikz \graph [spring electrical layout, horizontal=0 to 1]
           { 0 [electric charge=1] -- subgraph C_n [n=10] };
-      "]]
+      ]]
     },{
-      code = [["
+      code = [[
         \tikz \graph [spring electrical layout, horizontal=0 to 1]
           { 0 [electric charge=5] -- subgraph C_n [n=10] };
-      "]]
+      ]]
     },{
-      code = [["
+      code = [[
         \tikz \graph [spring electrical layout, horizontal=0 to 1]
           { [clique] 1 [electric charge=5], 2, 3, 4 };
-      "]]
+      ]]
     }
   }
 }

tex/generic/pgf/lua/pgf/manual/DocumentParser.lua

@@ -159,10 +159,17 @@ local function process_examples(t)
 
   local n = {}
   for i=1,#t do
-    local code, options
+    local code
+    local options = t.options
     if type(t[i]) == "table" then
       code = assert(t[i].code)
-      options = t[i].options
+      if options then
+        if t[i].options then
+          options = options .. t[i].options
+        end
+      else
+        options = t[i].options
+      end
     else
       code = t[i]
     end