SSI-related documentation requests
Hunter Turcin <[email protected]>
| Newsgroups | gmane.comp.apache.documentation |
|---|---|
| Message-ID | <[email protected]> |
Hello apache2 documentation contributors,
I recently set up server-side includes on my web server today, but
spent a few hours struggling with the documentation. I have a few
suggestions on possible improvements to the documentation, to hopefully
save future readers time if they encounter the same troubles I had.
On "Introduction to Server Side Includes", Conditional expressions:
Would it be possible for the documentation to mention that, while
environment variables use %{name}, SSI vars use v('name')? I was unable
to find this on either the introduction page or the linked expressions
syntax page; instead, I found it in the documentation for mod_include,
but not as formal documentation, only as part of a single example that
does not explicitly call out the meaning of v('name'). This would allow
new users to hit the ground running with using expressions involving
SSI variables.
On "Apache Module mod_include", SSIUndefinedEcho:
Would it be possible for the documentation to mention that the value of
SSIUndefinedEcho is overridden by `#config echomsg`? Additionally,
would it possible to mention that it is not possible to set this to a
blank string, whereas the `#config` approach allows this? (This one
might be a problem between my keyboard and chair; on my setup at least,
`SSIUndefinedEcho ""` errors out as if I hadn't set any parameters.)
On "Apache Module mod_include", The echo element:
Would it be possible for the documentation to state that all variables
are allowed to be used here? The intro sentence makes it seem like this
directive only recognizes the listed Include Variables instead of all
environment and SSI-set variables.
I am happy to discuss these suggestions. My intent is to hopefully
reduce the amount of time future newbies spend troubleshooting this
functionality.
Thank you,
Hunter Turcin
signature.asc
(application/pgp-signature, 833 B)
-----BEGIN PGP SIGNATURE----- iQIzBAABCAAdFiEE+MU472k0SQqKDBHntT/obWJJYu0FAmf0WdEACgkQtT/obWJJ Yu1tOBAAjtxE8mRMmdMrljcvt4Kbcm0DyvpnNyBZPQZZMUxvSeIaFqS2XgDVabt+ TQFwQfd3tPuWal9b2t29VKUovkeS+7LStVCuc6mq+SoRirX38hGV1GUDAzM6MQQc e0kccGWozljJ6jk8czgxrdosHCRYuE6ItCOCRkUekZJlxNokkB+JpIFr5EQ9LQBP 5SefG5N3VxkCX5MXKlUqpyWTD1/qz74KVuIowrTqDleXl/8AWAB2MAzsZ+7iO+S/ j5wh2aswr3M0aQQF6qwx194U7n5bHf8zECkmx+bRSi8SeYx3+NBcSITJ2JOsCulA 0e7cgIYXZP5bmYEYVQBh8IXI8ap1esdov4RBJ1qDymvxGnKYoFZ+rYSKG/mj2cqf 6nNOJ8yksgTcbG2h6caI9umrAMHdmT3KWzmHCYqtn9YPRtBHjCmQ12Vc30g3RWUt ftB3xVt/T9ZmcORUFeJqQ2kJo556NTWuUPxRwVh893WjVfyQf6Ow5+OFuguyFrHX l0YR1VsOxbamsps+kOjjyB+Z4wA/xu7U/A+zeTbcFmias42TkwDYifhmyqtnnTXB cxeEF2A/xhk4zpkPetbSXaHi2sQbTxciDYrhJZdFIQURaybPYaDxjKPVgPo4Us/u Wcax93n6BTGYDr+OYQ4q/Hc6uCzy5Z9FxGrJFA7xfCKOfmCPd+o= =u7Yl -----END PGP SIGNATURE-----