Re: Documentation again

[Thorsten Jolitz]

Alexander Burger  writes:

> I think you'll know the function
>
>http://software-lab.de/doc/refD.html#doc
>
>
> I mostly use it directly from a shell window, with a script 'doc' in my
> executable path
>
>#!/usr/bin/pil @lib/debug.l
>(raw T)
>(doc (opt) (opt))
>(bye)
>
> It is called as
>
>$ doc mapcar
>
> and directly opens the right browser window. I have 'w3m' as my default
> browser, so this is blindingly fast, but any other browser works just as
> well. If e.g. Firefox is already open, it connects to it and just opens
> a new tab.

In case you are an Emacs user, you can reuse your muscle memory, since
in eled.l (the emacs version of the pil line editor) I reused some
well-known C-h bindings from Emacs:

,
| Help/Info/Debugging
| 
| | action| keys  |
| |---+---|
| | debug | C-h d |
| | unbug | C-u C-h d |
| | file info | C-h i |
| | symbol doc| C-h f |
| | show symbol   | C-h s |
| | pretty print (pp) | C-h p p   |
| | pretty print (pretty) | C-h p r   |
`

(see http://picolisp.com/wiki/?emacsStyleLed for the complete keybinding
reference)

Thus calling 'doc' on function/symbol FOO is just 'C-h f FOO RET', and
thats already hardcoded in every Emacs user's brain I would guess.

-- 
cheers,
Thorsten

-- 
UNSUBSCRIBE: mailto:picolisp@software-lab.de?subject=Unsubscribe

Re: Documentation again

[Thorsten Jolitz]

Christophe Gragnic
 writes:

> Thanks to all participants of this thread.
>
> On Mon, Aug 11, 2014 at 8:57 PM, Thorsten Jolitz
>  wrote:
>>
>> Are you aware of
>>
>> http://www.scribd.com/doc/103732688/PicoLisp-Works
>> https://github.com/tj64/picolisp-works
>>
>> http://www.scribd.com/doc/103733857/PicoLisp-by-Example
>> https://github.com/tj64/picolisp-by-example
>>
>> ?
>
> Aware, yes, but maybe right between consciousness and unconsciousness.
> Thanks for this reminder.

Since picolisp-by-example has the complete PicoLisp function reference
(from 2012 or so) and scribd has a pretty good document search function,
it might serve as a "single file online reference" already - you get
additional hits from the rosetta code tasks, but thats useful
sometimes. 

-- 
cheers,
Thorsten

-- 
UNSUBSCRIBE: mailto:picolisp@software-lab.de?subject=Unsubscribe

Re: Documentation again

[Alexander Burger]

Hi Christophe,

> Let me explain my goal: I just want to have access at the reference as fast as
> possible. I realised that I quite always:
> 1) type «so» in the URL field of my browser,
> 2) then a familiar URL beginning with «http://software-lab.de/doc/ref» 
> appears,
> 3) I edit this URL with the initial X and the function xxx to have
> refX.html#xxx,
> 4) ENTER key,
> 5) profit.
> A process that could have less steps.
> I thought having one big page would be convenient, for use with the search
> function of my browser.

I think you'll know the function

   http://software-lab.de/doc/refD.html#doc


I mostly use it directly from a shell window, with a script 'doc' in my
executable path

   #!/usr/bin/pil @lib/debug.l
   (raw T)
   (doc (opt) (opt))
   (bye)

It is called as

   $ doc mapcar

and directly opens the right browser window. I have 'w3m' as my default
browser, so this is blindingly fast, but any other browser works just as
well. If e.g. Firefox is already open, it connects to it and just opens
a new tab.

♪♫ Alex
-- 
UNSUBSCRIBE: mailto:picolisp@software-lab.de?subject=Unsubscribe

Re: Documentation again

[andreas]

> Thorsten Jolitz 
> writes:
>
> Another very valuable contribution would be to create a third book
>
> ,
> | "The PicoLisp Mail Archive"
> `
>
> with all substantial posts/threads to the PicoLisp mailing list. Alex
> has a complete archive of these posts that has a pretty consistent
> format and thus could easily be converted to LaTeX with a script. But in
> the end human intelligence (and time and effort) is needed to filter out
> those posts/threads that are worth publishing (there are lots of them),
> remove text duplication etc. The book could be created using "PicoLisp
> by Example" as a LaTeX template.
>
> I'm sure Alex and the community would appreciate contributions (I
> would).

