Pliant talk forum

Pliant talk forum

Discussion: documentation updates

New PDA term
Message posted by michel on 2002/10/06 08:03:26
Hi Marcus
For the future I suggest that doc patches will be splited for more lightness:
A generic package /pliandocs/(style + image + samples) if exists + babel but without languges parts.
And specific pacakages as /pliantdocs/babel/en or fr/ or pt/ a.s.o.
A larger /pliant/docs has been sent for corrections to Hubert.
Can you give us the up-to-date /pliantdocs/en/ part and needed general files.
Have you try the last Patrice style ?
Thanks. Friendly. 
Message posted by maybe Marcus on 2002/10/06 23:52:43
"Can you give us the up-to-date /pliantdocs/en/ part and needed general files."

Here it is. Sorry for sending a tar ball, but it's faster (easier) for me to produce that then create a patch with the files you asked.

" Have you try the last Patrice style ?"

No. Not yet. How can I get my hands on it?
Message posted by michel on 2002/10/07 14:22:07
You have to be with Pliant release 76
+ patch 02DKJA2 (Documentation style for release 76), be carefull of the remainig restriction.
+ patch 02DFUN6 (More flexible 'multiline' paerser
Message posted by maybe Marcus on 2002/10/07 16:22:32
So should I first install release 76, then apply those two patches?

I've tried that, but when I try to access a pdi page which uses Patrice's
style, I get the error

Failed to compile compile_dynamic_page   ('source_id'  ?  'physical'  'program'  'count')
  compile /pliantdocs/style/doc.style (internals) 149 18
  compile /pliantdocs/style/doc.style (internals) 149 15
  compile /pliantdocs/style/doc.style (internals) 149 15
  compile /pliantdocs/style/doc.style (internals) 113 1
  compile /pliantdocs/style/doc.style (internals) 113 1
  compile /pliantdocs/style/doc.style (internals) 112 1
  compile /pliantdocs/style/doc.style (internals) 112 1
  compile /pliantdocs/style/doc.style (internals) 112 1
  compile /pliantdocs/style/doc.style (internals) 112 1
  parse /pliantdocs/style/doc.style (internals) 186 1
  module /pliantdocs/style/doc.style
  compile /pliantdocs/babel/en/index.page 1 1
  compile /pliantdocs/babel/en/index.page 1 1
  compile /pliantdocs/babel/en/index.page 1 1
  compile /pliantdocs/babel/en/index.page 1 1
  compile /pliantdocs/babel/en/index.page 4 1
  compile /pliantdocs/babel/en/index.page 4 1
  compile /pliantdocs/babel/en/index.page 3 3
  compile /pliantdocs/babel/en/index.page 3 3
  compile /pliantdocs/babel/en/index.page 2 1
  compile /pliantdocs/babel/en/index.page 2 1
  compile /pliantdocs/babel/en/index.page 1 1
  compile /pliantdocs/babel/en/index.page 1 1
  compile /pliantdocs/babel/en/index.page 1 1
  compile /pliantdocs/babel/en/index.page 1 1
  parse /pliantdocs/babel/en/index.page 170 65533
  module /pliantdocs/babel/en/index.page
  service HTTP request

Message posted by maybe pom on 2002/10/07 19:01:17
You have probably a wrong doc.style (there is no "compile_dynamic_page" in it, but several "do_compile_dynamic_page).

Try to reinstall the patch 02DFUN6

Message posted by michel on 2002/10/08 08:42:55
You have a file "/pliant/pliantdocs/en/tree.pli" which has nothing todo here
and probably is in conflict with "/pliant/pliantdocs/style/tree.pli" from the doc.style patch.
Message posted by maybe Marcus on 2002/10/08 17:54:15
I have fixed that. But the error persists.

Moreover, trying to start from scratch, I moved the whole pliantdocs tree to a 
temporary directory, deleted the pliant tree and reinstalled pliant-76. Then moved
pliantdocs to the correct place inside pliant/; installed the patch 02DFUN6.
Tested the documentation: it works, but for some reason the links 

  "The .page format specification" and "Create a stand-alone Pliant program" 

do not work, even though I have the .page files there, with the proper 
permissions.

When I try to install the patch 02DKJA2, as suggested by Michel, the patch system
informs that there is a conflict in pliant/language/parser/multiline.pli

Any suggestions?
Message posted by michel on 2002/10/08 20:12:29
It is a problem of indentation:
after the instruction "program" the first instruction and the others of the same range
must be exactly 2, th other ranges are free. Don't ask why to me !
I have corrected your
 ~~/en/pliant/protocol/http/page.page and
 ~~/en/pliant/appli/database/index.page 
and now it works. But I have found no problem with the "create stand alone program", I think that
the target did not exist in your patch and I have copied the original "run.page" at the right place.
You will fin the two corrected files in the patch forum. 
Message posted by maybe Marcus on 2002/10/11 23:41:15
Actually, a 'listing' instruction whose body is not indented more then two spaces
also causes a weird message error: "There is no ... page on this site!"

I have also noticed that in the new style, the page created with a 'note' ins-
truction does not keep the PDI colour style. For some reason, the page has the
same colour setting as the Pliant server default one.
Message posted by maybe Hubert Tonneau on 2002/10/12 09:50:35
> Actually, a 'listing' instruction whose body is not indented more then two spaces
> also causes a weird message error: "There is no ... page on this site!"

I've tested here 'listing' instruction with indentation 1, 2 and 3, and it
all did work. Also indentation three bring a space on the left side for each
listing line.

> I have also noticed that in the new style, the page created with a 'note' ins-
> truction does not keep the PDI colour style. For some reason, the page has the
> same colour setting as the Pliant server default one.

That's a more complex problem: a 'note' or 'bottom' is a subpage.
So, on one side it's a different page, with it's own styling rules, and
whould need 'style' instructions to be repeated.
On the other side, Pliant is module oriented so the subpage sees automatically
what the main page sees.
So, I have to grant that the styles selected by the main page automatically
propagates to the subpage.

In very fiew words, this is a bug on my side: I will correct it and publish
a new Pliant release.
Message posted by maybe Hubert Tonneau on 2002/10/12 10:15:09
Marcus,

There is a '02EMPS8.hubert.heliogroup.fr' patch expected to solve your styling
problem, also I cannot test it here since I use the default style everywhere.
I'll put the new release when you tel me that it's ok.
Message posted by michel on 2002/10/12 14:45:07
For me it works fine. (test on Win98SE)
Thanks.
Michel
Message posted by maybe Marcus on 2002/10/12 19:49:29
> I've tested here 'listing' instruction with indentation 1, 2 and 3

You right. My mistake. I must have forgotten some misindented program body
somewhere.

Regarding the style propagation issue, after downloading the patch, things 
work just fine.

Message posted by maybe Marcus on 2002/10/12 20:03:00
Regarding the colours used in the new doc style, I didn't like the colour
currently produced when using 'header' instruction (inside and outside a cell).
It contrasts too much with the white background. 

Since you, Patrice, is the forefather of the new style (and seems to have a 
good taste for colours, which is not my case), could define a 
more "ton sur ton" colour choice for the header instruction? We will all
appreciate it very much.

Message posted by michel on 2002/10/13 06:35:51
I agree
Message posted by maybe Marcus on 2002/10/18 15:03:12
Hi.

I have hacked the doc.style and implemented those colour changes.

What do you think?
Message posted by maybe michel on 2002/10/18 16:17:23
Wher can I find it ?
Message posted by maybe Marcus on 2002/10/18 16:21:06
You mean the doc.style? It's at http://playground.scs.ryerson.ca:8080/pliantdocs/style/doc.style