How to build boost.spirit documentation

Frank Hein <[email protected]> Sat, 9 Jul 2016 02:40:57 +0200
Newsgroups gmane.comp.lib.boost.documentation
Message-ID <OF65FD3BF4.00BC7C07-ONC1257FEB.00009335-C1257FEB.00044C79@maxence.de>
--===============8354295527096367494==
Content-Type: multipart/signed; 
 boundary=NoSpamProxy_0dec206b-6e9b-4998-bd10-c520de15f248; 
 protocol="application/pkcs7-signature"; micalg="sha256"

--NoSpamProxy_0dec206b-6e9b-4998-bd10-c520de15f248
Content-Type: multipart/alternative; boundary="=_alternative 00044C38C1257FEB_="

This is a multipart message in MIME format.
--=_alternative 00044C38C1257FEB_=
Content-Disposition: inline;
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: QUOTED-PRINTABLE

Hello,

I am currently working on a PR for spirit. Discussed with Joel de Guzman 
here 
(
https://sourceforge.net/p/spirit/mailman/spirit-general/thread/OF328754BD.C365=
90D9-ONC1257FE8.004D1264-C1257FE8.0052E293%40maxence.de/#msg35204400
). 
The addition to Spirit requires documentation which I added. Sadly I fail 
to produce html documentation from 
the qbk sources.

When I bjam --enable-index in the spirit doc folder, everything works so 
far that a spirit2.boostbook
file will be produced residing in bin.v2/( ... lots of toolset and 
platform stuff ... )/spirit2.boostbook.

The last step, producing html files from the boostbook does not get done. 
I believe, I am missing
something here. Please help. I would appreciate to create the 
documentation "the boost way to do it".

This question is all about boost.spirit documentation, which seems not to 
be included in the general 
doc build of boost libraries. It's not a general "how to use docbook" 
question. 

Any help would be highly appreciated.

Frank
--=_alternative 00044C38C1257FEB_=
Content-Disposition: inline;
Content-Type: text/html; charset=utf-8
Content-Transfer-Encoding: QUOTED-PRINTABLE

<font size=3D"2" face=3D"sans-serif">Hello,</font>
<p>
<p><font size=3D"2" face=3D"sans-serif">I am currently working on a PR for spi=
rit.
Discussed with Joel de Guzman here </font>
<p><font size=3D"2" face=3D"sans-serif">(</font><a href=3D"https://sourceforge=
.net/p/spirit/mailman/spirit-general/thread/OF328754BD.C36590D9-ONC1257FE8.004=
D1264-C1257FE8.0052E293%40maxence.de/#msg35204400"><font size=3D"2" face=3D"sa=
ns-serif">https://sourceforge.net/p/spirit/mailman/spirit-general/thread/OF328=
754BD.C36590D9-ONC1257FE8.004D1264-C1257FE8.0052E293%40maxence.de/#msg35204400=
</font></a><font size=3D"2" face=3D"sans-serif">).
</font>
<p><font size=3D"2" face=3D"sans-serif">The addition to Spirit requires docume=
ntation
which I added. Sadly I fail to produce html documentation from </font>
<p><font size=3D"2" face=3D"sans-serif">the qbk sources.</font>
<p>
<p><font size=3D"2" face=3D"sans-serif">When I bjam --enable-index in the spir=
it
doc folder, everything works so far that a spirit2.boostbook</font>
<p><font size=3D"2" face=3D"sans-serif">file will be produced residing in bin.=
v2/(
... lots of toolset and platform stuff ... )/spirit2.boostbook.</font>
<p>
<p><font size=3D"2" face=3D"sans-serif">The last step, producing html files fr=
om
the boostbook does not get done. I believe, I am missing</font>
<p><font size=3D"2" face=3D"sans-serif">something here. Please help. I would
appreciate to create the documentation &quot;the boost way to do it&quot;.</fo=
nt>
<p>
<p><font size=3D"2" face=3D"sans-serif">This question is all about boost.spiri=
t
documentation, which seems not to be included in the general </font>
<p><font size=3D"2" face=3D"sans-serif">doc build of boost libraries. It's not
a general &quot;how to use docbook&quot; question. </font>
<p>
<p><font size=3D"2" face=3D"sans-serif">Any help would be highly appreciated.<=
/font>
<p>
<p><font size=3D"2" face=3D"sans-serif">Frank</font>
--=_alternative 00044C38C1257FEB_=--