Indeed, he mail archive is full of useful information.
I usually use the online version at gmane:

http://dir.gmane.org/gmane.lisp.picolisp.general

There you can search the mailing archive quite comfortable.
Together with the official reference, the books and Henriks Blog it
answers most common questions for me.

Some more explaining documentation would surely be meaningful. I plan to
create some tutorials and the like from my experiences learning picolisp.
But this is not something coming soon, more like 'maybe next year'...






-- 
UNSUBSCRIBE: mailto:picolisp@software-lab.de?subject=Unsubscribe

Re: Documentation again

[Henrik Sarvell]

Alabhya you might want to check out this:
http://www.prodevtips.com/2013/10/18/emacs-as-a-multi-mode-web-dev-ide-is-now-possible/

The Projectile and Ido combination is great for finding files, directories
and grepping your files.


On Wed, Aug 13, 2014 at 7:55 PM, Alabhya Singh  wrote:

> Hi Jolitz
>
> Nice to see Emacs expert enthusiasm here!
>
> Will definitely give a try to helm. Thanks.
>
> Sure! Please send the files as
> PM attachment at alab...@yahoo.com
>
> Will send then back in Orgmode format.
>
> Alabhya
>
>  --
> * From: * Thorsten Jolitz ;
> * To: * ;
> * Subject: * Re: Documentation again
> * Sent: * Tue, Aug 12, 2014 1:22:08 PM
>
>   Alabhya Singh  writes:
>
> >  Thanks a lot! Thorsten Jolitz for detailed informative help.
>
> As an Org-mode fan I would really like to have these docs in Org-mode,
> would make everything easier, but then you need to prepare the export to
> LaTeX such that the outcome looks as professional as the Springer
> LaTeX templates I used for the books. Its possible, but likely not easy
> and time consuming.
>
> I do have both books as .txt files (as the only two files in a directory)
> on my
> machine, for searching them in parrallel with
>
> ,[ C-h f helm-do-grep RET ]
> | helm-do-grep is an interactive autoloaded Lisp function in
> | `helm-grep.el'.
> |
> | It is bound to C-x c M-g s, .
> |
> | (helm-do-grep)
> |
> | Preconfigured helm for grep.
> | Contrarily to Emacs `grep', no default directory is given, but
> | the full path of candidates in ONLY.
> | That allow to grep different files not only in `default-directory' but
> anywhere
> | by marking them (C-). If one or more directory is selected
> | grep will search in all files of these directories.
> | You can also use wildcard in the base name of candidate.
> | If a prefix arg is given use the -r option of grep (recurse).
> | The prefix arg can be passed before or after start file selection.
> | See also `helm-do-grep-1'.
> `
>
> Its very convenient to be able to simply copy found code/text from an
> Emacs buffer then. Don't remember how I converted the docs, but I could
> send them as PM attachment if you send me a private email address.
>
> > --
> > From: Thorsten Jolitz
> > ;
> > To: ;
> > Subject: Re: Documentation again
> > Sent: Tue, Aug 12, 2014 9:33:36 AM
> >
> >
> >  Alabhya Singh 
> >  writes:
> >
> >  > I support Henrik and even would request the docs to be available in
> >  > "universal" and simple formats:
> >  > 1. Text
> >
> >  The .tex sources are just text files, with LaTeX markup though. But
> >  there are tools like
> >
> >  ,
> >  | pandoc
> >  | latex2html
> >  | latex2rtf
> >  | tex2man
> >  | [...]
> >  `
> >
> >  to convert them.
> >
> >  > 2. Orgmode
> >
> >  pandoc does latex->org
> >
> >  > 3. HTML
> >
> >  try
> >  latex2html
> >  or pandoc again? latex to html should be pretty advanced there
> >  or export to org, improve the org file (easy) and the export to html
> >
> >  These converters are all less than perfect, but they might give you
> >  valid docs in other formats, that can then be improved with a really
> >  good editor like Emacs or Vim (or with a PicoLisp program of course).
> >
> >  >
> >  -
> >  -
> >  > From: Henrik Sarvell
> >  > ;
> >  > To: ;
> >  > Subject: Re: Documentation again
> >  > Sent: Tue, Aug 12, 2014 5:16:39 AM
> >  >
> >  >
> >  > I noted that it's not possible to download PDFs at all from Scribd
> >  > anymore without paying $9. What about making them downloadable from
> >  > picolisp.com?
> >  >
> >  > On Tue, Aug 12, 2014 at 1:57 AM, Thorsten Jolitz
> >  >  wrote:
> >  > > Christophe Gragnic
> >  > > 
> >  > writes:
> >  > >
> >  > >> Le 7 août 2014 14:11, "Jon Kleiser"
> >  > >>  a écrit :
> >  > >>>
> >  > >>> I use the frame-based solution for doc lookup (index.html by
> >  > me),
> >  > >> here <http://www.software-lab.de/doc/>,
> >  > >>
> >  > >> I realised only a few months ago that these pages were Jon's
> >  work
> >  > (or
> 

Re: Documentation again

[Alabhya Singh]

Hi Jolitz 

Nice to see Emacs expert enthusiasm here!

Will definitely give a try to helm. Thanks.

Sure! Please send the files as 
PM attachment at alab...@yahoo.com

Will send then back in Orgmode format.

Alabhya

Organize TPMA: "The PicoLisp Mail Archive" :: Re: Documentation again

[Alabhya Singh]

1. Orgmode format can be the base format for documentation sources.
Even vim has support for .org files.

2. Faced with slow internet, difficulty to get pandoc installed on Porteus 
Linux.
I have converted the two books on picoLisp, by hand to .org (opened in pdf 
viewer, select all, copy, paste into emacs Org buffer and then editing).

3. Mail archive book will be even more labor intensive if the repeated portions 
are not cleaned through a script beforehand.

But I am not so expert to write such script.

Re: Documentation again

[Alabhya Singh]

Hi Jolitz,

Without any expertise in picoLisp I doubt if I can at present do any justice to 
my willingness to see better documentation.

Alabhya

Re: Documentation again

[Thorsten Jolitz]

Thorsten Jolitz 
writes:

> Alabhya Singh  writes:
>
>>  Thanks a lot! Thorsten Jolitz for detailed informative help. 
>
> As an Org-mode fan I would really like to have these docs in Org-mode,
> would make everything easier, but then you need to prepare the export to
> LaTeX such that the outcome looks as professional as the Springer
> LaTeX templates I used for the books. Its possible, but likely not easy
> and time consuming. 

BTW, while it would be definitely useful to convert these docs to more
formats, it would be even more useful (and probably much easier) to
update them to include all new docs from the wiki and other sources
since their release.

They do already exist as PDF (github), can be browsed on the web
(scribd) and can easily be converted to .txt with GNU/Linux tools, thats
something. Org-mode would be great, but optional I would say.

If you want to help improving the PicoLisp documentation with updating
the books, let me know, I can give you some scripts and pointers that
could be useful.

Another very valuable contribution would be to create a third book 

,
| "The PicoLisp Mail Archive"
`

with all substantial posts/threads to the PicoLisp mailing list. Alex
has a complete archive of these posts that has a pretty consistent
format and thus could easily be converted to LaTeX with a script. But in
the end human intelligence (and time and effort) is needed to filter out
those posts/threads that are worth publishing (there are lots of them),
remove text duplication etc. The book could be created using "PicoLisp
by Example" as a LaTeX template.

I'm sure Alex and the community would appreciate contributions (I
would).  

-- 
cheers,
Thorsten

-- 
UNSUBSCRIBE: mailto:picolisp@software-lab.de?subject=Unsubscribe

Re: Documentation again

[Tomas Hlavaty]

Hi Thorsten,

>> or to http://ondoc.logand.com which is itself written in PicoLisp:-)
>
> Cool!
>
> But with 
>
> https://github.com/tj64/picolisp-works/blob/master/editor.pdf?raw=true
>
> I get an error:
>
> ,
> | Location: http://ondoc.logand.com/d/4741/1/  
> | Reading PDF failed
> `

ah, ondoc can read up to pdf-1.4.  It's likely you are creating a newer
version.

Cheers,

Tomas
-- 
UNSUBSCRIBE: mailto:picolisp@software-lab.de?subject=Unsubscribe

Re: Documentation again

[Thorsten Jolitz]

Alabhya Singh  writes:

>  Thanks a lot! Thorsten Jolitz for detailed informative help. 

As an Org-mode fan I would really like to have these docs in Org-mode,
would make everything easier, but then you need to prepare the export to
LaTeX such that the outcome looks as professional as the Springer
LaTeX templates I used for the books. Its possible, but likely not easy
and time consuming. 

I do have both books as .txt files (as the only two files in a directory) on my
machine, for searching them in parrallel with

,[ C-h f helm-do-grep RET ]
| helm-do-grep is an interactive autoloaded Lisp function in
| `helm-grep.el'.
| 
| It is bound to C-x c M-g s, .
| 
| (helm-do-grep)
| 
| Preconfigured helm for grep.
| Contrarily to Emacs `grep', no default directory is given, but
| the full path of candidates in ONLY.
| That allow to grep different files not only in `default-directory' but 
anywhere
| by marking them (C-). If one or more directory is selected
| grep will search in all files of these directories.
| You can also use wildcard in the base name of candidate.
| If a prefix arg is given use the -r option of grep (recurse).
| The prefix arg can be passed before or after start file selection.
| See also `helm-do-grep-1'.
`

Its very convenient to be able to simply copy found code/text from an
Emacs buffer then. Don't remember how I converted the docs, but I could
send them as PM attachment if you send me a private email address.

> --
> From: Thorsten Jolitz
> ; 
> To: ; 
> Subject: Re: Documentation again 
> Sent: Tue, Aug 12, 2014 9:33:36 AM 
>
>
>  Alabhya Singh
>  writes:   
>
>  > I support Henrik and even would request the docs to be available in  
>  > "universal" and simple formats: 
>  > 1. Text 
>
>  The .tex sources are just text files, with LaTeX markup though. But   
>  there are tools like  
>
>  , 
>  | pandoc  
>  | latex2html  
>  | latex2rtf   
>  | tex2man 
>  | [...]   
>  ` 
>
>  to convert them.  
>
>  > 2. Orgmode  
>
>  pandoc does latex->org
>
>  > 3. HTML 
>
>  try   
>  latex2html
>  or pandoc again? latex to html should be pretty advanced there.   
>  or export to org, improve the org file (easy) and the export to html  
>
>  These converters are all less than perfect, but they might give you   
>  valid docs in other formats, that can then be improved with a really  
>  good editor like Emacs or Vim (or with a PicoLisp program of course). 
>
>  > 
>  - 
>  -     
>  > From: Henrik Sarvell
>  > ; 
>  > To: ; 
>  > Subject: Re: Documentation again
>  > Sent: Tue, Aug 12, 2014 5:16:39 AM  
>  &

Re: Documentation again

[Alabhya Singh]

Thanks a lot! Thorsten Jolitz for detailed informative help.

Alabhya

Re: Documentation again

[Thorsten Jolitz]

Tomas Hlavaty  writes:

Hi Tomas,

> or to http://ondoc.logand.com which is itself written in PicoLisp:-)

Cool!

But with 

https://github.com/tj64/picolisp-works/blob/master/editor.pdf?raw=true

I get an error:

,
| Location: http://ondoc.logand.com/d/4741/1/  
| Reading PDF failed
`

-- 
cheers,
Thorsten

-- 
UNSUBSCRIBE: mailto:picolisp@software-lab.de?subject=Unsubscribe

Re: Documentation again

[Thorsten Jolitz]

Alabhya Singh  writes:
   
>  I support Henrik and even would request the docs to be available in  
>  "universal" and simple formats:  
>  1. Text

The .tex sources are just text files, with LaTeX markup though. But
there are tools like 

,
| pandoc
| latex2html
| latex2rtf
| tex2man
| [...]
`

to convert them.
  
>  2. Orgmode   

 pandoc does latex->org

>  3. HTML  

try 
latex2html 
or pandoc again? latex to html should be pretty advanced there.
or export to org, improve the org file (easy) and the export to html

These converters are all less than perfect, but they might give you
valid docs in other formats, that can then be improved with a really
good editor like Emacs or Vim (or with a PicoLisp program of course).

> --
> From: Henrik Sarvell
> ; 
> To: ; 
> Subject: Re: Documentation again 
> Sent: Tue, Aug 12, 2014 5:16:39 AM 
>
>   
>  I noted that it's not possible to download PDFs at all from Scribd   
>  anymore without paying $9. What about making them downloadable from  
>  picolisp.com?
>   
>  On Tue, Aug 12, 2014 at 1:57 AM, Thorsten Jolitz 
>   wrote: 
>  > Christophe Gragnic 
>  > 
>  writes:  
>  >
>  >> Le 7 août 2014 14:11, "Jon Kleiser"   
>  >>  a écrit :  
>  >>>  
>  >>> I use the frame-based solution for doc lookup (index.html by 
>  me), 
>  >> here <http://www.software-lab.de/doc/>,   
>  >>   
>  >> I realised only a few months ago that these pages were Jon's work 
>  (or  
>  >> in part?). Thanks for this. I'd be curious to have an historical  
>  point
>  >> of view concerning the doc.   
>  >>   
>  >> Now a question then a suggestion. 
>  >>   
>  >> Is there a good reason to have separate pages? I understand that  
>  only 
>  >> one page would be huge but I'd find it more convenient.   
>  >>   
>  >> Would it be interesting to have the ref in a format like Markdown 
>  and  
>  >> generate a single or several pages, in html or pdf?   
>  >> BTW I just noticed in the doc for (usec) that there was a typo
>  and  
>  >> that I don't find it very clear:  
>  >> http://software-lab.de/doc/refU.html#usec 
>  >
>  > Are you aware of   
>  >
>  > http://www.scribd.com/doc/103732688/PicoLisp-Works 
>  > https://github.com/tj64/picolisp-works 
>  >
>  > http://www.scribd.com/doc/103733857/PicoLisp-by-Example
>  > https://github.com/tj64/picolisp-by-example
>  >
>  > ?  
>  >

Re: Documentation again

[Thorsten Jolitz]

Henrik Sarvell 
writes:

Hi Henrik,

> I noted that it's not possible to download PDFs at all from Scribd
> anymore without paying $9. 

Yes, as always they just '(ab)use' the people to make money out of other
peoples time and effort  ;(

But I thought if you open a (free) account you can still download the
pdf? OTOH, for a while the docs were really unusable on scribd because
they "improved" their UI, but now it seems much better again and pretty
fast. 

But anyway - the pdfs are on Github too (!), and the two PDF download
links on this page (http://picolisp.com/wiki/?Documentation) point to
the (raw) PDF files on Github, not on Scribd. So anyone should be able
to still download the pdfs for free. Or even better, just fork/clone the
git repos and you have the sources and the pdfs. 

> What about making them downloadable from picolisp.com?

They are, see above.

> On Tue, Aug 12, 2014 at 1:57 AM, Thorsten Jolitz
>  wrote:
>> Christophe Gragnic
>>  writes:
>>
>>> Le 7 août 2014 14:11, "Jon Kleiser"
>>>  a écrit :

 I use the frame-based solution for doc lookup (index.html by me),
>>> here ,
>>>
>>> I realised only a few months ago that these pages were Jon's work (or
>>> in part?). Thanks for this. I'd be curious to have an historical point
>>> of view concerning the doc.
>>>
>>> Now a question then a suggestion.
>>>
>>> Is there a good reason to have separate pages? I understand that only
>>> one page would be huge but I'd find it more convenient.
>>>
>>> Would it be interesting to have the ref in a format like Markdown and
>>> generate a single or several pages, in html or pdf?
>>> BTW I just noticed in the doc for (usec) that there was a typo and
>>> that I don't find it very clear:
>>> http://software-lab.de/doc/refU.html#usec
>>
>> Are you aware of
>>
>> http://www.scribd.com/doc/103732688/PicoLisp-Works
>> https://github.com/tj64/picolisp-works
>>
>> http://www.scribd.com/doc/103733857/PicoLisp-by-Example
>> https://github.com/tj64/picolisp-by-example
>>
>> ?
>>
>> --
>> cheers,
>> Thorsten
>>
>> --
>> UNSUBSCRIBE:
>> mailto:picolisp@software-lab.de?subject=Unsubscribe

-- 
cheers,
Thorsten

-- 
UNSUBSCRIBE: mailto:picolisp@software-lab.de?subject=Unsubscribe

Re: Documentation again

[Alexander Burger]

Hi Christophe,

> BTW I just noticed in the doc for (usec) that there was a typo and that I
> don't find it very clear:
> http://software-lab.de/doc/refU.html#usec

Yes, indeed, this was a bit nonsense. Fixed it.
♪♫ Alex
-- 
UNSUBSCRIBE: mailto:picolisp@software-lab.de?subject=Unsubscribe

Re: Documentation again

[Jon Kleiser]

Hi,

On 11. Aug, 2014, at 20:13, Christophe Gragnic  
wrote:

> 
> Le 7 août 2014 14:11, "Jon Kleiser"  a écrit :
> >
> > I use the frame-based solution for doc lookup (index.html by me), here 
> > ,
> 
> I realised only a few months ago that these pages were Jon's work (or in 
> part?). Thanks for this. I'd be curious to have an historical point of view 
> concerning the doc.

It’s mainly the tiny index.html file that is my work (and after the recent 
DOCTYPE fix I’ve had no JavaScript errors here).

> Now a question then a suggestion.
> 
> Is there a good reason to have separate pages? I understand that only one 
> page would be huge but I'd find it more convenient.

In the old days (2007?) it was one big html page. I guess the convenience 
depends on how you use it.

/Jon

> 
> Would it be interesting to have the ref in a format like Markdown and 
> generate a single or several pages, in html or pdf?
> 
> BTW I just noticed in the doc for (usec) that there was a typo and that I 
> don't find it very clear:
> http://software-lab.de/doc/refU.html#usec
> 
> chri
> 

--
UNSUBSCRIBE: mailto:picolisp@software-lab.de?subject=Unsubscribe

Re: Documentation again

[Tomas Hlavaty]

Henrik Sarvell  writes:
> I noted that it's not possible to download PDFs at all from Scribd
> anymore without paying $9. What about making them downloadable from
> picolisp.com?
>
> On Tue, Aug 12, 2014 at 1:57 AM, Thorsten Jolitz  wrote:
>> Are you aware of
>>
>> http://www.scribd.com/doc/103732688/PicoLisp-Works
>> https://github.com/tj64/picolisp-works
>>
>> http://www.scribd.com/doc/103733857/PicoLisp-by-Example
>> https://github.com/tj64/picolisp-by-example

or to http://ondoc.logand.com which is itself written in PicoLisp:-)

Cheers,

Tomas
-- 
UNSUBSCRIBE: mailto:picolisp@software-lab.de?subject=Unsubscribe

Re: Documentation again

[Henrik Sarvell]

Hi Alabahya, they mostly are available in HTML on picolisp.com itself or
linked to from picolisp.com.

My thinking is more for offline viewing.


On Tue, Aug 12, 2014 at 1:02 PM, Alabhya Singh  wrote:

> I support Henrik and even would request the docs to be available in
> "universal" and simple formats:
> 1. Text
> 2. Orgmode
> 3. HTML
>
>  --
> * From: * Henrik Sarvell ;
> * To: * ;
> * Subject: * Re: Documentation again
> * Sent: * Tue, Aug 12, 2014 5:16:39 AM
>
>   I noted that it's not possible to download PDFs at all from Scribd
> anymore without paying $9. What about making them downloadable from
> picolisp.com?
>
> On Tue, Aug 12, 2014 at 1:57 AM, Thorsten Jolitz 
> wrote:
> > Christophe Gragnic
> >  writes:
> >
> >> Le 7 août 2014 14:11, "Jon Kleiser"
> >>  a écrit :
> >>>
> >>> I use the frame-based solution for doc lookup (index.html by me),
> >> here <http://www.software-lab.de/doc/>,
> >>
> >> I realised only a few months ago that these pages were Jon's work (or
> >> in part?). Thanks for this. I'd be curious to have an historical point
> >> of view concerning the doc.
> >>
> >> Now a question then a suggestion.
> >>
> >> Is there a good reason to have separate pages? I understand that only
> >> one page would be huge but I'd find it more convenient.
> >>
> >> Would it be interesting to have the ref in a format like Markdown and
> >> generate a single or several pages, in html or pdf?
> >> BTW I just noticed in the doc for (usec) that there was a typo and
> >> that I don't find it very clear:
> >> http://software-lab.de/doc/refU.html#usec
> >
> > Are you aware of
> >
> > http://www.scribd.com/doc/103732688/PicoLisp-Works
> > https://github.com/tj64/picolisp-works
> >
> > http://www.scribd.com/doc/103733857/PicoLisp-by-Example
> > https://github.com/tj64/picolisp-by-example
> >
> > ?
> >
> > --
> > cheers,
> > Thorsten
> >
> > --
> > UNSUBSCRIBE: mailto:picolisp@software-lab.de?subject=Unsubscribe
>
> --
> UNSUBSCRIBE: mailto:picolisp@software-labde?subject=Unsubscribe
>

