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 ,
> >  > >>
> >  > >> 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
> >  > >
> >  

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