config and update after converting the repo to mercurial

Author: programandala-net

.gitignore

@@ -1,29 +1,21 @@
-# Ignore the internal resources:
-_meta/
-000-info.txt
-
-# Ignore ZX Spectrum emulator snapshots:
-*.sna
-*.szx
-*.z80
-
-# Ignore ZX Spectrum disk images:
 *.dsk
 *.mgt
+*.sna
+*.szx
 *.trd
-
-# Ignore the documentation:
+*.z80
+000-info.txt
+_meta/
 doc/*.dbk
 doc/*.dbk.gz
 doc/*.dbk.zip
 doc/*.epub
-doc/*.jpg
 doc/*.html
 doc/*.html.gz
 doc/*.html.zip
+doc/*.jpg
 doc/*.odt
 doc/*.pdf
 doc/*.pdf.gz
 doc/*.pdf.zip
-
-# vim: filetype=config
+tmp/

.hgignore

@@ -0,0 +1,24 @@
+syntax: glob
+
+*.dsk
+*.mgt
+*.sna
+*.szx
+*.trd
+*.z80
+*_session*.vim
+000-info.txt
+_meta
+doc/*.dbk
+doc/*.dbk.gz
+doc/*.dbk.zip
+doc/*.epub
+doc/*.html
+doc/*.html.gz
+doc/*.html.zip
+doc/*.jpg
+doc/*.odt
+doc/*.pdf
+doc/*.pdf.gz
+doc/*.pdf.zip
+tmp

Makefile

@@ -3,13 +3,13 @@
 # This file is part of Solo Forth
 # http://programandala.net/en.program.solo_forth.html
 
-# Last modified: 202101151626.
+# Last modified: 20230406T0811+0200.
 # See change log at the end of the file.
 
 # ==============================================================
 # Author {{{1
 
-# Marcos Cruz (programandala.net), 2015, 2016, 2017, 2018, 2020, 2021.
+# Marcos Cruz (programandala.net), 2015, 2016, 2017, 2018, 2020, 2021, 2023.
 
 # ==============================================================
 # License {{{1
@@ -971,33 +971,6 @@ tmp/doc.%.linked.adoc: src/doc/%.adoc
 		--pdf-engine=wkhtmltopdf \
 		--output=$@ $<
 
-# ----------------------------------------------
-# Online documentation {{{2
-
-# Online documentation displayed on the Fossil repository.
-
-.PHONY: wwwdoc
-wwwdoc: wwwreadme
-
-.PHONY: cleanwww
-cleanwww:
-	rm -f \
-		doc/www/* \
-		tmp/README.*
-
-.PHONY: wwwreadme
-wwwreadme: doc/www/README.html
-
-doc/www/README.html: tmp/README.html
-	echo "<div class='fossil-doc' data-title='README'>" > $@;\
-	cat $< >> $@;\
-	echo "</div>" >> $@
-
-tmp/README.html: README.adoc
-	asciidoctor \
-		--embedded \
-		--out-file=$@ $<
-
 # ----------------------------------------------
 # Documentation for G+DOS {{{2
 
@@ -1792,6 +1765,8 @@ include Makefile.cover_image
 #
 # 2021-01-15: Make the requirements of <tmp/doc.manual_skeleton.linked.adoc>
 # explicit.
+#
+# 2023-04-06: Remove the online documentation rules, after migrating to Mercurial.
 
 # ==============================================================
 

README.adoc

@@ -1,29 +1,22 @@
 = Solo Forth
 :author: Marcos Cruz (programandala.net)
-:revdate: 2021-02-03
+:revdate: 2023-04-06
+ifndef::env-github[]
 :toc: macro
+endif::[]
 :linkattrs:
 
 // This file is part of Solo Forth
 // http://programandala.net/en.program.solo_forth.html
 
-// Last modified: 202102030028.
-
-ifdef::env-github[]
+// Last modified: 20230406T0814+0200.
 
-NOTE: This is the GitHub mirror of the actual
-http://fossil.programandala.net/solo_forth[Solo Forth repository],
-which is powered by http://fossil-scm.org[Fossil].
+ifndef::env-github[]
 
-'''
+toc::[]
 
 endif::[]
 
-// XXX FIXME 2021-02-02: The layout of the ToC title is ruined on the
-// Fossil repo when the ToC is placed by `:toc: macro`:
-
-toc::[]
-
 // Description {{{1
 == Description
 
@@ -106,7 +99,7 @@ The motivation behind Solo Forth is double:
    Forth written for ZX Spectrum 128 (the first model with banked
    memory) was Lennart Benschop's Forth-83
    (1988). But despite being more powerful than fig-Forth, it is still
-   tape-based and keeps the block sources in a RAM disk. Beside, the
+   tape-based and keeps the block sources in a RAM disk. Besides, the
    system is built by metacompilation, what makes it difficult to
    adapt to disk drives.
 
@@ -119,10 +112,11 @@ called http://programandala.net/en.program.dzx-forth.html[DZX-Forth]
 On 2016-03-13 a Git repository was created from the development
 backups, in order to preserve the evolution of the code from the
 start, and uploaded to GitHub. On 2020-12-05 the Git repository was
-converted to a http://fossil.programandala.net/solo_forth[Fossil
-repository], keeping
+converted to https://fossil-scm.org[Fossil,role="external"], keeping
 http://github.com/programandala-net/solo-forth[GitHub as a
-mirror,role="external"].
+mirror,role="external"]. On 2023-04-06 the repository was converted to
+https://mercurial-scm.org[Mercurial,role="external"], enabling a
+better interaction with GitHub.
 
 Solo Forth is very stable, and it's being used to develop two projects
 in Forth: