Show Posts

This section allows you to view all posts made by this member. Note that you can only see posts made in areas you currently have access to.


Messages - Josh @ Dreamland

1921
Announcements / Re: Documentation
« on: May 26, 2010, 04:07:08 PM »
Luis: This isn't the format for function documentation; only for system overviews and philosophical goo.

1922
Off-Topic / Re: Post a picture of yourself!
« on: May 26, 2010, 10:01:17 AM »
I lacketh a picture.
If it makes you feel any better, it took me a minute to realize that YMCA was backward and another minute to realize why. I should nap before I start coding again. -_-"

1923
Announcements / Re: Documentation
« on: May 26, 2010, 02:35:38 AM »
*calmly replaces tables with divs*

1924
Announcements / Documentation
« on: May 25, 2010, 09:23:55 PM »
ENIGMA's spent most of its life without a decent documentation. Now it gets a colorful one.

Gary (MahFreenAmeh) and I have been working over the last couple days (between his work and my stats project, now complete) on a parser to convert plain-text documentation into a rather lovely visual display. The display is meant for newer browsers with real features. This basically excludes IE automatically.

Anyway, the first of the documentation (thrown together only for purposes of testing the parser, so it's kind of ugly yet anyway) can be viewed here:
http://enigma-dev.org/docs/pages/test

For now, the docs use PNG. All PNGs, including the ENIGMA Logo, are merely renders of SVGs, which the docs will use ASAP. I want an all-text documentation, basically. Docs themselves being plain text, images being SVG which, as I'm sure most of you know, is just XML.

Anyway, do view the test page and post your thoughts. Feel free to recommend ways to beautify or simplify.
Do not complain that the layout uses tables, or I will track you down and murder you in a highly creative manner.

I guess I will start typing up more docs as soon as Gary has a method of adding to them arranged.

Should be interesting.

Peace. Unless you have a vendetta against tables.

1925
Proposals / Re: Recursion
« on: May 25, 2010, 05:24:36 PM »
Yes, because it'd be a crying shame for it to not have a return value for the first processor with a stack size and clock speed of infinity to exit with.

1926
Proposals / Re: Recursion
« on: May 25, 2010, 03:25:30 PM »
Code: (C) [Select]
int main();
void recursion(){
    main();
}
int main(){
    recursion();
}

fix'd

1927
Justme: I assume you are on Windows. Correct? Can you confirm that ENIGMA's executable, compileEGMf.exe, is in the same directory as LateralGM's *.jar? Assuming it shipped that way, I need you to confirm that Java is being executed from ENIGMA's directory, not from the location of, for example, a shortcut elsewhere on your system.

The hope is that R4 fixes all of these problems, but large chunks of R3 do not exist in R4, so for now you are better off troubleshooting or waiting a couple weeks.

1928
Announcements / Re: Install script - Ubuntu
« on: May 23, 2010, 06:03:56 PM »
He edited it. :P

1929
Announcements / Re: Experimental GM7/8 saving support in LGM.
« on: May 23, 2010, 12:09:17 AM »
I smell treason. Or is it bacon...

1930
Proposals / Re: Documenting stuff in a more centralized location
« on: May 22, 2010, 06:17:43 PM »
No point, really.

1931
Proposals / Re: Documenting stuff in a more centralized location
« on: May 22, 2010, 04:45:44 PM »
That's a pain in the ass. They're stored in an SQL database, and the intention is to make it somewhat of a Wiki.

1932
Proposals / Re: Documenting stuff in a more centralized location
« on: May 22, 2010, 12:05:55 PM »
Ah, indeed... These SFML docs are very nice. I had to question whether Doxygen had actually produced them, in fact. They've well-structured the mess of methods that need documented from each class... very easy to navigate. I'd really like to use this, in fact, but it introduces a few issues we'll need to handle...

1) We need a way to document the functions ENIGMA puts at the users disposal in a method with which LGM can interface.
2) Although these are very detailed on a per-function basis, I don't see where they've outlined the overall structure of the project (probably because, as a multimedia library, there's no need to).

In fact, the latter gives me my doubts... It seems that Doxygen becomes ugly when there's a lot of interactions between multiple systems. Like Pidgin; I have no idea how they structure protocol plugins because nothing will let me traverse what is called from the UI down. The care they'd have to put into that seems to surpass the structure of Doxygen's output...

If I used this, we'd have a very nice display of what each function does, but we'd have no illustration of what that looked like in the big picture, and we couldn't really use that to allow LGM to give users information about a function based on a downloaded INI/whatever. Unless Doxygen has some API to retrieve lists of such, but even then it would quickly turn into a clusterfuck: LGM is only concerned with docs for functions included from the main source; the ones ENIGMA users can access.

I will look into a workaround with Gary. Maybe Doxygen can cover us, or maybe we can integrate both systems. Doxygen could generate similar docs for individual functions not in main.cpp; the Markdown-like structure I proposed elsewhere could give "bigger picture" documentation and differences between key systems in GM and ENIGMA; and the database-based system Gary has already coded could provide EDL function documentation which would be available to LGM in some easily traversed format. In fact, I'm liking that idea.

We'll continue with what we've already started for now, and then we'll work on getting Doxygen up for other sources, I believe. I will have to talk this over with a2h or Gary, of course, as websites aren't really my forte.

1933
Announcements / Re: Install script - Ubuntu
« on: May 21, 2010, 09:56:26 PM »
You know, as long as this script is for Linux, you may as well call my makefile generator script under CompilerSource/genmake.sh. It'll make sure the damn makefile is current. Would be convenient if SVN could call that thing before commit.

1934
Proposals / Re: Proposed Central Documentation Format
« on: May 21, 2010, 06:41:59 PM »
Assuming Markdown is the format off which I based this idea, it's very nice but unfocused. This format is more tailored to ENIGMA's docs, I hope. I intend to ask Gary for a method of indexing based on group. For example, all --Inconsistency----- Labels, marking differences in behavior between GM and ENIGMA, would be nice if listed for quick lookup.

1935
Proposals / Re: Documenting stuff in a more centralized location
« on: May 21, 2010, 06:22:32 PM »
Doxygen is a sad excuse for what could otherwise be a navigable system. I don't want to put too much effort into this, but I less want to put too little. Doxygen made developing for Pidgin my nightmare. I would never wish that on anyone.