shishi_cfg_userdirectory_file(3)

📦
version 1.0.3 · 2 versions
  • 1.0.3 · debian bookworm, debian trixie, nixos 26.05, nixpkgs unstable, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking (latest)
  • 1.0.2 · ubuntu jammy
, in debian bookworm, debian trixie, nixos 26.05, nixpkgs unstable, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 shishi_cfg_userdirectory_file(3) 💖

okay bestie, welcome to the shishi manual, section 3 — yes this is a library function page, not a command, and yes it's lowkey iconic 🫶

✨ NAME ✨

shishi_cfg_userdirectory_file — it's an API function, no cap 💅

🌸 SYNOPSIS 🌸

#include <shishi.h>

char * shishi_cfg_userdirectory_file(Shishi * handle, const char *
file);

🎀 ARGUMENTS 🎀

  • Shishi * handle — the Shishi library handle, and you get it from shishi_init(). it's giving "you must be this tall to ride", literally you gotta init first ✨
  • const char * file — the basename of the file you want to use for the user's configuration settings of the library. just the basename, bestie, not the whole journey 🙈

🦋 DESCRIPTION 🦋

so basically this function reports the full path to the file where the Shishi library expects to find the user's library configuration — given that the file itself is named by the parameter file 👑

the answer gets composed from two things: the value of file, and the directory that shishi_cfg_default_userdirectory() hands back. it's a collab, fr fr 🤝

typically? the returned string would be expanded from "$HOME/.shishi/file" — yes, that's the vibe, that's the whole aesthetic 🏠✨

⭐ RETURN VALUE ⭐

returns the absolute filename to the argument file, relative to the user specific Shishi configuration directory. it's absolute but relative, which sounds contradictory and yet — main character energy, she contains multitudes 💜

💀 REPORTING BUGS 💀

found a bug? not you being the QA queen 👑 report them to <bug-shishi@gnu.org>.

Copyright © 2002-2022 Simon Josefsson.

Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. slay, royalty-free, we love to see it 🎀

🌈 SEE ALSO 🌈

the full documentation for shishi is maintained as a Texinfo manual. if the info and shishi programs are properly installed at your site, the command

info shishi

should give you access to the complete manual. iykyk 📖✨

and that's the whole page, bestie 🫶 this was shishi version 1.0.3, page shishi_cfg_userdirectory_file(3) — go forth and configure your user directory, you absolute legend 💅🌸

📦 where this page comes from