[asdf-devel] notes on the manual discussion of asdf-output-locations
1. The manual in several places uses version 1.6 as synonymous with 1.600. But if we are to eat our own dogfood and comply with our own version-satisfies function, 1.6 ~= (1 6) while 1.600 ~= (1 600) and 600 > 6 I have fixed the references I found. 2. In a couple of places the manual suggests making files with names of the form nn-filename. We should explain what is the purpose of these integers. 3. I don't want to repeatedly have to translate stuff out of read me files. I have put all of the information from the README.asdf-output-locations file into the manual, and killed the README so that it doesn't become an attractive nuisance. I have pushed these changes. I'd encourage everyone to please have a peek at the new manual. Question: I have been assuming that everyone on the list is capable of opening this up in emacs and using texinfo mode to format this to their choice of HTML, info, and pdf. If that is not true, please let me know; it should be possible to put a formatted copy on the ASDF web page for people who are interested in screening the documentation. Best, R
On 12 March 2010 10:47, Robert Goldman <rpgoldman@sift.info> wrote:
1. The manual in several places uses version 1.6 as synonymous with 1.600. But if we are to eat our own dogfood and comply with our own version-satisfies function,
1.6 ~= (1 6) while 1.600 ~= (1 600)
and 600 > 6
I have fixed the references I found.
Thanks. I fixed more of them, and made other updates.
2. In a couple of places the manual suggests making files with names of the form nn-filename. We should explain what is the purpose of these integers.
It's for sorting, so you control the order in which configuration is read.
3. I don't want to repeatedly have to translate stuff out of read me files. I have put all of the information from the README.asdf-output-locations file into the manual, and killed the README so that it doesn't become an attractive nuisance.
OK. Remains the other README.source-registry to merge likewise. Sigh. Getting there. [ François-René ÐVB Rideau | Reflection&Cybernethics | http://fare.tunes.org ] The problem with most conspiracy theories is that they seem to believe that for a group of people to behave in a way detrimental to the common good requires intent. The problem with most statist theories is that they seem to believe that for a group of people to behave in a way beneficial to the common good requires intent.
On 3/12/10 Mar 12 -10:55 AM, Faré wrote:
On 12 March 2010 10:47, Robert Goldman <rpgoldman@sift.info> wrote:
1. The manual in several places uses version 1.6 as synonymous with 1.600. But if we are to eat our own dogfood and comply with our own version-satisfies function,
1.6 ~= (1 6) while 1.600 ~= (1 600)
and 600 > 6
I have fixed the references I found.
Thanks. I fixed more of them, and made other updates.
Great. Thanks will pull.
2. In a couple of places the manual suggests making files with names of the form nn-filename. We should explain what is the purpose of these integers.
It's for sorting, so you control the order in which configuration is read.
Right. We just need to say so.
3. I don't want to repeatedly have to translate stuff out of read me files. I have put all of the information from the README.asdf-output-locations file into the manual, and killed the README so that it doesn't become an attractive nuisance.
OK.
Remains the other README.source-registry to merge likewise.
Sigh.
Getting there.
Yes, I should have mentioned that. I was doing them one at a time. I will /try/ to get this done sometime today, but it may slip into the weekend. Hard to squeak time in for this. r
participants (2)
-
Faré -
Robert Goldman