DECORATE(1)

💖 DECORATE(1) 💖

ok bestie, welcome to decorate — it's a lil helper from the User Commands section of the manual, and it's literally about to make your sorting life so much cuter. 🎀

✨ NAME ✨

decorate — convert fields of various formats 🦋

🌸 SYNOPSIS 🌸

decorate [OPTION]... [INPUT]
decorate --decorate [OPTION]... [INPUT]
decorate --undecorate N [OPTION]... [INPUT]

👑 DESCRIPTION 👑

It converts fields of various formats, and if you want, it sorts them too. the range?? immaculate. 💅

ok so here's the tea on how it behaves, depending on which mode you're in:

• With --decorate — it adds the converted fields to the start of each line and prints it to STDOUT. note that it does not sort. no sorting here, bestie, we're just decorating. ✨
• With --undecorate — it removes the first N fields from the input. use this as your post-processing step after sort(1). it's giving cleanup era. 🧹
• Without --decorate and --undecorate — it automatically decorates the input, runs sort(1), and undecorates the result. this is the easiest method to use, fr fr. 🫶

and like, why do you even care? because decorate lets you sort input according to various orderings — think IP addresses, roman numerals, etc. it works in tandem with sort(1) to perform the actual sorting. it's a whole collab, and honestly? they ate. 🔥

ngl the decorate + sort(1) combo is the moment. it does the actual sorting, decorate just sets the vibe. 😭

and that's the whole page, babe — DECORATE(1), straight out of the User Commands section. no source/version/date info came along with it, so that's all we got, and we slayed with it. mwah. 💖✨🎀