Hello,
I've started in on a documentation set for Unicon.
Early, (very early) sample at http://peoplecards.ca/unicon/index.html
and http://peoplecards.ca/unicon/unicon.html and PDF trial at
http://peoplecards.ca/unicon/UniconProgramming.pdf
If this works out, and it looks like it will, I'd like to pester the
good folk here for some accurate details on background, proper name
spellings, and other odds and sods, so I don't lie on the introductory
pages, or miss anyone that deserves mention. (I hope I didn't overstep
any bounds snagging that logo temporarily, as that is also one of the
early questions, where to find approved art for third-party fan docs).
The Pygments lexer seems to be working out, but there is a lot more work
to get all the details right, and those won't be right until I get a
little more used to the ins and outs of Icon/Unicon syntax. It'll be a
few days/weeks/.../ before the code will be in shape to submit to team
Pocoo.
As a little background, I've been working on a GnuCOBOL document for
some 8 years now, it's just passing the 1,200 working toward the 1,300
page mark. That document is homed on SourceForge at
http://open-cobol.sourceforge.net/faq/index.html
(We don't have a unicorn, we use Sire the workhorse as a mascot for the
COBOL project)
If the Icon/Unicon Pygments lexer gets approved, it should show up as a
feature on SourceForge shortly thereafter; (writing the GnuCOBOL FAQ was
where the COBOL syntax highlighting came from originally, as I wanted
the listings in colour). It turned out to be a subsystem used on the
forge, and it really does help put a snap on the Discussion forum posts.
If you don't turn up Discussions, it'll still be there to highlight
source listings in the trouble tickets, and the other places where you
use SourceForge. But again, more work to do, and I haven't talked with
Georg Brandl in a while, so I'm not sure how swamped he is, and it'll
have to be submitted, approved, and then some delay before the Allura
team will upgrade the Pygments install, as their schedules permit. As a
bonus, Pygments is used on Wikipedia as well, so colour listings will
work on those pages too, along with what might already be there for
Geshi in MediaWiki.
That's all beside the point at this stage. For now, I'd appreciate it
if someone could drop responses on the Who's who of Unicon, and the
When's whens, etc.
Please feel free to critique and criticize, and/or tell me to halt. If
it's ok, I'll be working on this for a while, and I like to post early
and often, and I'm always up for being corrected. These docs will have
a free license. But I don't usually put a license on posts until I feel
that a work is ready for redistribution by others. If the Unicon
project has a licensing preference, I'd like to hear about it, and I'll
match to suit, as long as freedom free is part of the choice.
Along with the ReStructuredText there will be Markdown pages and a
Fossil repository of all the code listings I plan to pepper the document
with, for people to pull from.
Lots to learn, lots to polish, and it's already way too much fun. I
never had a chance to work with co-expressions when I was using Icon
back in the 80s, 90s, but I was mightily impressed experimenting with
them today. So many features to explore.
Thanks for Unicon, and once again, feel free to critique and/or yell at
me. I do all my work using GNU/Linux, so this doc set will be focused
from that point of view, if that means anything to anybody.
Have good, make well,
Brian Tiffin
btif...@gnu.org
P.s. I've updated the Rosetta code language popularity entry, so feel
free to yell at me about that one as well.
------------------------------------------------------------------------------
_______________________________________________
Unicon-group mailing list
Unicon-group@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/unicon-group
------------------------------------------------------------------------------
_______________________________________________ Unicon-group mailing list Unicon-group@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/unicon-group
