Re: <? or
Posted by Massimo Manghi <ma...@unipr.it>.
On Mon, 01 Nov 2010 14:58:00 +0100, Harald Oehlmann wrote
> All examples within the rivet folder doc/examples use the magic sequence
> "<?" instead of "<?".
>
> This does not work on my SuSE installation. The script part is not
> recognized as script and is returned verbatim.
>
> The file hello.rvt has the contents:
> <?
> puts "Hello World"
> ?>
> -EOF-
>
> I had to modify it to:
> <?
> puts "Hello World"
> ?>
> -EOF-
> to work.
> -----
it's true, the doc/examples directory is perhaps a misleading name. They were
not meant to be examples ready to be run out of the box, 'doc/examples' was
meant to be a directory where code examples had to be put before inclusion
into the manual.
We may explore the possibility to save them in their pristine form and then
let the xslt processors transform them if possible (an xslt processor can do
it?) I have to study the problem, but I can't promise to do it right away.
> Massimo once gave me the following sequence to test the installation:
> <?
> package require Rivet
> package require Session
> package require DIO
> package require form
>
> puts "<b>I got right here!</b>"
> ?>
> -EOF-
> This also detects if "itcl" is installed, very handy.
>
> I would propose to:
> - modify all examples to use "<?" if this is correct.
we may create an archive of the working examples and put it on the website,
while we examine the problem of handling them.
> - add the test example
> - write some text in the installation.html how to test the installation:
> - copy test.rvt to the web server
> - call it by browsing to "http:<server>/<path-to>/test.rvt
>
ok
-- Massimo
---------------------------------------------------------------------
To unsubscribe, e-mail: rivet-dev-unsubscribe@tcl.apache.org
For additional commands, e-mail: rivet-dev-help@tcl.apache.org
Re: <? or
Posted by Damon Courtney <da...@tclhome.com>.
< and > put the actual less than and greater than symbols into the document. The Rivet parser will not recognize them as control characters. We would only tend to use < and > in the documentation when you're trying to show what code should look like in an example. If you were to View Source of the document, you would see that text, but the page itself should show the proper code.
So, to be clear,
<? puts "Hello World!" ?>
is how you would write a code example in documentation, and:
<? puts "Hello World!" ?>
is how you actually write the code.
Damon
On Nov 1, 2010, at 8:58 AM, Harald Oehlmann wrote:
> All examples within the rivet folder doc/examples use the magic sequence
> "<?" instead of "<?".
>
> This does not work on my SuSE installation. The script part is not
> recognized as script and is returned verbatim.
>
> The file hello.rvt has the contents:
> <?
> puts "Hello World"
> ?>
> -EOF-
>
> I had to modify it to:
> <?
> puts "Hello World"
> ?>
> -EOF-
> to work.
> -----
> Massimo once gave me the following sequence to test the installation:
> <?
> package require Rivet
> package require Session
> package require DIO
> package require form
>
> puts "<b>I got right here!</b>"
> ?>
> -EOF-
> This also detects if "itcl" is installed, very handy.
>
> I would propose to:
> - modify all examples to use "<?" if this is correct.
> - add the test example
> - write some text in the installation.html how to test the installation:
> - copy test.rvt to the web server
> - call it by browsing to "http:<server>/<path-to>/test.rvt
>
> Harald
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: rivet-dev-unsubscribe@tcl.apache.org
> For additional commands, e-mail: rivet-dev-help@tcl.apache.org
>
---------------------------------------------------------------------
To unsubscribe, e-mail: rivet-dev-unsubscribe@tcl.apache.org
For additional commands, e-mail: rivet-dev-help@tcl.apache.org