RetroForum Welcome, Guest. Please login or register.
September 09, 2010, 11:01:13 PM
Home Help Search Calendar Login Register

RetroForth Discussion  |  Older Boards  |  Development  |  Topic: RDML Tools « previous next »
Pages: 1 Go Down Print
Author Topic: RDML Tools  (Read 1650 times)
Charles Childers
Administrator
Sr. Member
*****

Karma: +2/-0
Offline Offline

Posts: 745


View Profile WWW
RDML Tools
« on: December 18, 2005, 09:11:42 PM »

Those following the irc channel and/or my blog know that I've been working on a custom markup language for documentation. I've got the primary markups done and have begun writing a few scripts to generate ascii text and html output. (Other formats of output are coming).

These tools are written as a retroforth program (needs a copy of the development builds of 8.3) and a bash shell script wrapper. (The wrapper is entirely optional and just provided to save some typing).

As to example documentation, there is a simple README, a copy of the RDML specification, and a copy of the Rx Handbook included (look in the publications directory for the latter two).

Anyway, if anyone is interested, get a copy of RDML Tools and give them a try. Comments from anyone who actually tries to write anything in RDML would be appreciated.
Logged
Helmar
Library Contributor
Full Member
****

Karma: +1/-0
Offline Offline

Posts: 129

TUCK what??? SWAP OVER!!!


View Profile
Re: RDML Tools
« Reply #1 on: December 19, 2005, 03:25:27 AM »

Sorry, Charles,

the language has the same charme as groff or in parts also "unified hexdump" (alias XML). Why not make something that has the potential to be a TeX-killer? You would not need much. Important is a better way to markup things. If you only want to copy groff, use groff instead. Or use ... (your favourite discontinued document markup language) ... Perl has PODs, of course - but it's no reason to make the same mistakes. I personally prefer TeX as word processor. A better idea would be to implement something like web2c for FORTH, eg. a "web24", that compiles the web/pascal source to FORTH. I would think this is much more useful.

Helmar
Logged
Luke
Contributor
Jr. Member
***

Karma: +0/-0
Offline Offline

Posts: 11


View Profile
Re: RDML Tools
« Reply #2 on: December 29, 2005, 05:43:12 PM »

Sorry, Charles,

the language has the same charme as groff or in parts also "unified hexdump" (alias XML). Why not make something that has the potential to be a TeX-killer? You would not need much. Important is a better way to markup things. If you only want to copy groff, use groff instead. Or use ... (your favourite discontinued document markup language) ... Perl has PODs, of course - but it's no reason to make the same mistakes. I personally prefer TeX as word processor. A better idea would be to implement something like web2c for FORTH, eg. a "web24", that compiles the web/pascal source to FORTH. I would think this is much more useful.

Helmar

Well you have to start with something. Perhaps this groff-like language can be reshaped into something more palatable (to non-groff-affectionados Smiley ) with the proper words and macros.

Another thing this serves as is a useful example to users who want to make their own custom non-forth language using retro. The code at the end of html.forth shows how to alter it's linked dictionary list to make the forth portion invisible, and how to redefine the error code generator.
Logged
Pages: 1 Go Up Print 
RetroForth Discussion  |  Older Boards  |  Development  |  Topic: RDML Tools « previous next »
Jump to:  


Login with username, password and session length

Powered by MySQL Powered by PHP Powered by SMF 1.1 RC2 | SMF © 2001-2005, Lewis Media Valid XHTML 1.0! Valid CSS!