Re: Documentation again

[Alabhya Singh]

I support Henrik and even would request the docs to be available in "universal" 
and simple formats:
1. Text
2. Orgmode
3. HTML 

Re: Documentation again

[Henrik Sarvell]

I noted that it's not possible to download PDFs at all from Scribd
anymore without paying $9. What about making them downloadable from
picolisp.com?

On Tue, Aug 12, 2014 at 1:57 AM, Thorsten Jolitz  wrote:
> Christophe Gragnic
>  writes:
>
>> Le 7 août 2014 14:11, "Jon Kleiser"
>>  a écrit :
>>>
>>> I use the frame-based solution for doc lookup (index.html by me),
>> here ,
>>
>> I realised only a few months ago that these pages were Jon's work (or
>> in part?). Thanks for this. I'd be curious to have an historical point
>> of view concerning the doc.
>>
>> Now a question then a suggestion.
>>
>> Is there a good reason to have separate pages? I understand that only
>> one page would be huge but I'd find it more convenient.
>>
>> Would it be interesting to have the ref in a format like Markdown and
>> generate a single or several pages, in html or pdf?
>> BTW I just noticed in the doc for (usec) that there was a typo and
>> that I don't find it very clear:
>> http://software-lab.de/doc/refU.html#usec
>
> Are you aware of
>
> http://www.scribd.com/doc/103732688/PicoLisp-Works
> https://github.com/tj64/picolisp-works
>
> http://www.scribd.com/doc/103733857/PicoLisp-by-Example
> https://github.com/tj64/picolisp-by-example
>
> ?
>
> --
> cheers,
> Thorsten
>
> --
> UNSUBSCRIBE: mailto:picolisp@software-lab.de?subject=Unsubscribe
--
UNSUBSCRIBE: mailto:picolisp@software-lab.de?subject=Unsubscribe