--NoSpamProxy_0dec206b-6e9b-4998-bd10-c520de15f248
Content-Transfer-Encoding: BASE64
Content-Type: application/pkcs7-signature; name=smime.p7s
Content-Disposition: attachment; filename=smime.p7s

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
rQJasm1/OnZ3AlGIXpLrzLg390VcmhQCqkOmilbrJCwY3az9Ukp41Wu02tCSJ30iJz0BX60NhCUR
CuHLW2Va3vHjU1G4yt3aojvJc1YvdZAKtbfGqBpxHhDF95x9KF8fPHsCAwEAAaOCAb8wggG7MBMG
CSsGAQQBgjcUAgQGHgQAQwBBMAsGA1UdDwQEAwIBhjAPBgNVHRMBAf8EBTADAQH/MB0GA1UdDgQW
BBRBP5GLi1DKSrj2/gUoAgDUbBTdeTCCASwGA1UdHwSCASMwggEfMIIBG6CCARegggEThoHHbGRh
cDovLy9DTj1tYXhlbmNlJTIwUm9vdCUyMENBLENOPW14Y3NlcnYwNSxDTj1DRFAsQ049UHVibGlj
JTIwS2V5JTIwU2VydmljZXMsQ049U2VydmljZXMsQ049Q29uZmlndXJhdGlvbixEQz1kb3JtYWdl
bixEQz1tYXhlbmNlLERDPWRlP2NlcnRpZmljYXRlUmV2b2NhdGlvbkxpc3Q/YmFzZT9vYmplY3RD
bGFzcz1jUkxEaXN0cmlidXRpb25Qb2ludIZHaHR0cDovL214Y3NlcnYwNS5kb3JtYWdlbi5tYXhl
bmNlLmRlL0NlcnRFbnJvbGwvbWF4ZW5jZSUyMFJvb3QlMjBDQS5jcmwwEgYJKwYBBAGCNxUBBAUC
AwIAAjAjBgkrBgEEAYI3FQIEFgQU/pUTY3kz7GYQH4iY5DKYum/JXlMwDQYJKoZIhvcNAQEFBQAD
ggEBACpFRtYr2fezwbQKsW25QnWLTo8I0Ap5u+jmvMhqAdCEu7GmZhSmz2bRCc1GkB3tW8HnZuYY
+GGMa2PYzYiEENiHborcX53ynYgfx8wUVLvLYalwZZDxGmPRjouqUGJUYbjxVva9TkF82ayfw2+A
awl0c4LdqwTSNjv1njro0s5dN/VfaecbJZA7PkzgXsuIe7lKMhnkkKVveqakThBFehlbjhSuoLkD
YdjBMHjo4ziIBfb1Ekbv4sspb1GO5m7AULokOjfoX3BNyMbq7TD+7/beSf9BIE8zQoRdx/cSQfQ5
H/6lOFLVWlpzH501y5I4a4Q2DoTPS09mzSqK+GPPXvowggYsMIIFFKADAgECAgp9u7/ZAAIAAASF
MA0GCSqGSIb3DQEBBQUAMGExEjAQBgoJkiaJk/IsZAEZFgJkZTEXMBUGCgmSJomT8ixkARkWB21h
eGVuY2UxGDAWBgoJkiaJk/IsZAEZFghkb3JtYWdlbjEYMBYGA1UEAxMPbWF4ZW5jZSBSb290IENB
MB4XDTE1MTExMTEwNDcyMFoXDTE2MTExMDEwNDcyMFowgYYxDDAKBgNVBAgTA05SVzERMA8GA1UE
BxMIRG9ybWFnZW4xKDAmBgNVBAoTH21heGVuY2UgYnVzaW5lc3MgY29uc3VsdGlnIGdtYmgxEzAR
BgNVBAMTCkZyYW5rIEhlaW4xJDAiBgkqhkiG9w0BCQEWFWZyYW5rLmhlaW5AbWF4ZW5jZS5kZTCC
ASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBALGU0BRwqq2t0hqXAc1ORGJUzjbIf3BAaJMt
lvhpC8litrnseLTBTxOPhJRHGEG4Wq6230+lyzirh88nTTK2nswtz2AlMaE3sBWr+nPMd55abtQv
UygspJ3V7eKvtmWIMAE3JforN6jM0ME9yQbzos3WmQf3lej+9ZTTlIzN9wnMEzZNLYuL+tPcMPr/
nSQq0cGW+PxfOSoORyiNXVh4nwS1TNlgVkko3VsnvScBnzpeARLUBy86XBhPJhkU73kVFR7rxjIy
iAU+reOH9zsRwb1LkzQLCAXztIv31DdGF01bKmXOG8qskkUdOLdtjin1qe8kJQrotFtbdSqTE/mn
u8sCAwEAAaOCAr4wggK6MDwGCSsGAQQBgjcVBwQvMC0GJSsGAQQBgjcVCILzvV2HstFFh/2BIoG0
nA+Z8BFuh6XHMIeU7UsCAWQCAQQwEwYDVR0lBAwwCgYIKwYBBQUHAwQwCwYDVR0PBAQDAgXgMBsG
CSsGAQQBgjcVCgQOMAwwCgYIKwYBBQUHAwQwRAYJKoZIhvcNAQkPBDcwNTAOBggqhkiG9w0DAgIC
AIAwDgYIKoZIhvcNAwQCAgCAMAcGBSsOAwIHMAoGCCqGSIb3DQMHMB0GA1UdDgQWBBRvWscVYXl/
/aARfvzhlrFPcujLtzAfBgNVHSMEGDAWgBRBP5GLi1DKSrj2/gUoAgDUbBTdeTCB4QYDVR0fBIHZ
MIHWMIHToIHQoIHNhoHKbGRhcDovLy9DTj1tYXhlbmNlJTIwUm9vdCUyMENBKDIpLENOPW14Y3Nl
cnYwNSxDTj1DRFAsQ049UHVibGljJTIwS2V5JTIwU2VydmljZXMsQ049U2VydmljZXMsQ049Q29u
ZmlndXJhdGlvbixEQz1kb3JtYWdlbixEQz1tYXhlbmNlLERDPWRlP2NlcnRpZmljYXRlUmV2b2Nh
dGlvbkxpc3Q/YmFzZT9vYmplY3RDbGFzcz1jUkxEaXN0cmlidXRpb25Qb2ludDCB0AYIKwYBBQUH
AQEEgcMwgcAwgb0GCCsGAQUFBzAChoGwbGRhcDovLy9DTj1tYXhlbmNlJTIwUm9vdCUyMENBLENO
PUFJQSxDTj1QdWJsaWMlMjBLZXklMjBTZXJ2aWNlcyxDTj1TZXJ2aWNlcyxDTj1Db25maWd1cmF0
aW9uLERDPWRvcm1hZ2VuLERDPW1heGVuY2UsREM9ZGU/Y0FDZXJ0aWZpY2F0ZT9iYXNlP29iamVj
dENsYXNzPWNlcnRpZmljYXRpb25BdXRob3JpdHkwDQYJKoZIhvcNAQEFBQADggEBAJBz3OirXgY0
PB6iMnz/ZNINvfkVOxI9MVTpBqso96GV+WT/Xr1vcU09gAk+r/Wsqs/jbLvFsH6xwkqcHDrHoIy+
tiQRteFf1D35j4WIis+c5uLbn4v6+eopF042CW2M0c557zUUGu1nzxL/J2TYUZJTBLdyrTbhJN9E
zY9LWVvPrqwJd3iWrqDJG4L7bisZnRqvTmskvJeYjb7OFL6AbC9oefvWnNzosmHSs0q6tMt8+I/p
Gxo//AkaZNCrwcjlukMDqzhrG9wqyb6I4Nh+7Q0Z9Nrw3925ezU8h+cuwc+LUaUaSzjOP9kSlMoG
3LSBOY40BRuYTtI35MuQELqfYd0xggPEMIIDwAIBATBvMGExEjAQBgoJkiaJk/IsZAEZFgJkZTEX
MBUGCgmSJomT8ixkARkWB21heGVuY2UxGDAWBgoJkiaJk/IsZAEZFghkb3JtYWdlbjEYMBYGA1UE
AxMPbWF4ZW5jZSBSb290IENBAgp9u7/ZAAIAAASFMA0GCWCGSAFlAwQCAQUAoIICJjAYBgkqhkiG
9w0BCQMxCwYJKoZIhvcNAQcBMBwGCSqGSIb3DQEJBTEPFw0xNjA3MDkwMDQwNThaMC8GCSqGSIb3
DQEJBDEiBCBBvayJQgHjldXCiOyxOytmy2vza87lyelCV9TJ1v1bxzB+BgkrBgEEAYI3EAQxcTBv
MGExEjAQBgoJkiaJk/IsZAEZFgJkZTEXMBUGCgmSJomT8ixkARkWB21heGVuY2UxGDAWBgoJkiaJ
k/IsZAEZFghkb3JtYWdlbjEYMBYGA1UEAxMPbWF4ZW5jZSBSb290IENBAgp9u7/ZAAIAAASFMIGA
BgsqhkiG9w0BCRACCzFxoG8wYTESMBAGCgmSJomT8ixkARkWAmRlMRcwFQYKCZImiZPyLGQBGRYH
bWF4ZW5jZTEYMBYGCgmSJomT8ixkARkWCGRvcm1hZ2VuMRgwFgYDVQQDEw9tYXhlbmNlIFJvb3Qg
Q0ECCn27v9kAAgAABIUwgbcGCSqGSIb3DQEJDzGBqTCBpjAKBggqhkiG9w0CBTAHBgUrDgMCGjAL
BglghkgBZQMEAgEwCwYJYIZIAWUDBAICMAsGCWCGSAFlAwQCAzAHBgUrDgMCBzAKBggqhkiG9w0D
BzANBggqhkiG9w0DAgIBKDANBggqhkiG9w0DAgIBQDAOBggqhkiG9w0DAgICAIAwCwYJYIZIAWUD
BAECMAsGCWCGSAFlAwQBFjALBglghkgBZQMEASowDQYJKoZIhvcNAQEBBQAEggEADLdhuJOMTrDx
r0ZP33CK4758V+A3KzspHHypHzEZF0AMxxEy1F+Pmn613Vr6/XzwDTDoxpkZA3lVA9RwoqbYr8zV
O7t3YDDtIrG6YYWns9F75BMlFTLk/9l/jyToZEMWJB4qe5eQdlVH9WyFNIee5kac5L3TFcHLsRFX
aktsXf1k4bQ9s23a6XzH/wxXHPifydXW5s1G9YzeaujdOWos/8i+Lef+hW+1B4jmirZrWxV3ykYv
OyvhgkBSnL/Cz5cbd7he8jnM7Po2Drk7W8XcZsuU5hB3yL4O+bR7nz8zY2QH3lFQ+UyKUeKR/U/0
vWWnplDt+kFQ4lTj4WGVCMQ2qA==
--NoSpamProxy_0dec206b-6e9b-4998-bd10-c520de15f248--


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

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

--===============8354295527096367494==--