Modernize module names: Eliom.Service instead of Eliom_service

.gitignore

@@ -12,3 +12,9 @@ src/**/*.odocl
 ocsigen.org-data
 
 _opam
+
+# Local files (not part of the project)
+AGENTS*.md
+instructions
+eliom-analysis.md
+eliom.opam.template

CHANGES

@@ -1,8 +1,67 @@
+===== 13.0 =====
+* Module namespace modernization
+** Public modules are now accessed as Eliom.Service, Eliom.Content,
+   Eliom.Parameter, Eliom.Registration, Eliom.Client, ... instead of
+   the legacy flat Eliom_xxx prefix. Implemented with
+   (include_subdirs qualified) + (wrapped false) in dune.
+** Eliom_common is now Eliom.Common; most internal modules lost
+   their eliom_/eliommod_ prefix as well (Content_core, Mod_main,
+   Mod_pagegen, ...). A few names are kept as-is for conflict
+   reasons (Eliom_form, Eliom_lazy, Eliom_react, Eliom_uri).
+** New eliom-compat opam package: provides the legacy Eliom_xxx
+   module names as include-aliases of the new Eliom.Xxx modules,
+   to ease migration of existing code.
+** BREAKING: Eliom.run is now Eliom.App.run (the auto-generated
+   wrapper module cannot contain val declarations).
+* Eliom.Content.Html.T
+** New named module type for the Tyxml HTML signature shared by F
+   and D, with Eliom's LINKS_AND_FORMS extensions. Use it as the
+   parameter signature of functors that need to abstract over the
+   F/D choice, instead of [module type of Content.Html.F]. The
+   latter triggers an OCaml strengthening bug in wrapped libraries
+   (see ia-reports/2026-04-ocaml-wrapped-mtof-bug.md). Tools.Make,
+   Ot.Icons.Make and the os_template Make functor all use it.
+* Distillery template install path
+** Eliom's three templates (app.exe, app.lib, basic.ppx) are now
+   installed at lib/eliom/templates/<name>/ via the standard dune
+   (install (section lib_root) ... (with_prefix ...)) pattern.
+   Third-party packages (e.g. ocsigen-start) that ship templates
+   are expected to install at the same location.
+** eliom-distillery no longer auto-discovers templates from
+   per-package eliom-templates/ subdirectories; it reads from the
+   single standard lib/eliom/templates/ location, plus
+   ELIOM_DISTILLERY_PATH.
+* Build system
+** Eliom now uses ocsigen-dune-rules to drive its build. Adopted
+   the new gen / check-modules sub-command structure introduced
+   upstream by Jules Aguillon.
+** Migrated to wrapped ocsigenserver module names (Ocsigen.Server,
+   Ocsigen.Extensions, Ocsigen.Request, Ocsigen.Response,
+   Ocsigen.Config, Ocsigen_base.Lib, Ocsigen_http.Header, ...).
+** PPX gained -internal and -internal-prefix flags for compiling
+   wrapped libraries.
+** Removed the eliom.ocamlbuild plugin and the legacy topkg/pkg
+   build artifacts. API documentation is now generated by
+   build/gen_wikidoc.sh (ocamldoc + wikidoc, no ocamlbuild
+   dependency); run via [make wikidoc].
+* Bug fixes
+** Syntax.is_site_available now checks that the sitedata stack is
+   actually non-empty during initialisation, instead of just
+   relying on Ocsigen.Extensions.during_initialisation. Fixes a
+   crash on startup
+   (Eliom_site_information_not_available "get_current_sitedata")
+   exposed by the new module link order: PPX-inserted top-level
+   close_server_section calls in extension-linked .eliom files
+   (Service_base, Content, Tools, ...) now correctly route their
+   compilation-unit data into !global_data when no site is active,
+   matching the design intent stated in the comment on
+   get_global_data.
+
 ===== 12.0 =====
 * Eliom_lib
 ** Deprecated logging functions were removed (#821)
    These are: debug_exn, debug, error, error_any, jsdebug
-* Full WASM support: build system and sending either js or wasm depending on the browser 
+* Full WASM support: build system and sending either js or wasm depending on the browser
 * Use Log instead of Lwt_logs
 
 ===== 11.1 =====

Makefile

@@ -1,41 +1,16 @@
 ### Building
-BEST=$(if $(shell command -v ocamlopt 2> /dev/null),native,byte)
-BUILDER=_build/build/build.$(BEST)
-
 .PHONY: all
 all:
 	dune build
 
 ### Doc
-.PHONY: doc wikidoc doc man alldoc
-DOCS_DIR=src/lib/client src/lib/server src/ocamlbuild src/ppx
-DOCS_HTML=$(addsuffix /api.docdir/index.html,$(DOCS_DIR))
-DOCS_WIKI=$(addsuffix /api.wikidocdir/index.wiki,$(DOCS_DIR))
-DOCS_MAN= src/lib/client/api.mandocdir/man.3oc \
-          src/lib/server/api.mandocdir/man.3os \
-          src/ocamlbuild/api.mandocdir/man.3o \
-          src/ppx/api.mandocdir/man.3o
+.PHONY: wikidoc doccp
 API_DIR=_build/doc/dev/api
-doc: $(BUILDER)
-	$(BUILDER) $(DOCS_HTML)
-wikidoc: $(BUILDER)
-	$(BUILDER) $(DOCS_WIKI)
-man: $(BUILDER)
-	$(BUILDER) $(DOCS_MAN)
-alldoc: man wikidoc doc
-
-doccp: alldoc
-	mkdir -p $(API_DIR)/server $(API_DIR)/client $(API_DIR)/ocamlbuild $(API_DIR)/ppx
-	cp -Rf _build/src/lib/server/api.wikidocdir/*.wiki $(API_DIR)/server/
-	cp -Rf _build/src/lib/client/api.wikidocdir/*.wiki $(API_DIR)/client/
-	cp -Rf _build/src/ocamlbuild/api.wikidocdir/*.wiki $(API_DIR)/ocamlbuild/
-	cp -Rf _build/src/ppx/api.wikidocdir/*.wiki $(API_DIR)/ppx/
-	cp -Rf doc/index.wiki $(API_DIR)/
+wikidoc:
+	bash build/gen_wikidoc.sh all
 
-$(BUILDER): $(wildcard build/*.ml)
-	ocamlbuild -no-plugin -I src/ocamlbuild -no-links -use-ocamlfind build/build.$(BEST) 1> /dev/null
-	ocaml pkg/build.ml manpage=false native=true native-dynlink=true
-builder: $(BUILDER)
+doccp: wikidoc
+	cp -Rf doc/index.wiki $(API_DIR)/
 
 ### Cleaning ###
 .PHONY: clean distclean

README.md

@@ -113,6 +113,24 @@ More documentation [here](https://ocsigen.org/tuto/latest/manual/basics).
 
 Write your first Web and mobile application with Eliom using [Ocsigen Start](https://ocsigen.org/ocsigen-start)
 
+## Generating API documentation
+
+Wiki API pages are generated from the `.mli` files using `ocamldoc`
+and the [wikidoc](https://github.com/ocsigen/wikidoc) plugin:
+
+```
+make wikidoc
+```
+
+Output goes to `_build/doc/dev/api/{server,client}/`.
+
+The wiki files are published on the [wikidoc branch] under
+`doc/dev/api/{server,client}/`. To update the published documentation,
+copy the generated `.wiki` files to a checkout of the `wikidoc` branch
+and commit.
+
+[wikidoc branch]: https://github.com/ocsigen/eliom/tree/wikidoc/doc/dev/api
+
 ## Authors
 
 * Vincent Balat