<tp>
hey tabemann, I looked at your GAS compat dissasembler
<tp>
tabemann, nice work, and one doesnt need the adresses anyway
Zarutian_HTC has joined #forth
Zarutian_HTC has quit [Read error: Connection reset by peer]
Zarutian_HTC has joined #forth
TCZ has quit [Quit: Leaving]
TCZ has joined #forth
Zarutian_HTC has quit [Read error: Connection reset by peer]
Zarutian_HTC has joined #forth
boru` has joined #forth
boru has quit [Disconnected by services]
boru` is now known as boru
<tabemann>
back
<tabemann>
now the question I have is what the heck do I do with zeptoforth now
<tabemann>
other than port it to another platform
<tp>
implement "bit@" ?
<tp>
once I have bit@ I think I can make sure svd2forth can be uploaded
<tp>
then you can make a usefulbinary release with all the common peripherals
<tp>
tabemann, personally I think you have to do a lot of work on the documentation, it's a bit sparse and doxygen like.
<tabemann>
what is the signature of bit@ (and I presume bit!)?
<tabemann>
tp: my *words.html documentation really is that, which is why I created the *guide.html documentation
<tp>
tabemann, i was reading a post by the 'propforth' guy, who opened an account on sourceforge just to try and get some of the readership of Mecrisp-Stellaris
<tp>
cbit@ ( mask c-addr - - flag ) Test BIts in byte-location
<tp>
hbit@ ( mask a-addr - - flag ) Test BIts in halfword-location
<tp>
bit@ ( mask a-addr - - flag ) Test Bits in word-location, If a Bit is HIGH it leaves TRUE on the stack, otherwise LOW leaves FALSE
<tp>
tabemann, the html is easily read in a browser, but there is no index etc
<tabemann>
I'd call the first bbit@, because I've been been using "b" to mean "byte", since to me characters need not be single byte (e.g. UTF-8)
<tp>
tabemann, I'm not criticising, very FEW projects have great doc
<tp>
tabemann, you cant be a awesome programmer and doc writer, in fact those two skills do seem to me mutually exclusive
<tp>
I have noticed that most github projects seem to lack useful documentation for some reason
<tp>
soe do have good doc but only after they went and made their own apps to do it
<tp>
some
<tabemann>
well github projects seem to be off-the-cuff hackery by random people
<tabemann>
*most
<tabemann>
only a small fraction seem to be serious development projects that are treated as actual products
<tp>
I think github is lacking in the doc department myself, maybe someone else here has a opinion on that ?
<tp>
but even if github had awesome doc generation help, would most github projects use it ? probably not
<tabemann>
github's support for documentation is mostly just markdown
<tp>
yeah
<tp>
and yet markdown doesnt even have support for TOC and index generation
<tabemann>
yeah
<tabemann>
I think this is an issue with a lot of FOSS documentation generation tools
<tp>
I see the attraction of markdown and use it myself for the generation of my projects README.html but thats all atm
<tabemann>
almost all of them are essentially just doxygen
<tp>
tabemann, I agree, but oddly the python people solved that early on with py.sphinx
<tp>
they made py.sphinx to do the all the python documentation, and it's damn good
<tp>
which is why Ive been using it since 2016 for my 'unofficial mecrisp doc"
<tabemann>
are you suggesting I switch over to it?
<tp>
all markdown,markup langs are kinda similar, but py.sphinx has all the other support one may want. It also generates epub etc
<tp>
no, doc is a personal thing, it's wrong to push ones pref on anyone
<tp>
I only mention it in passing to you
<tp>
Id love to see more integration and support for markdown
<tp>
in fact I spent a couple of days trying to add automatic toc and index generation to you /doc directory
<tabemann>
I have an idea!
<tp>
but I failed badly, it's still too bitsy and I lack a lot of the programmer knowledge
<tabemann>
modify the markdown > html converter tool I have to generate indices
<tp>
yeah, I trued a few apps
<tp>
tried
<tp>
problem is they mainly grep thru the markdown and try and build a doc system
<tp>
the code is pretty nasty, the kind of stuff Im alergic to
<tp>
tabemann, I think your idea is a great one
<tabemann>
the problem is that it IIRC is written in perl
<tabemann>
and I hate perl
<tabemann>
I don't understand perl
<tabemann>
I remember trying to learn perl a long, long time ago
<tp>
tabemann, it would need to srart at the beginning and end at the end also, rather than just jumble your individual .md files together ?
iyzsong has joined #forth
<tp>
oh forget perl!
<tp>
there are others in other langs
<tabemann>
until I saw python and quickly dumped perl for python
<tp>
theer are Perl apps that do the same
<tp>
i mean python!
<tp>
py.sphinx is python and I must say, it's been bug free for me so would do a good job with markdown I expect
<tp>
in fact Id assume there are already a few such apps avail
<tp>
there are rather large java or js based ones also
<tabemann>
back
<tabemann>
okay, I'm looking at the source of Markdown.pl and it scares me
<tp>
tabemann, no programmer likes doc, (the fact I do has to indicate Im not a programmer) but the sooner you sort yours out, the better your projects will be
<tp>
I understand Perl pre OO
<tabemann>
it's a pile of the worst kind of regex-infested perl
<tp>
it's just like a mixture of everything, but I think you could abandon that one entirely
<tp>
it's useful for people like me, but Id expect programmers to hate it
<tp>
have a Google for the same thing in Perl, must be heaps of them
<tp>
oops
<tp>
have a Google for the same thing in Python, must be heaps of them
<tp>
or maybe haskel or whatever you prefer ?
<tp>
or C
<tp>
mar`kdown is universally (mis)used thesedays by everyone
<tp>
SMU produces html output exactly like you do with zeptoforth
<tp>
and SMU is written in C and very well known
<tp>
smu 1.5 Simple markup
<tp>
Smu is a very simple and minimal markup language. It is designed for using in wiki-like environments. Smu makes it very easy to write your documents on the fly and convert them into HTML. Smu is capable to parse very large documents. As long as you avoid an huge amount of indents it scales just great.
<tp>
Smu was started as a rewrite of Markdown but became something more lightweight and consistent. The biggest difference between Markdown and smu is that smu doesn't support reference style links.
<tp>
i used smu to make a single html file of your /doc dir
<tp>
but it only contained the top level headings, was useless
<tabemann>
back
<tabemann>
I'm going to try out py.sphinx
<tabemann>
because it can plug in other code to use markdown
<tp>
cool
<tp>
I know it very well if you have any questions
<tp>
tabemann, I think using py.sphinx helped the Mecrisp-Stellaris takeup, and I do get emails every month or so thanking me for it and asking me to keep the site up (which at least is no cost being all OSS on sourceforge)
TCZ has quit [Quit: Leaving]
iyzsong has quit [Ping timeout: 265 seconds]
<tabemann>
haha
<tabemann>
it's brilliant
iyzsong has joined #forth
<tabemann>
nearly effortless documentation complete with contents and index
<tp>
so true, and damn good looking html as well
<tp>
I do some doc, hit make and it's done with error messages if there are any
<tp>
then I click on my menu 'upload doc' and it's rsynced to sourceforge
<tp>
plus it has cross refs
<tp>
which I use all the time
<tp>
I always use 'sphinx-quickstart' and only change my default theme later
<tp>
otherwise I go with all the defaults
<tabemann>
back
<tabemann>
hmm the index is blank
<tabemann>
how do I get "genindex" to work
<tabemann>
and I understand that "modindex" won't work because, well, there are no modules
<tp>
so github is restricted to markdown and text ?
<tp>
no wonder I loathe github, there are so many reasons I cant possibly remember them all :)
<tabemann>
I haven't heard of github doing RST at least
<tp>
maybe they do ?
<tp>
try uploading a page and see if it renders ?
<tabemann>
actually...
<tabemann>
GitHub does support RST
<tp>
awesome!
<tabemann>
but the thing is I don't want to rework my docs to be RST just so I can have an index which I'd have to manually specify anyways
<tp>
but ... a manual index is dead eay to do and beats autogenerated crap
<tp>
the trick is to do it from the start'
<tp>
not at the end of a project
<tp>
tho I appreciate leaving things one loathes until last, Ive been a proponent of that method all my life
<tp>
luckily I started my docs in py.sphinx and it's all built up slowly as I went
<tp>
now it's pretty big with cross refs *everywhere*
<tp>
occasionally some Internet spelling nazi will let me know Ive mispelled something but in general the topics are so complex no one understands them enough to criticise ;-)
<tp>
matthias has one text file (readme) with his releases, it's ok but ... text
<tp>
after doing my unauthorised Mecrisp-Stellaris documentation for 4 years, matthias asked me if I'd like to change the title to "Official Mecrisp-Stellaris Documentation" but by them I'd kinda become fond of my original name
<tp>
and so I kept it
<tabemann>
heh
<tabemann>
I've got a question about bit@
<tabemann>
does it test for any bit or for all bits?
<tp>
Ive only ever used it to test for one bit
<tp>
it's easy to find out tho
<tp>
but I use it for testing flags
<tabemann>
because that's kinda important for me to know before I implement the thing
<tp>
in fact it's auto inserted into a cmsis-svd transform when the description field contains 'flag'
<tp>
okies i'll test it and post a url to my results ready for you tomorrow :)
<tp>
it being about your zz time ?
<tp>
I'll make up a page for my doc site with examples and results
<tabemann>
I'm not going to hit the sack quite yet
<tabemann>
some days I'm sleepier at this time of the day than others
<tp>
makes sense
<tp>
are you back at work yet or still working from home ?
<tabemann>
I'm back at work
<tabemann>
spent my day, except when eating or drinking (with no one else around), wearing a mask
<tp>
everything is back to 'normal' here also, I went to a supermarket yesterday and it was packed
<tp>
I wish I'd worn one yesterday
<tp>
but I had no idea that Coronavirus has been cancelled here
<tabemann>
what happened here is that the conservatives in the legislature convinced the WI supreme court to shoot down the governor's "safer at home" order
<tabemann>
and fuckloads of people immediately went to bars
<tabemann>
in turn, in a number of counties here the local gov'ts reinstituted their own safer at home orders
<tp>
it's inevitable anyway I think, people will only stay cooped up for so long
<tp>
the crime rate has gone thru the roof in the last few days
<tabemann>
but as the county I'm in right now is dominated by conservatives, that's not going to happen
<tp>
we had people trying to break in thismorning
<tabemann>
why?
<tp>
and the day before next door had guys break in and one had a knife and no pants, chased the residents wife around
<tabemann>
wtf
<tp>
i dunno, I suspect all the post covid unemployment and the broke people is behind it
<tp>
that was at 9pm one day ago
<tabemann>
they thing I don't get is why no pants
<tp>
i think he had rape on his mind
<tabemann>
were they on bath salts or something?
<tp>
yeah that also maybe
<tp>
this place is usually like a cemetery as it's a fenced industrial area
<tp>
at least my fence has barbed wire and is fully locked past 7:30 pm each nite
<tabemann>
you live there?
<tp>
yes
<tp>
I live in a shed
<tp>
a 20 metre by 15 metre industrial shed
<tp>
full of my equipment
<tabemann>
I'm imagining one of those prefabricated hemicylindrical steel buildings
<tp>
no, it's rectangular, gable roof, painted blue, huge carpark
<tp>
3 massive roller doors, high enuf to take trucks with shipping containers
<tabemann>
on another note, I'm amazed that the HTML that sphinx generates includes built-in search functionality
<tp>
it's a pretty convenient building, especially with the high barbed wire fence and gates that are locked up and checked by security guards every night
<tp>
tabemann, thats provided by JS
<tabemann>
of course
<tabemann>
but a lot of the time when there's online search provided by documentation, they just use google to do it rather than integrating it themselves
<tp>
I have no complains after using it for 4 years, and I have a number of py.sphinx doc setups
<tp>
I find I use it a lot to find my own info in my own doc
<tp>
what I do is just rsync the /build/html directory to the webserver
<tp>
I compile it here on this pc, then just rsync the html, fast and works great
<tabemann>
back
<tabemann>
okay, I tested it using mecrisp-stellaris
<tabemann>
: bit@ ( mask addr -- flag ) @ and 0<> ;
<tp>
I suspect it works on all set bits ?
<tabemann>
I presume so
<tp>
$ff variable bitstest ok.
<tp>
this being a halfword needs the following test
<tp>
$ff bitstest hbit@ . -1 ok.
<tp>
$00 bitstest cbit@ . 0 ok.
<tp>
$0f bitstest hbit@ . -1 ok. hmm
<tp>
i need to do this properly in a doc page
<tabemann>
that looks correct
<tp>
I've only ever used it in the "bit@" version to test flags so I need to look at all of them, if Im confused the 10% of the other worldwide Forth users may be also, i.e. 4.2 people
<tabemann>
there's more forthers than that out there