Dear all,
I have further improved the prototype of the generated NaviServer configuration
parameter reference page:
https://naviserver.sourceforge.io/5.1/manual/files/admin-config-params.html
The page is generated from a machine-readable Tcl dict, which is also used by
nsstats to provide online help via tooltips on the page showing the current
configuration settings of a running server.
Recent changes include:
Added database configuration, including nsdb, database pools, database drivers,
and selected external drivers such as nsdbpg and nsoracle
Added missing standard modules and selected external modules, including nsstats
Cleaned up the legacy global smtp* settings by documenting them under
ns/sendmail
Improved links to related documentation for included and external modules
Checked and corrected default values needed by nsd-config and openacs-config
Added or improved descriptions for many global, per-server, module, and driver
parameters
There is still more to do:
Replace or consolidate manually written configuration documentation with
generated sections where appropriate
Modularize the documentation dictionaries so external modules can ship their
own parameter metadata
Clean up the documentation generation scripts
Resolve charset configuration discrepancies between OpenACS and NaviServer
Concerning the last point: NaviServer defines outputcharset, urlcharset, and
formfallbackcharset per server, while OpenACS still tries to access these
settings from the global ns/parameters section. This likely reflects older
AOLserver/NaviServer behavior, where these settings were global. One option
would be to fix the OpenACS lookups directly, but this occurs in multiple
places. Another option might be to reintroduce these settings under
ns/parameters as global defaults for the per-server settings. This is not
urgent, since most sites use UTF-8, but it is still a nuisance.
Not all of this has to be resolved before NaviServer 5.1. As a next step, I
will work on a changelog summary for the release, which will take some time.
Feedback on the generated parameter page is welcome, especially for missing
parts or configuration details needed for some sites.
Best regards,
Gustaf
_______________________________________________
naviserver-devel mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/naviserver-devel
