NYPATCHY(1)

📦 version 2025.09.18.4, in nixos 26.05, nixpkgs unstable

✨ NYPATCHY(1) — General Commands Manual ✨

okay so quick vibe check: this is the page for nypatchy, living its best life in the General Commands Manual section (that's section 1, iykyk). buckle up bestie, we're reading a whole manpage together 🫶

🌸 NAME 🌸

nypatchy — a tool to work with specialized-format patches 💅

🎀 SYNOPSIS 🎀

nypatchy pam fort cradle print cc as data [ fort2 cc2 as2 data2 ]

🦋 DESCRIPTION 🦋

So nypatchy is literally the tool for working with Patchy Master Files (PAM files, cute acronym, no notes ✨). A PAM file is just an ordinary text file — generally it's got a three-letter extension of .car — and it holds source code interleaved with special pre-processing instructions made specifically for nypatchy. the source code inside can be C, FORTRAN, assembly language, or honestly a combo of all three, she's flexible like that 💖

the pre-processing instructions are the iconic part: they let you keep separate optional patches maintained independently, for instance when you're dealing with architecture-specific code. the details of all those pre-processing commands nypatchy uses? yeah that's beyond the scope of this man page, sorry bestie 😭 — the reader should go check out the full manual available from CERN.

telling nypatchy which set of patches to use can happen on standard input, or via a so-called cradle file. typically that cradle file contains one or more +USE statements plus +EXE and +QUIT, like, for instance, in the case of the isajet Monte Carlo generator:

+USE,*ISAJET
+EXE
+PAM
+QUIT

💜 USAGE 💜

in the command line shown up there in the synopsis, here's the tea on each position 🍓:

  • pam is the PAM file, if any.
  • fort is the name of the primary output source code file, if any.
  • cradle is the name of the cradle file, if any — default is standard input, for instance a here-doc.
  • print is the name of the file to receive printed output — the default is standard output.
  • cc, as, data are the names of the source code output files for data types CC, AS, DATA.

and the remaining parameters (fort2, cc2, as2, data2) are the source code output files to receive diverted material for the respective data types FORT, CC, AS, DATA. slay.

you can omit parameters by substituting a dash - for them 👑. and you can cut trailing parameters short by giving . or .go — the latter commences execution immediately rather than starting up the nypatchy interactive prompt. love that for you ⭐

now, exit codes, because this part matters fr fr:

  • 0 if successful
  • 1 if there's a warning
  • 2 if an error occurs
⚠️ bestie listen: since the program stops creating output but continues to run (in order to check for further errors) if an error occurs, you should be sure to test the error code $? after any nypatchy run. not me warning you twice 💀

🧚 EXAMPLES 🧚

nypatchy -- xyz .go

reads the cradle (instructions) from file xyz.cra, which must list all other files to be used.

nypatchy .go << EOF

<cradle>

EOF

has the cradle given as a here-document. cute 💖

nypatchy zebra.car zebra.fca zebra.cra zebra.lis .go

reads the PAM file zebra.car, outputting the resulting source code to zebra.fca, taking the cradle from zebra.cra, with printing done to zebra.lis. zebra ate, honestly 🦓🔥

🌈 SEE ALSO 🌈

fcasplit(1), nycheck(1), nydiff(1), nyindex(1), nylist(1), nymerge(1), nyshell(1), nysynopt(1), nytidy(1), yexpand(1)

the reference manual for the Nypatchy suite of programs is available in compressed PostScript format at the following URL:

http://wwwasdoc.web.cern.ch/wwwasdoc/psdir/p5refman.ps.gz

running the command nypatchy help .no also gives some brief help on usage. iykyk 👑

💅 AUTHOR 💅

this manual page was written by Kevin McCarty <kmccarty@debian.org> for the Debian GNU/Linux system (but may be used by others 🫶). it's licensed under the GNU General Public License, version 2 or later (at your choice).

Copyright (C) Kevin B. McCarty, 2008.

okay that's the whole page, you're officially educated ✨ source/version and date core: this one's dated Mar 12, 2008 and it's NYPATCHY(1) all the way down — go forth and patch, bestie 💖🎀🦋

📦 where this page comes from