Lmst

For documenting #swad's new #configuration #reload feature, I finally decided to go with a (at least according to #mdoc "non-standard") #SIGNALS section in the #manpage. I think it's the most useful way for this. What do you think? 🤔

Rendered swad(8) manpage, showing mainly the SIGNALS section with a long description of what exactly SIGHUP does, and where to be careful when using it.

Do "Digital Credentials API", "OID4VP", "mdoc", and "SD-JWT-VC" mean anything to you? If so, I've got a new open source project that might interest you 👀

npm install @simpledigicreds/server
deno add jsr:@simpledigicreds/server

Features include:

Unencrypted requests
Unencrypted responses
Encrypted responses (following OID4VC HAIP)
Stateless presentation verification

A docs site is Coming Soon™, so for now check out the README for a Getting Started guide:

Feedback welcome at https://github.com/MasterKale/SimpleDigiCreds 😀

#digitalcredentials #oid4vp #mdoc #sdjwtvc

Yes, it’s happening.

#mdoc #scdoc #manpage #lorri

An editor with two panes, on the left a file `lorri.1` written in the mdoc manpage format, on the right an unfinished `lorri.scd` written in the scdoc manpage format

Alright, I've got mdoc verification over OID4VP figured out. Time to dig into SD-JWT 📚

#digitalcredentials #mdoc #oid4vp #sdjwt

🆕 #pandoc 3.6 has been released:
• Support for #mdoc as input format
• Improved parsing of #reStructuredText
• #Typst 0.12 support
• Safe handling of `--embed-resources` when combined with `--sandbox`

The default templates for LaTeX, ConTeXt, and Typst have been updated.

https://github.com/jgm/pandoc/releases/tag/3.6

Whoops I gave some money to ISO

#mdl #mdoc #verifiablecredentials

A picture of a white Kobo ereader sitting on top of a dark green comforter. The cover page of ISO/IEC 18013-5 (mobile driving license [mDL] application) is clearly visible on the ereader.

📰 O Correio do Minho traz-nos notícias do #MDOC - Festival Internacional de Documentário de Melgaço, que terá a presença do IHC:

o documentário “Fogo no Lodo”, de Catarina Laranjeiro e Daniel Barroca, vai estar a concurso; e José Filipe Costa vai dar uma masterclass sobre o cinema como lugar de disputa de memória e as potencialidades visuais e sonoras.

https://correiodominho.pt/noticias/estreias-nacionais-nos-filmes-a-concurso-no-festival-internacional-de-documentario-de-melgaco/153686

#Histodons #HistoryOnTheMovies #DocumentaryFilms #FilmFestivals #HistoricalMemory #Documentários #FestivaisDeCinema

In a move that only underscores the fact that all prisons in the US are sites of domestic anti-Black and anti-indigenous war, the president of the Michigan Corrections Organization (the union that represents COs) Byron Osborn has asked for Gov #Whitmer to deploy the Michigan National Guard to "correct" the understaffing "crisis" across the #MDOC

the NG was deployed to the MDOC to administer vaccines to prisoners in 2021, but its history as a racist, settler colonial militia deployed to put down uprisings across the US indicates that Osborn is asking for a heightening of the already-brutal war against Black, brown, and indigenous people held captive by the state of Michigan. Osborn cites mass resignations, lack of hiring incentive (pension plans and salary boosts), and "gang problems" as reasons for MDOC understaffing. WE CALL BULLSHIT.

Guards are the source of contraband, guards torture, harass, sexually assault, and in some cases kill prisoners across the MDOC. Maybe people don't want to become guards because they see how the job strips you of your humanity! We have no choice but to see this ask, by a union president, as an act of war against our loved ones behind bars.

https://www.freep.com/story/news/local/michigan/2024/07/03/michigan-prison-staffing-national-guard-whitmer/74292623007/

@ollien In a couple of days

https://man.freebsd.org/cgi/man.cgi?query=sync&manpath=FreeBSD+15.0-CURRENT

should contain the changes but for now I published the HTML render of the manual page here:

https://people.freebsd.org/~0mp/sync.html

(It was generated with `mandoc -T html bin/sync/sync.8 > /tmp/sync.html`)

#documentation #freebsd #sync #foss #opensource #mandoc #mdoc

@wwwgem nroff user, mostly, not GNU gnroff.

I prefer nroff with -mdoc when the primary end result does not need pictures or where plaintext availability has high value (e.g. manpages, but also other systems documentation). This is very nice to write, much nicer than Tₑχ/LᴬTᴇΧ or -man, and semantic markup.

Then GNU groff can be used to provide an additional PDF which is at least somewhat legible, and I do my own HTML conversation from the plaintext output, but mdocml (now called mandoc) can be used to create somewhat good HTML if you stick to -mdoc commands instead of using nroff primitives. (Which I tend to not do.)

I very much dislike how the GNU g{,n}roff macropackages have changed with the last release. The MirBSD nroff macropackages, specifically -mdoc, work well with GNU g{,n}roff and mostly avoid the pain. (Writing \- and a font hack were still needed.)

nroff with -man is just ugly and awful, stay away from it.

nroff with -ms (+), -me (ref), etc. is also possible, but I found -mdoc more modern and therefore less buggy.

I haven’t yet used neqn (doc, guide) or pic and only a little tbl (doc) (mostly, the native -mdoc tables suffice); AT&T nroff does not have a working pic and it doesn’t transfer to plaintext output well anyway.

I use Tₑχ/LᴬTᴇΧ when the end result primarily must be a PDF with pretty pictures (such as the installation manual of a software at $dayjob we handed to paying customers) or for more programmability. Though copy/paste from those PDFs is so bonkers I patched lstlisting to also dump the listings to a .lst file we provide along, so the admin can copy/paste the commands, examples and config files from there.

(I’ve never used $…$ math mode. I’m not in academics ☻)

I’ve pimped both (have my own Tₑχ/LᴬTᴇΧ styles/class and packages, and tweaked my groff fonts (example) and bugfixed the raw roff that implements the macros). I use both depending on where.

For my Mu͒seScore workshop, I even have a link list (source) written in a roff-like format that I convert to both Tₑχ/LᴬTᴇΧ (for PDF output) and HTML (for the website) using a Korn shell script, so much I like the format and structure.

Otherwise I’m somewhat a fan of plaintext (with UTF-8 line drawing, etc.) but not rST or md, and a large fan of just handwriting XHTML/1.1 snippets that can be included in webpages. (This ofc doesn’t transfer well to PDF.)

#nroff #groff #tex #latex #mdoc #mdocml #mandoc #mksh

Phone Zap for Khalique Brewer

"Khalique has not seen any justice, healing, or care for the multiple episodes of sexual abuse that he has faced inside

...

In collaboration with supporters of Khalique Brewer, MAPS calls for a two-day phone zap targeting Governor Whitmer, MDOC Director Heidi Washington, and Attorney General Dana Nessel to demand immediate relief for Khalique."

https://unsalted.noblogs.org/post/2023/08/07/phone-zap-for-khalique-brewer/

#Abolition #Michigan #PhoneZap #MDOC