Subj : Building under Mac OSX
To   : Kai Richter
From : Michael Dukelsky
Date : Mon Dec 13 2021 06:39 pm

Hello Kai,

Monday December 13 2021, Kai Richter wrote to Michael Dukelsky:

 MD>> The correct way of building Husky is described here:

 MD>> https://github.com/huskyproject/huskybse/blob/master/INSTALL.asci
 MD>> idoc

 KR> Is there an important reason for this file and its file extension?

Yes, there is.

 KR> Maybe i blame myself but i've never seen an *.asciidoc before. I don't
 KR> understand why the correct way is not in the common README and INSTALL
 KR> files?

"There are more things in heaven and earth, Horatio,
Than are dreamt of in your philosophy." (C) Shakespeare. :)

There are several markup languages that GitHub can render into a nice looking HTML. One of them is called asciidoc.

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

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

Michael

.... node (at) f1042 (dot) ru
--- GoldED+/LNX 1.1.5-b20180707
 * Origin: Moscow, Russia (2:5020/1042)

.