[bug #68565] manage parser generation for Bison/YACC grammars with `MAINTAINER_MODE`

--8323329-1714636915-1785008310=:480913
Content-Type: TEXT/plain; CHARSET=utf-8
Content-Transfer-Encoding: QUOTED-PRINTABLE
Content-Disposition: inline

URL:=0A  <https://savannah.gnu.org/bugs/?68565>=0A=0A                 Summa=
ry: manage parser generation for Bison/YACC grammars=0Awith `MAINTAINER_MOD=
E`=0A                   Group: GNU roff=0A               Submitter: gbrande=
n=0A               Submitted: Sat 25 Jul 2026 07:38:26 PM UTC=0A           =
     Category: General=0A                Severity: 3 - Normal=0A           =
   Item Group: Build/Installation=0A                  Status: None=0A      =
           Privacy: Public=0A             Assigned to: None=0A             =
Open/Closed: Open=0A         Discussion Lock: Unlocked=0A         Planned R=
elease: None=0A=0A=0A    __________________________________________________=
_____=0A=0AFollow-up Comments:=0A=0A=0A------------------------------------=
-------------------=0ADate: Sat 25 Jul 2026 07:38:26 PM UTC By: G. Branden =
Robinson <gbranden>=0A[https://lists.gnu.org/archive/html/groff/2026-07/msg=
00017.html I wrote]:=0A=0A=0A... There may already exist other "informal" m=
aintainer-mode stuff=0Awe should bring under the governance of the `MAINTAI=
NER_MODE` Automake=0Amacro, and further such things may arise in the future=
.=0A=0AOne existing instance I can think of is the generation of the Bison/=
YACC=0Agrammars for eqn, pic, and refer.=0A=0ASee a recent commit:=0A=0Acom=
mit baac1d37e9cbf38c786a89e34201bd9cce0ec19f=0AAuthor: G. Branden Robinson =
<[email protected]>=0ADate:   Thu Jul 2 12:12:37 2026 -0500=0A=
=0A    [eqn,pic,refer]: Clean out-of-source build trees.=0A=0A    ...better=
.=0A=0A    * src/preproc/eqn/eqn.am:=0A    * src/preproc/pic/pic.am:=0A    =
* src/preproc/refer/refer.am: Improve clean behavior, deleting YACC/=0A    =
  Bison-generated files _only_ from an out-of-source build tree.=0A      Be=
cause they are shipped in the distribution archive, only the=0A      "maint=
ainer-clean" target should remove them from the source tree.=0A      Add ne=
w macros `GROFF_{EQN,PIC,REFER}_YACC_FILES` to track these=0A      artifact=
s.  Redefine `MAINTAINERCLEANFILES` in terms of these new=0A      macros.  =
Add `mostlyclean-{eqn,pic,refer}` targets to perform the=0A      cleaning. =
 Add these new targets as dependencies of=0A      `mostlyclean-local`.=0A=
=0A    With this commit, the only files left behind after a command sequenc=
e=0A    like this...=0A=0A    rm -r build=0A    mkdir build=0A    cd build=
=0A    ../configure=0A    make=0A    make clean=0A=0A    ...are a bunch of =
".dirstamp" and/or ".Po" files, which are GNU=0A    Automake's business to =
deal with.=0A=0AWith `MAINTAINER_MODE`, we might be able to make the forego=
ing even more=0Ascrupulous.=0A=0A=0ASetting Severity to "Normal" rather tha=
n "Wish", because the fact that we=0Adon't do this already probably is a bu=
g.=0A=0AI may return to quote an email from Bruno where he lays out how dat=
e stamps=0Aare not maintained scrupulously enough across platforms to avoid=
 spurious=0Arebuilds, which will fail if dependencies that we say distribut=
ion archive=0Ausers don't need are not present in the host environment.=0A=
=0A=0A=0A=0A=0A=0A=0A    __________________________________________________=
_____=0A=0AReply to this item at:=0A=0A  <https://savannah.gnu.org/bugs/?68=
565>=0A=0A_______________________________________________=0AMessage sent vi=
a Savannah=0Ahttps://savannah.gnu.org/=0A
--8323329-1714636915-1785008310=:480913
Content-Type: APPLICATION/pgp-signature; name=signature.asc

-----BEGIN PGP SIGNATURE-----

iHUEABYIAB0WIQQk97aszIMMAvLLwm6qLAuaBUf3TgUCamUQtgAKCRCqLAuaBUf3
TrWrAP9CR2umND8BMXUb2M+UkEYgpXCVxfBvLJYG0sVr+7/26wEAuVQDLP80xAiW
LnA8NFNIq96dXuzewQLNTPZNF6qsAAg=
=wkHw
-----END PGP SIGNATURE-----

--8323329-1714636915-1785008310=:480913--