MAKEFILE(5)

πŸ’– MAKEFILE(5) πŸ’–

okay so bestie, gather round 🫢 β€” this is the Makefile from the NetBSD man5 directory (revision 1.4 if you're keeping score), and it's literally the whole vibe check for which Postfix section‑5 pages get installed. No prose, no chit-chat, just three variable assignments and one commented-out corner of dreams. We're gonna read it like a group chat πŸ’…


✨ NAME ✨

Makefile β€” the NetBSD make fragment that points at the Postfix man/man5 dist directory, lists the .5 man pages to install, and links one page to another. 🌸

🌸 SYNOPSIS 🌸

#       $NetBSD: Makefile,v 1.4 2013/01/02 22:33:20 tron Exp $

DIST=   ${NETBSDSRCDIR}/external/ibm‐public/postfix/dist/man/man5

MAN=    access.5   aliases.5   bounce.5  canonical.5  relocated.5
    transport.5    virtual.5    sqlite_table.5     regexp_table.5
       cidr_table.5    header_checks.5    ldap_table.5   master.5
   nisplus_table.5 generic.5 memcache_table.5  MAN+=   postconf.5
postfix‐wrapper.5

MLINKS= header_checks.5 body_checks.5

#  XXX notyet: # The base install does include support for these:
# mysql_table.5 pgsql_table.5

πŸ’œ DESCRIPTION πŸ’œ

bestie, real talk: this isn't a man page at all, it's a make(1) file that happens to live next to a bunch of man pages β€” but the energy is the same, so we're doing this. It does exactly three things: sets DIST, sets MAN, sets MLINKS. Then there's a little XXX notyet comment at the bottom that's just sitting there being a mood. That's it, that's the page. Periodt. πŸ’…


πŸŽ€ DIST πŸŽ€

DIST=   ${NETBSDSRCDIR}/external/ibm‐public/postfix/dist/man/man5

one (1) variable, one (1) job: point at the Postfix man/man5 dist directory, rooted at ${NETBSDSRCDIR} and living under external/ibm‐public/postfix/dist/man/man5. That ${NETBSDSRCDIR} is a variable reference, not a typo β€” leave it alone, it resolves later ✨


πŸ‘‘ MAN πŸ‘‘

the main character section, honestly. eighteen pages, listed in this exact order, do not shuffle:

  • access.5 🌸
  • aliases.5 πŸ¦‹
  • bounce.5 πŸ’–
  • canonical.5 ⭐
  • relocated.5 🌈
  • transport.5 πŸŽ€
  • virtual.5 🧚
  • sqlite_table.5 πŸ’œ
  • regexp_table.5 🌟
  • cidr_table.5 πŸ“
  • header_checks.5 πŸ”₯
  • ldap_table.5 πŸ’«
  • master.5 πŸ‘‘
  • nisplus_table.5 🌷
  • generic.5 🫢
  • memcache_table.5 😭

and then, still inside that same MAN story, two more join the party via MAN+=:

  • postconf.5 ✨
  • postfix‐wrapper.5 πŸ¦‹
ngl the formatting is a little chaotic β€” MAN+= is literally chillin' on the same line as memcache_table.5, and postfix‐wrapper.5 starts back at column zero. it's giving "written at 3am" but it works, so we respect it πŸ™ˆ

MLINKS= header_checks.5 body_checks.5

one pair, one link: body_checks.5 rides shotgun with header_checks.5. they're the same page, they just have different names β€” matching outfits, iykyk πŸ‘―β€β™€οΈ (and yes, body_checks.5 is not in the MAN list above, this line is the only place it shows up. don't come for me, that's just what it says.)


πŸ’€ XXX notyet πŸ’€

#  XXX notyet: # The base install does include support for these:
# mysql_table.5 pgsql_table.5

look at this shy little commented-out section πŸ₯Ί it's fully disabled β€” everything on these two lines is commented out, including mysql_table.5 and pgsql_table.5, so neither of those is in the MAN list. the note itself swears up and down that "The base install does include support for these" β€” but they are not enabled here. It's notyet, bestie. not yet. πŸ’€

note the double comment markers, # XXX notyet: # β€” yes, there really are two #s on that line. iconic, no notes.


⚠️ lowkey important: mysql_table.5 and pgsql_table.5 are commented out in this file. Don't go looking for them in MAN β€” they are not there, and this page is not gonna pretend otherwise. πŸ’…

okay that's the whole file, you ate that πŸ“ stay hydrated, back up your Makefiles, and remember β€” it's not a bug, it's a notyet.

<copyright>πŸ’–</copyright> this one came out of NetBSD revision 1.4, dated 2013/01/02, and it was committed by tron β€” go give her a follow, she understood the assignment. mwah 😽 bye bestie!!

πŸ“¦ where this page comes from