• Previous message: Rajit Manohar: "Re: documentation needed"
• Maybe in reply to: Mikael Sahrling: "documentation needed"
• Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]

Mikael Sahrling <mikael AT mta5 DOT snfc21.pbi.net> wrote:
> Gentlemen,
>
> It seems to me the documentation for the new magic 7.1 system needs
> some improvement. By chance, I happened to see there were new
> commands introduced like 'parent cell' and 'child cell' but they can
> not be found in any document. Also the new scheme interpreter need
> serious attention regarding it's documentation. I tried some of the
> commands in the tutorials like stack.p, stack.ptall but they failed
> miserably. It would very instructive to have some WORKING example
> scripts one could learn from.
>
> Thanks,
>
> Mikael Sahrling

I am the person responsible for adding the 'parent' and 'child'
commands (as well as a few others), and its true that I did not update
the documentation accordingly.

However, if you type "help parent" in magic, you *will* get a brief
description of the command.  This is true for all commands in magic.
You can also type "help" by itself to get a complete listing of *all*
the magic commands.

It would be nice to have all the commands described in the "man" page,
and even nicer to have a tutorial for each of them, but that would be
a lot of work.

BTW, when I implemented 'parent' and 'child,' I thought they would be
very useful commands.  However, I never use them unless I'm looking at
someone else's layout.  I find the 'xview' (same as view, but
unexpands subcells first) and my modifications to the 'box' commands
much more useful.

Philippe Pouliquen
The Johns Hopkins University

• Next message: Salvatore Russo: "info!!"
• Previous message: Rajit Manohar: "Re: documentation needed"
• Maybe in reply to: Mikael Sahrling: "documentation needed"
• Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]