Is there a way to automatically generate Scribble documentation from code + comments? I did some searching a couple times, but I was probably looking in the wrong place

There’s “in-source documentation” which allows you to write documentation within your code: https://docs.racket-lang.org/scribble/srcdoc.html

@sorawee Excellent, exactly what I was looking for! Thank you very much, I should have read the Scribble docs better :smile:

Is it Rackets 25th Jubilee this year?

Yes.

I met the Queen of England during her Silver Jubilee. Racket may need a Queen.

Has anyone found the raco pkg install --skip-installed behaviour strange? For example, the package is in the same scope as the one you are trying to install, no complaints. If it’s in a different scope, --skip-installed is ignored and there’s a complain. For example: $ raco pkg install --skip-installed --auto rosette all good there because rosette was installed already in the default scope. What about parser-tools-lib? $ raco pkg install --skip-installed --auto parser-tools-lib Resolving "parser-tools-lib" via <https://pkgs.racket-lang.org> Using cached15882399181588239918582 for <git://github.com/racket/parser-tools/?path=parser-tools-lib> raco pkg install: package is currently installed in a wider scope package: parser-tools-lib installed scope: installation given scope: user Maybe there’s a reason for this though.

I think that could be fixed

@samth I’m not running Racket CS yet, so what is the best way to get Racket CS specific docs - in particular regarding the FFI?

For the regular FFI stuff, it’s all in the same documentation.

see, for example: https://docs.racket-lang.org/foreign/foreign_procedures.html#%28form._%28%28lib._ffi%2Funsafe..rkt%29.__bytes%29%29

@samth ah, ok, so you think this is not intended behaviour.

thanks.

Maybe it’s intended originally, but it could be improved

Really we should just have an “update-or-install” command

or update should offer to install if not installed

For embedding stuff, that is all new in 7.7, so take a look at the pre-release documentation: https://pre-release.racket-lang.org/doc/inside/cs.html

To track this: https://github.com/racket/racket/issues/3136

Maybe we can have discussions on how to improve the interface there.

Awesome. I don’t think I’ll be embedding Racket anytime soon, so the current docs are all I’ll need.

And you can update profile through raco? Without needing to install a new Racket version?

yup

:+1:

they say mathematics is the queen of the sciences.

Maybe Racket is the queen of languages. or LOP?

hangon the silverjubilee was 1977?

haha - how old were you @gknauth ? I ‘met’ prince charles but i was 7 (I was in a line of 7 yo school kids in 1977)

Is there a way to consider STDTOUT output during setup as not error? In quickscript-extra, I want to display a message to the user after installation: raco setup: output: during making for <pkgs>/quickscript-extra STDOUT: Register me as a quickscript directory (on first setup only) with: racket -l quickscript-extra/register ===== raco pkg install: packages installed, although setup reported errors (because I think it’s not possible to trigger this command line automatically at installation/compile time)

Can I use some kind of logger, or is there some other way around?

you should be able to run it automatically on setup

Aren’t programs sandboxed during compilation to avoid write/delete to files?

no

only in background expansion

Oh I see, cool

excellent, that works, thanks @samth

I met HRH QE2 when I was 17 in Oct’77 in Ottawa CAN at the Head of the Rideau Canal Regatta. I was in her honor guard, because I was the captain of my high school crew, which came up from Connecticut. She was walking along between us, who were holding oars upright, then she stopped to talk to me. She was very nice. Then Prince Philip, Pierre Trudeau and John Dieffenbaker did the same. About 20 years later I realized it was probably because I was the only person her height. I was the coxswain of my team. Prince Philip was funny.

In terms of more notorious encounters, my aunt Tine shook Hitler’s hand in 1933 when he was running for Reichskanzler, and she was a 13 year-old American schoolgirl studying in Germany. They paraded all the schoolkids out to meet him. She couldn’t stand him, but she did say he had “the deepest blue eyes” which I guess a schoolgirl would notice and was part of what allowed him to charm people. My father was an American NY Times reporter in Berlin 1938–41 and had many encounters with Hitler and his entourage. I’ve kept all the articles I could gather, it’s an interesting history lesson. My grandfather’s brother after US Army service in WWI after his discharge was sent to Moscow to cover this thing that had just happened called the Russian Revolution, so he had stories about Lenin, Trotsky & Stalin. My only claim to fame is I gave Boris Yeltsin a demonstration of a reclining chair and sleeper sofa in the US pavilion of a trade show in Moscow in 1987, and in 1992 Steve Jobs asked me to give Yeltsin a demonstration of a NeXT computer.

That’s pretty cool.

Is support for currying in typed racket limited? (I noticed that typed racket in general has a lot of trouble with general type signatures and I have to use inst often)

In particular, I changed this

to this

Usually I’m able to parse the type errors thrown, but this one is beyond me http://pasterack.org/pastes/63704

https://github.com/samdphillips/racket-gui-repl-example

I’ve been having trouble building Racket from source on Mac rktio_convert.c:19:11: fatal error: CoreFoundation/CFString.h: No such file or directory 19 \| # include <CoreFoundation/CFString.h> \| ^~~~~~~~~~~~~~~~~~~~~~~~~~~ Searching the web for this error message brought a few different suggestions having to do with XCode command-line tools, which have all failed when I tried them. Does anyone know how to fix problems like this to build Racket on a Mac? Specifically I’m on Mojave version 10.14.6, since it’s probably different for different Mac versions. Anyone seen this before or know what to do?

Have you tried open /Library/Developer/CommandLineTools/Packages/macOS_SDK_headers_for_macOS_10.14.pkg

Yes. It didn’t help

Is this Racket BC or Racket CS?

I built Racket from source a couple of months ago on Mac and it went well…

The default, which I thought was still 3m

Can your clang or gcc find that header file?

I mean, like

➜ cat h.c # include <CoreFoundation/CFString.h> ➜ clang -c h.c

That clang command doesn’t fail, it just returns with no error message

is gcc on your machine an alias to clang

I looked into the makefile in rktio and I didn’t find anything useful. Maybe Matthew knows why this happens

btw, as you suggested clang -c, running clang -c ./racket/src/build/../rktio/rktio_convert.c also does not print any error message

rktio_convert.o: $(srcdir)/rktio_convert.c $(RKTIO_HEADERS) $(CC) $(CFLAGS) $(CPPFLAGS) -I$(srcdir) -I. -o rktio_convert.o -c $(srcdir)/rktio_convert.c

this is the full command for compiling rkto_convert.c

try make rktio_covert.o

see what will happen

Hm, I got make: *** No rule to make target 'rktio_covert.o'. Stop. so that’s weird

The command printed out when I try make by itself is more like $ gcc -Wall -g -O2 -I/usr/local/opt/openblas/include -DOS_X -D_DARWIN_UNLIMITED_SELECT -I/Users/Alex/Documents/GitHub/racket/racket/racket/src/rktio -I. -o rktio_convert.o -c /Users/Alex/Documents/GitHub/racket/racket/racket/src/rktio/rktio_convert.c and errors with /Users/Alex/Documents/GitHub/racket/racket/racket/src/rktio/rktio_convert.c:19:11: fatal error: CoreFoundation/CFString.h: No such file or directory 19 \| # include <CoreFoundation/CFString.h> \| ^~~~~~~~~~~~~~~~~~~~~~~~~~~ compilation terminated.

It’s interesting that C++ also has the problem. https://www.quora.com/Why-dont-C++-arrays-have-an-easy-way-to-check-their-size