Re: extending the documentation of the Scheme API

2019-12-30 Thread Ludovic Courtès
Hi! Jan Nieuwenhuizen skribis: >> we have lots of nice macros and procedures in Guix that aren’t >> documented beyond their docstrings. >> >> Should we snarf the docstrings and add them to the manual? > > If you are talking about guix records and (guix build utils); I think it > would be great i

Re: extending the documentation of the Scheme API

2019-12-29 Thread Jan Nieuwenhuizen
Ricardo Wurmus writes: Hello Ricardo > we have lots of nice macros and procedures in Guix that aren’t > documented beyond their docstrings. > > Should we snarf the docstrings and add them to the manual? If you are talking about guix records and (guix build utils); I think it would be great if th

Re: extending the documentation of the Scheme API

2019-12-23 Thread Bengt Richter
Hi Ricardo, Guix On +2019-12-20 23:17:41 +0100, Ricardo Wurmus wrote: > Hi Guix, > > we have lots of nice macros and procedures in Guix that aren’t > documented beyond their docstrings. > > Should we snarf the docstrings and add them to the manual? > > -- > Ricardo > > My 2 cents, if I may:

Re: extending the documentation of the Scheme API

2019-12-21 Thread Pjotr Prins
On Fri, Dec 20, 2019 at 09:04:16PM -0700, Jesse Gibbons wrote: > On Fri, 2019-12-20 at 23:17 +0100, Ricardo Wurmus wrote: > > Hi Guix, > > > > we have lots of nice macros and procedures in Guix that aren’t > > documented beyond their docstrings. > > > > Should we snarf the docstrings and add them

Re: extending the documentation of the Scheme API

2019-12-20 Thread Jesse Gibbons
On Fri, 2019-12-20 at 23:17 +0100, Ricardo Wurmus wrote: > Hi Guix, > > we have lots of nice macros and procedures in Guix that aren’t > documented beyond their docstrings. > > Should we snarf the docstrings and add them to the manual? > > -- > Ricardo > > I don't care where it goes, but is th

Re: extending the documentation of the Scheme API

2019-12-20 Thread John Soo
Hi Ricardo, Yes! I think that would really emphasize the hackability of Guix. - John

extending the documentation of the Scheme API

2019-12-20 Thread Ricardo Wurmus
Hi Guix, we have lots of nice macros and procedures in Guix that aren’t documented beyond their docstrings. Should we snarf the docstrings and add them to the manual? -- Ricardo