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-----
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.