Recent changes broke docs for boost.algorithm

Marshall Clow via Boost-docs <[email protected]> Fri, 1 Jul 2022 12:52:11 -0700
Newsgroups gmane.comp.lib.boost.documentation
Message-ID <[email protected]>
--===============2554027675053915125==
Content-Type: multipart/alternative;
	boundary="Apple-Mail=_EBB66C4A-404C-4792-A5EB-69B6FE1CFAB2"


--Apple-Mail=_EBB66C4A-404C-4792-A5EB-69B6FE1CFAB2
Content-Transfer-Encoding: quoted-printable
Content-Type: text/plain;
	charset=utf-8

I have opened https://github.com/boostorg/quickbook/issues/15 =
<https://github.com/boostorg/quickbook/issues/15> to capture the =
details; but I=E2=80=99m hoping it=E2=80=99s something weird in the =
source files, rather than in Quickbooks.

Gist of the problem:

This compiles w/o error and generates dox.

```
[section:Copy Variations on Copy]
[section:variations_on_copy]

[section:copy_until                copy_until                ]
[*[^[link header.boost.algorithm.cxx11.copy_if_hpp                   =
copy_until]                  ] ]
Copy all the elements from the start of the input range to the output =
range until the predicate is satisfied
[endsect:copy_until]

[section:copy_while                copy_while                ]
[*[^[link header.boost.algorithm.cxx11.copy_if_hpp                   =
copy_while]                  ] ]
Copy all the elements from the start of the input range to the output =
range while the predicate is satisfied
[endsect:copy_while]

[section:copy_if_until             copy_if_until             ]
[*[^[link header.boost.algorithm.cxx11.copy_if_hpp                   =
copy_if_until                ] ]
Copy all elements that satisfy the element predicate from the start of =
the input range to the output range until the termination predicate is =
satisfied

[endsect:copy_if_until]

[section:copy_if_while             copy_if_while             ]
[*[^[link header.boost.algorithm.cxx11.copy_if_hpp                   =
copy_if_while                ] ]
Copy all elements that satisfy the element predicate from the start of =
the input range to the output range while the termination predicate is =
satisfied

[endsect:copy_if_while]

[endsect:variations_on_copy]
[endsect:Copy]
```

If I remove the blank lines before "[endsect:copy_if_until]=E2=80=9D or =
"[endsect:copy_if_while]=E2=80=9D, the build fails:

```
Generating output file: ../../../bin.v2/libs/algorithm/doc/algorithm.xml
algorithm.qbk:148: error: Endsect has incorrect id 'variations_on_copy', =
expected 'copy_if_until', near column 9.
algorithm.qbk:149: error: Endsect has incorrect id 'Copy', expected =
'variations_on_copy', near column 9.
algorithm.qbk: warning: Missing [endsect] detected at end of file.
Error: Error count: 2.
```


Any ideas?

=E2=80=94 Marshall


--Apple-Mail=_EBB66C4A-404C-4792-A5EB-69B6FE1CFAB2
Content-Transfer-Encoding: quoted-printable
Content-Type: text/html;
	charset=utf-8

