User Guide Rough Draft

[Michelle Strachan]

Here is an attempt at a user guide for the current version of zPE. 

Under the saving a file part, I'm not sure if "y" and "w" or "n" and "!" or "q" and "c" do the same thing. It just appeared that way and I wasn't sure what else they could do.

Anything you think I should add/modify?

Michelle

[Georgia Brown]

Can you (or Tony since I think he's the one who knows the most about it) put in a little about using the command line version?
I had another thought about something for next year: the one comment I got about it was that it needs a step-wise execution/debugger. If it had that, it would be better than anything else out there that I know about (including Marist/TSO). I also think that since you can turn debugging on and get a list of each of the instructions as it executes, that the basic part of that is ready to go. 
I cannot meet next Monday in the morning. We could try for 1 pm on Monday, or 2 on Tuesday. (I just realized that next week is the last week of classes!  and I think everyone needs to declare their job done for the semester by the middle of next week.)
So Nick is working on a youtube video for using the system?
Stuart - Michelle said you were having trouble with getting an icon for the desktop? At some point, put some notes up that give the subdirectory of the exe file and tell them to make their own. (and can you write up for me how you made the installer so if I have to do something with it?)
Michelle is working on a users guide and going to work with Tony on the reorganizing if they can schedule a time.
And finally, Dr. Duffin said he thinks we can install it on turing (or whichever machine) but he needs to know what goes where. I am assuming that would be the command line version (which is why I'd like that added to the users guide).
Georgia

[Tony Zhang]

If you look at here: "y" (yes) == "w" (write), "q" (quit) == "c" (cancel), and "n" (no) == "!" (vi uses this...)

One other thing I noticed is about the "Tab": the default binding for "Tab" is the function "align_or_complete", which do completion at word-end and alignment otherwise. If the user want them separate, they can re-bind "align_line" and "complete" separately.

To align the entire program, instead of hit "tab" at each line, bind the function "align_region" and do a "select all" from right-click menu (or key-binding "set_mark_select_all") and then "align_region". Notice that this will still be slow (several seconds for an average-length file).

Hope those make sense.
Best,

On Mon, Apr 23, 2012 at 5:33 PM, Michelle Strachan <mstrac...@gmail.com> wrote:

--
Tony (Chi Zhang)

[Tony Zhang]

Can you (or Tony since I think he's the one who knows the most about it) put in a little about using the command line version?

Try `zsub -h` and `zfetch -h` commands. Otherwise, I can write one after this weekend.
 

I had another thought about something for next year: the one comment I got about it was that it needs a step-wise execution/debugger.

Something like "gdb"? What functionalities do you want?

If it is simply "executing 1 instruction at a time" + some printing out, I can down it before summer semester starts.

If you want a full-featured debugger that supports "break point", "source listing", "label referencing", etc., I guess it will turn into a 1-semester project.

Michelle is working on a users guide and going to work with Tony on the reorganizing if they can schedule a time.

Currently we're planning at 2:00 pm this Sunday. Again, anyone are welcome to join us.

 

And finally, Dr. Duffin said he thinks we can install it on turing (or whichever machine) but he needs to know what goes where. I am assuming that would be the command line version (which is why I'd like that added to the users guide).

Great. I'll try to find a time to talk with him.

--
Tony (Chi Zhang)

[Georgia Brown]

For now, just stepping through one instruction at a time. Don't worry about it - it was just a thought.
G

[Georgia Brown]

Here is a rough, very rough draft of what could become a paper. Tony, I changed all the personal pronouns to be generic, but I'll check with Reva to be sure. I just think it sounds better. I added some stuff about the Z390 system (and how this is better:). I think we need at least one screen shot of the GUI, but haven't decided on what exactly. Can each of you, perhaps, add or send me a paragraph or so of what you did and I'll see if I can incorporate it? The first and second pages have a lot of overlap and I will edit that down. Tony, I'm thinking some examples of some of the parsing code might be interesting(ie a simple one and one that is more complex).
If you all don't send me anything, I'll make something up, so don't ignore this!
Georgia