Subj : Building under Mac OSX
To   : Michael Dukelsky
From : Kai Richter
Date : Tue Dec 14 2021 11:24 am

Hello Michael!

13 Dec 21, Michael Dukelsky wrote to Kai Richter:

 KR>> Maybe i blame myself but i've never seen an *.asciidoc before.

Ok, i did. :-)

 MD> https://en.wikipedia.org/wiki/AsciiDoc

 MD> GitHub demands a document written in asciidoc format to have a
 MD> filename extension of .asciidoc, .adoc, or .ad for correct rendering.
 MD> I'm not too fond of the two last variants, so I chose the first one.

I do agree. While Wikipedia shows a very simple example the homepage of asciidoc shows a lot of more. Very interesting is FAQ 15 "preferred file name extension for AsciiDoc files is .txt". Well, github may have reasons. (Not may, they do have, of course.)

Sigh... there are so many standards that there is no standard anymore.

As far as i understand you do a rebuild/upgrade of the make system. With the old INSTALL and the new INSTALL.asciidoc we have a transition phase. I'd like to suggest to add a soft link to INSTALL.asciidoc with 2 or 3 lines explanation into the INSTALL or README file.

Regards

Kai

--- GoldED+/LNX 1.1.4.7
 * Origin:  Monobox  (2:240/77)

.