<html><head><meta http-equiv=3D"Content-Type" content=3D"text/html; =
charset=3Dutf-8"></head><body style=3D"word-wrap: break-word; =
-webkit-nbsp-mode: space; line-break: after-white-space;" class=3D"">I =
have opened&nbsp;<a =
href=3D"https://github.com/boostorg/quickbook/issues/15" =
class=3D"">https://github.com/boostorg/quickbook/issues/15</a>&nbsp;to =
capture the details; but I=E2=80=99m hoping it=E2=80=99s something weird =
in the source files, rather than in Quickbooks.<div class=3D""><br =
class=3D""></div><div class=3D"">Gist of the problem:</div><div =
class=3D""><br class=3D""></div><div class=3D"">This compiles w/o error =
and generates dox.</div><div class=3D""><br class=3D""></div><div =
class=3D"">```</div><div class=3D"">[section:Copy Variations on =
Copy]</div><div class=3D"">[section:variations_on_copy]</div><div =
class=3D""><br class=3D""></div><div class=3D"">[section:copy_until =
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;copy_until &nbsp; =
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;]</div><div =
class=3D"">[*[^[link header.boost.algorithm.cxx11.copy_if_hpp &nbsp; =
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; copy_until] =
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;] =
]</div><div class=3D"">Copy all the elements from the start of the input =
range to the output range until the predicate is satisfied</div><div =
class=3D"">[endsect:copy_until]</div><div class=3D""><br =
class=3D""></div><div class=3D"">[section:copy_while &nbsp; &nbsp; =
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;copy_while &nbsp; &nbsp; &nbsp; =
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;]</div><div class=3D"">[*[^[link =
header.boost.algorithm.cxx11.copy_if_hpp &nbsp; &nbsp; &nbsp; &nbsp; =
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; copy_while] &nbsp; &nbsp; &nbsp; =
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;] ]</div><div class=3D"">Copy =
all the elements from the start of the input range to the output range =
while the predicate is satisfied</div><div =
class=3D"">[endsect:copy_while]</div><div class=3D""><br =
class=3D""></div><div class=3D"">[section:copy_if_until &nbsp; &nbsp; =
&nbsp; &nbsp; &nbsp; &nbsp; copy_if_until &nbsp; &nbsp; &nbsp; &nbsp; =
&nbsp; &nbsp; ]</div><div class=3D"">[*[^[link =
header.boost.algorithm.cxx11.copy_if_hpp &nbsp; &nbsp; &nbsp; &nbsp; =
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; copy_if_until &nbsp; &nbsp; &nbsp; =
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;] ]</div><div class=3D"">Copy all =
elements that satisfy the element predicate from the start of the input =
range to the output range until the termination predicate is =
satisfied</div><div class=3D""><br class=3D""></div><div =
class=3D"">[endsect:copy_if_until]</div><div class=3D""><br =
class=3D""></div><div class=3D"">[section:copy_if_while &nbsp; &nbsp; =
&nbsp; &nbsp; &nbsp; &nbsp; copy_if_while &nbsp; &nbsp; &nbsp; &nbsp; =
&nbsp; &nbsp; ]</div><div class=3D"">[*[^[link =
header.boost.algorithm.cxx11.copy_if_hpp &nbsp; &nbsp; &nbsp; &nbsp; =
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; copy_if_while &nbsp; &nbsp; &nbsp; =
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;] ]</div><div class=3D"">Copy all =
elements that satisfy the element predicate from the start of the input =
range to the output range while the termination predicate is =
satisfied</div><div class=3D""><br class=3D""></div><div =
class=3D"">[endsect:copy_if_while]</div><div class=3D""><br =
class=3D""></div><div class=3D"">[endsect:variations_on_copy]</div><div =
class=3D"">[endsect:Copy]</div><div class=3D"">```</div><div =
class=3D""><br class=3D""></div><div class=3D"">If I remove the blank =
lines before "[endsect:copy_if_until]=E2=80=9D or =
"[endsect:copy_if_while]=E2=80=9D, the build fails:</div><div =
class=3D""><br class=3D""></div><div class=3D"">```</div><div =
class=3D"">Generating output file: =
../../../bin.v2/libs/algorithm/doc/algorithm.xml<br =
class=3D"">algorithm.qbk:148: error: Endsect has incorrect id =
'variations_on_copy', expected 'copy_if_until', near column 9.<br =
class=3D"">algorithm.qbk:149: error: Endsect has incorrect id 'Copy', =
expected 'variations_on_copy', near column 9.<br class=3D"">algorithm.qbk:=
 warning: Missing [endsect] detected at end of file.<br class=3D"">Error: =
Error count: 2.<br class=3D"">```</div><div class=3D""><br =
class=3D""></div><div class=3D""><br class=3D""></div><div class=3D"">Any =
ideas?</div><div class=3D""><br class=3D""></div><div class=3D"">=E2=80=94=
 Marshall</div><div class=3D""><br class=3D""></div></body></html>=

--Apple-Mail=_EBB66C4A-404C-4792-A5EB-69B6FE1CFAB2--

--===============2554027675053915125==
Content-Type: text/plain; charset="us-ascii"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Content-Disposition: inline

_______________________________________________
Boost-docs mailing list
[email protected]
https://lists.boost.org/mailman/listinfo.cgi/boost-docs

--===============2554027675053915125==--