Re: [Virtuoso-users] Virtuoso Programming Best Practices Documentation generation

2009-09-25 Thread Kingsley Idehen
Aldo Bucchi wrote: Hi, On Thu, Sep 24, 2009 at 2:03 PM, Kingsley Idehen kide...@openlinksw.com wrote: Aldo Bucchi wrote: Ivan, Hugh, Thank you for the pointers. I have read the docs and in particular found some nice code in ( parts of ) the Virtuoso Opensource project which I will

Re: [Virtuoso-users] Virtuoso Programming Best Practices Documentation generation

2009-09-25 Thread Ivan Mikhailov
* What's the criteria to use DB.DBA.procedureName or procedureName? Does the latter resolve to the former qualified name or does it depend on the user? I see a lot of code written in the DB.DBA.* catalog, then I see lots of procedures with no qualification and I also see some places

[Virtuoso-users] Virtuoso Programming Best Practices Documentation generation

2009-09-24 Thread Aldo Bucchi
Hi, 1. I'm looking for Virtuoso programming best practices. Looking at a codebase like ODS I can see several intermixed styles. Any particular corpus that you would say is worth following? ( other than your own code :P ) 2. Any documentation pattern for procedures? Any tool to generate docs?

Re: [Virtuoso-users] Virtuoso Programming Best Practices Documentation generation

2009-09-24 Thread Hugh Williams
Hi Aldo, We have and ODS Programmers Guide available at: http://ods.openlinksw.com/dataspace/dav/wiki/ODS/ODSProgrammersGuide Their is also a general Virtuoso SQL Procedural Language (PL) Guide available at: http://docs.openlinksw.com/virtuoso/sqlprocedures.html PL

Re: [Virtuoso-users] Virtuoso Programming Best Practices Documentation generation

2009-09-24 Thread Aldo Bucchi
Ivan, Hugh, Thank you for the pointers. I have read the docs and in particular found some nice code in ( parts of ) the Virtuoso Opensource project which I will aim to use as guide. In general, I find that the language is so powerful ( PL + SPASQL ) that not having a coding style is dangerous.

Re: [Virtuoso-users] Virtuoso Programming Best Practices Documentation generation

2009-09-24 Thread Kingsley Idehen
Aldo Bucchi wrote: Ivan, Hugh, Thank you for the pointers. I have read the docs and in particular found some nice code in ( parts of ) the Virtuoso Opensource project which I will aim to use as guide. In general, I find that the language is so powerful ( PL + SPASQL ) that not having a coding

Re: [Virtuoso-users] Virtuoso Programming Best Practices Documentation generation

2009-09-24 Thread Aldo Bucchi
Hi, On Thu, Sep 24, 2009 at 2:03 PM, Kingsley Idehen kide...@openlinksw.com wrote: Aldo Bucchi wrote: Ivan, Hugh, Thank you for the pointers. I have read the docs and in particular found some nice code in ( parts of ) the Virtuoso Opensource project which I will aim to use as guide. In