Re: [PATCH v2] doc: Document SRFI 64.

2023-11-22 Thread Maxim Cournoyer
Hi Maxime,

Maxime Devos  writes:

> Op 18-11-2023 om 05:42 schreef Maxim Cournoyer:
>>   * SRFI-61:: A more general `cond' clause
>>   * SRFI-62:: S-expression comments.
>> -* SRFI-64:: A Scheme API for test suites.
>> +* SRFI 64:: A Scheme API for test suites.
>>   * SRFI-67:: Compare procedures
>>   * SRFI-69:: Basic hash tables.
>>   * SRFI-71:: Extended let-syntax for multiple values.
>
> That seems rather inconsistent.

It is in Guile (for now), but upstream nobody appears to calls "SRFI 64"
as "SRFI-64", so unless we are constrained to use a hyphen, it seems
more correct to leave it.  If it makes sense, I could send a patch
automating the simple substitution to standardize on no hyphen for all
of our SRFIs nodes / section names.

>> +@c This SRFI 64 documentation was "snarfed" from upstream specification
>> +@c HTML document using the 'snarfi' script.
>
> That HTML document comes with a license that requires:
>
>> The above copyright notice and this permission notice shall be
>> included in all copies or substantial portions of the Software.

> yet I'm not seeing those notices in the texi.

I've added a copyright notice to srfi-modules.texi and the Expat license
text to @copying in guile.texi, see v3.

Thanks for taking a look!

-- 
Maxim



Re: [PATCH v2] doc: Document SRFI 64.

2023-11-22 Thread Maxime Devos

+@c This SRFI 64 documentation was "snarfed" from upstream specification
+@c HTML document using the 'snarfi' script.


That HTML document comes with a license that requires:

 > The above copyright notice and this permission notice shall be
 > included in all copies or substantial portions of the Software.

yet I'm not seeing those notices in the texi.


(I assume 'snarfing' is a form of copying here.)


OpenPGP_0x49E3EE22191725EE.asc
Description: OpenPGP public key


OpenPGP_signature
Description: OpenPGP digital signature


Re: [PATCH v2] doc: Document SRFI 64.

2023-11-21 Thread Maxime Devos



Op 18-11-2023 om 05:42 schreef Maxim Cournoyer:

  * SRFI-61:: A more general `cond' clause
  * SRFI-62:: S-expression comments.
-* SRFI-64:: A Scheme API for test suites.
+* SRFI 64:: A Scheme API for test suites.
  * SRFI-67:: Compare procedures
  * SRFI-69:: Basic hash tables.
  * SRFI-71:: Extended let-syntax for multiple values.


That seems rather inconsistent.



+@c This SRFI 64 documentation was "snarfed" from upstream specification
+@c HTML document using the 'snarfi' script.


That HTML document comes with a license that requires:

> The above copyright notice and this permission notice shall be
> included in all copies or substantial portions of the Software.

yet I'm not seeing those notices in the texi.

Haven't looked at the actual documentation.

Best regards,
Maxime Devos.


OpenPGP_0x49E3EE22191725EE.asc
Description: OpenPGP public key


OpenPGP_signature
Description: OpenPGP digital signature


Re: [PATCH v2] doc: Document SRFI 64.

2023-11-18 Thread Filip Ɓajszczak

On 11/18/23 04:42, Maxim Cournoyer wrote:


+
+There are other testing frameworks written in Scheme, including
+@url{http://schematics.sourceforge.net/schemeunit.html, SchemeUnit}.
+However SchemeUnit is not portable.  It is also a bit on the verbose
+side.  It would be useful to have a bridge between this framework and
+SchemeUnit so SchemeUnit tests could run under this framework and vice
+versa.  There exists also at least one Scheme wrapper providing a Scheme


http://schematics.sourceforge.net/schemeunit.html is a dead link and 
AFAIK PLT SchemeUnit 
https://planet.racket-lang.org/package-source/schematics/schemeunit.plt/3/0/planet-docs/schemeunit/index.html 
is now RackUnit https://docs.racket-lang.org/rackunit/


All the best,
Filip


OpenPGP_0x5B9D16DC27046620.asc
Description: OpenPGP public key


OpenPGP_signature.asc
Description: OpenPGP digital signature