Re: [sc-dev] general question about the GUI helpfiles

[Julian Rohrhuber <rohrhuber@xxxxxxxxxxxxxx>]

> We need to be able to auto generate the redirect stubs, since their
> links must point to different paths. The only way to do this is to put
> the examples in yet another file, and have that auto included by the
> stub generator.
>
> This starts to get complicated. I also don't relish the task of making
> all those example cross platform compatible.
> Some definitely already are not.


I didn't want to complicate things, rather to avoid complications.

My suggestion would be to use, wherever possible, platform 
independent code. Usually, code examples are just copied and pasted, 
so not using the redirectors means incompatible code.

e.g. in SCPen helpfile, one example

// Pen is a view redirector and returns SCPen in CocoaGUI:
Pen.new // SCPen


after this, all examples should be using Pen, not SCPen, I think. But 
maybe there are better arguments against this?




> jost
>
>
> Julian Rohrhuber wrote:
> >  Wherever the view redirectors are to be compatible with different
> >  implementations, shouldn't the examples be moved to the redirects?
> >  This would encourage platform independent code. Sorry, I may have
> >  missed some of the discussion.
>
> _______________________________________________
> sc-dev mailing list
>
> info (subscription, etc.): 
> http://www.beast.bham.ac.uk/research/sc_mailing_lists.shtml
> archive: https://listarc.bham.ac.uk/marchives/sc-dev/
> search: https://listarc.bham.ac.uk/lists/sc-dev/search/


--





.

_______________________________________________
sc-dev mailing list

info (subscription, etc.): http://www.beast.bham.ac.uk/research/sc_mailing_lists.shtml
archive: https://listarc.bham.ac.uk/marchives/sc-dev/
search: https://listarc.bham.ac.uk/lists/sc-dev/search/