Re: Documentation again

[Thorsten Jolitz]

Christophe Gragnic
 writes:

> Le 7 août 2014 14:11, "Jon Kleiser"
>  a écrit :
>>
>> I use the frame-based solution for doc lookup (index.html by me),
> here ,
>
> I realised only a few months ago that these pages were Jon's work (or
> in part?). Thanks for this. I'd be curious to have an historical point
> of view concerning the doc.
>
> Now a question then a suggestion.
>
> Is there a good reason to have separate pages? I understand that only
> one page would be huge but I'd find it more convenient.
>
> Would it be interesting to have the ref in a format like Markdown and
> generate a single or several pages, in html or pdf?
> BTW I just noticed in the doc for (usec) that there was a typo and
> that I don't find it very clear:
> http://software-lab.de/doc/refU.html#usec

Are you aware of 

http://www.scribd.com/doc/103732688/PicoLisp-Works
https://github.com/tj64/picolisp-works

http://www.scribd.com/doc/103733857/PicoLisp-by-Example
https://github.com/tj64/picolisp-by-example

?

-- 
cheers,
Thorsten

-- 
UNSUBSCRIBE: mailto:picolisp@software-lab.de?subject=Unsubscribe

Documentation again

[Christophe Gragnic]

Le 7 août 2014 14:11, "Jon Kleiser"  a écrit :
>
> I use the frame-based solution for doc lookup (index.html by me), here <
http://www.software-lab.de/doc/>,

I realised only a few months ago that these pages were Jon's work (or in
part?). Thanks for this. I'd be curious to have an historical point of view
concerning the doc.

Now a question then a suggestion.

Is there a good reason to have separate pages? I understand that only one
page would be huge but I'd find it more convenient.

Would it be interesting to have the ref in a format like Markdown and
generate a single or several pages, in html or pdf?

BTW I just noticed in the doc for (usec) that there was a typo and that I
don't find it very clear:
http://software-lab.de/doc/refU.html#usec

chri