From c215f4f404f1b3356b971a85953223cd1f1ff1a6 Mon Sep 17 00:00:00 2001 From: Stack-1 Date: Sat, 13 Jun 2026 15:41:10 +0200 Subject: [PATCH] docs: fix GitHub rendering of internals and PDF - communication.md: replace the Mermaid state diagram with a plain-text diagram (Mermaid showed 'Error rendering embedded code' on GitHub) - regenerate psblas-3.9.pdf as PDF 1.5 (matching the previous build) instead of TeX Live 2026's default 1.7, which GitHub's viewer failed to load --- docs/internals/communication.md | 20 +++++++++++--------- docs/psblas-3.9.pdf | 8 ++++---- 2 files changed, 15 insertions(+), 13 deletions(-) diff --git a/docs/internals/communication.md b/docs/internals/communication.md index f4cc264db..17697a64f 100644 --- a/docs/internals/communication.md +++ b/docs/internals/communication.md @@ -119,15 +119,17 @@ psb_comm_status_wait_ (complete a previously started exchange) psb_comm_status_sync_ (start + wait in one call; the default) ``` -```mermaid -stateDiagram-v2 - [*] --> unknown - unknown --> sync: mode = sync - unknown --> start: mode = start - sync --> sync: repeated synchronous exchanges - start --> wait: mode = wait - wait --> start: next split-phase exchange - wait --> sync: switch back to synchronous +``` + synchronous (default): unknown --> sync --> sync --> ... + split-phase: unknown --> start --> wait --> start --> wait --> ... + + transitions (driven by the mode argument): + unknown --(mode=sync)--> sync single-call exchange (post + complete) + unknown --(mode=start)--> start post sends/recvs, then return + start --(mode=wait)--> wait complete the started exchange + wait --(mode=start)--> start begin the next split-phase exchange + wait --(mode=sync)--> sync switch back to synchronous + sync --(mode=sync)--> sync repeated synchronous exchanges ``` In the scheme implementations the two phases map onto the obvious MPI pairs, for diff --git a/docs/psblas-3.9.pdf b/docs/psblas-3.9.pdf index a9b7ff204..7a3bf7a69 100644 --- a/docs/psblas-3.9.pdf +++ b/docs/psblas-3.9.pdf @@ -1,4 +1,4 @@ -%PDF-1.7 +%PDF-1.5 %ÐÔÅØ 2 0 obj << @@ -40918,8 +40918,8 @@ endobj 2472 0 obj << /Title (Parallel Sparse BLAS V. 3.9.0) /Subject (Parallel Sparse Basic Linear Algebra Subroutines) /Keywords (Computer Science Linear Algebra Fluid Dynamics Parallel Linux MPI PSBLAS Iterative Solvers Preconditioners) /Creator (pdfLaTeX) /Producer ($Id$) /Author()/Title()/Subject()/Creator(LaTeX with hyperref)/Keywords() -/CreationDate (D:20260613144351+02'00') -/ModDate (D:20260613144351+02'00') +/CreationDate (D:20260613153627+02'00') +/ModDate (D:20260613153627+02'00') /Trapped /False /PTEX.Fullbanner (This is pdfTeX, Version 3.141592653-2.6-1.40.29 (TeX Live 2026) kpathsea version 6.4.2) >> @@ -41451,7 +41451,7 @@ endobj /W [1 3 1] /Root 2471 0 R /Info 2472 0 R -/ID [ ] +/ID [ ] /Length 12370 >> stream