2022-09-18 10:11:50 -05:00
<!doctype html>
< html lang = "en" class = "no-js" >
< head >
< meta charset = "utf-8" >
< meta name = "viewport" content = "width=device-width,initial-scale=1" >
2022-09-18 15:06:00 -05:00
< link rel = "canonical" href = "https://gh.dayl.in/task.mk/" >
2023-01-19 12:21:49 -06:00
< link rel = "next" href = "usage/" >
2022-09-18 10:11:50 -05:00
< link rel = "icon" href = "assets/images/favicon.png" >
2023-01-19 12:21:49 -06:00
< meta name = "generator" content = "mkdocs-1.4.2, mkdocs-material-9.0.5" >
2022-09-18 10:11:50 -05:00
< title > task.mk< / title >
2023-01-19 12:21:49 -06:00
< link rel = "stylesheet" href = "assets/stylesheets/main.558e4712.min.css" >
2022-09-18 10:11:50 -05:00
2023-01-19 12:21:49 -06:00
< link rel = "stylesheet" href = "assets/stylesheets/palette.2505c338.min.css" >
2022-09-18 10:11:50 -05:00
< link rel = "preconnect" href = "https://fonts.gstatic.com" crossorigin >
< link rel = "stylesheet" href = "https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback" >
< style > : root { --md-text-font : "Roboto" ; --md-code-font : "Roboto Mono" } < / style >
< link rel = "stylesheet" href = "stylesheets/extra.css" >
< link rel = "stylesheet" href = "stylesheets/asciinema-player.css" >
< script > _ _md _scope = new URL ( "." , location ) , _ _md _hash = e => [ ... e ] . reduce ( ( e , _ ) => ( e << 5 ) - e + _ . charCodeAt ( 0 ) , 0 ) , _ _md _get = ( e , _ = localStorage , t = _ _md _scope ) => JSON . parse ( _ . getItem ( t . pathname + "." + e ) ) , _ _md _set = ( e , _ , t = localStorage , a = _ _md _scope ) => { try { t . setItem ( a . pathname + "." + e , JSON . stringify ( _ ) ) } catch ( e ) { } } < / script >
< / head >
< body dir = "ltr" data-md-color-scheme = "default" data-md-color-primary = "" data-md-color-accent = "" >
< script > var palette = _ _md _get ( "__palette" ) ; if ( palette && "object" == typeof palette . color ) for ( var key of Object . keys ( palette . color ) ) document . body . setAttribute ( "data-md-color-" + key , palette . color [ key ] ) < / script >
< input class = "md-toggle" data-md-toggle = "drawer" type = "checkbox" id = "__drawer" autocomplete = "off" >
< input class = "md-toggle" data-md-toggle = "search" type = "checkbox" id = "__search" autocomplete = "off" >
< label class = "md-overlay" for = "__drawer" > < / label >
< div data-md-component = "skip" >
< a href = "#setup" class = "md-skip" >
Skip to content
< / a >
< / div >
< div data-md-component = "announce" >
< / div >
< header class = "md-header" data-md-component = "header" >
< nav class = "md-header__inner md-grid" aria-label = "Header" >
< a href = "." title = "task.mk" class = "md-header__button md-logo" aria-label = "task.mk" data-md-component = "logo" >
< svg xmlns = "http://www.w3.org/2000/svg" viewBox = "0 0 24 24" > < path d = "M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54Z" / > < / svg >
< / a >
< label class = "md-header__button md-icon" for = "__drawer" >
< svg xmlns = "http://www.w3.org/2000/svg" viewBox = "0 0 24 24" > < path d = "M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z" / > < / svg >
< / label >
< div class = "md-header__title" data-md-component = "header-title" >
< div class = "md-header__ellipsis" >
< div class = "md-header__topic" >
< span class = "md-ellipsis" >
task.mk
< / span >
< / div >
< div class = "md-header__topic" data-md-component = "header-topic" >
< span class = "md-ellipsis" >
Home
< / span >
< / div >
< / div >
< / div >
< form class = "md-header__option" data-md-component = "palette" >
< input class = "md-option" data-md-color-media = "" data-md-color-scheme = "default" data-md-color-primary = "" data-md-color-accent = "" aria-hidden = "true" type = "radio" name = "__palette" id = "__palette_1" >
< / form >
< label class = "md-header__button md-icon" for = "__search" >
< svg xmlns = "http://www.w3.org/2000/svg" viewBox = "0 0 24 24" > < path d = "M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z" / > < / svg >
< / label >
< div class = "md-search" data-md-component = "search" role = "dialog" >
< label class = "md-search__overlay" for = "__search" > < / label >
< div class = "md-search__inner" role = "search" >
< form class = "md-search__form" name = "search" >
< input type = "text" class = "md-search__input" name = "query" aria-label = "Search" placeholder = "Search" autocapitalize = "off" autocorrect = "off" autocomplete = "off" spellcheck = "false" data-md-component = "search-query" required >
< label class = "md-search__icon md-icon" for = "__search" >
< svg xmlns = "http://www.w3.org/2000/svg" viewBox = "0 0 24 24" > < path d = "M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z" / > < / svg >
< svg xmlns = "http://www.w3.org/2000/svg" viewBox = "0 0 24 24" > < path d = "M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z" / > < / svg >
< / label >
< nav class = "md-search__options" aria-label = "Search" >
< button type = "reset" class = "md-search__icon md-icon" title = "Clear" aria-label = "Clear" tabindex = "-1" >
< svg xmlns = "http://www.w3.org/2000/svg" viewBox = "0 0 24 24" > < path d = "M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z" / > < / svg >
< / button >
< / nav >
< / form >
< div class = "md-search__output" >
< div class = "md-search__scrollwrap" data-md-scrollfix >
< div class = "md-search-result" data-md-component = "search-result" >
< div class = "md-search-result__meta" >
Initializing search
< / div >
2023-01-19 12:21:49 -06:00
< ol class = "md-search-result__list" role = "presentation" > < / ol >
2022-09-18 10:11:50 -05:00
< / div >
< / div >
< / div >
< / div >
< / div >
< div class = "md-header__source" >
< a href = "https://github.com/daylinmorgan/task.mk" title = "Go to repository" class = "md-source" data-md-component = "source" >
< div class = "md-source__icon md-icon" >
2023-01-19 12:21:49 -06:00
< svg xmlns = "http://www.w3.org/2000/svg" viewBox = "0 0 448 512" > <!-- ! Font Awesome Free 6.2.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2022 Fonticons, Inc. --> < path d = "M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z" / > < / svg >
2022-09-18 10:11:50 -05:00
< / div >
< div class = "md-source__repository" >
daylinmorgan/task.mk
< / div >
< / a >
< / div >
< / nav >
< / header >
< div class = "md-container" data-md-component = "container" >
< main class = "md-main" data-md-component = "main" >
< div class = "md-main__inner md-grid" >
< div class = "md-sidebar md-sidebar--primary" data-md-component = "sidebar" data-md-type = "navigation" >
< div class = "md-sidebar__scrollwrap" >
< div class = "md-sidebar__inner" >
< nav class = "md-nav md-nav--primary" aria-label = "Navigation" data-md-level = "0" >
< label class = "md-nav__title" for = "__drawer" >
< a href = "." title = "task.mk" class = "md-nav__button md-logo" aria-label = "task.mk" data-md-component = "logo" >
< svg xmlns = "http://www.w3.org/2000/svg" viewBox = "0 0 24 24" > < path d = "M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54Z" / > < / svg >
< / a >
task.mk
< / label >
< div class = "md-nav__source" >
< a href = "https://github.com/daylinmorgan/task.mk" title = "Go to repository" class = "md-source" data-md-component = "source" >
< div class = "md-source__icon md-icon" >
2023-01-19 12:21:49 -06:00
< svg xmlns = "http://www.w3.org/2000/svg" viewBox = "0 0 448 512" > <!-- ! Font Awesome Free 6.2.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2022 Fonticons, Inc. --> < path d = "M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z" / > < / svg >
2022-09-18 10:11:50 -05:00
< / div >
< div class = "md-source__repository" >
daylinmorgan/task.mk
< / div >
< / a >
< / div >
< ul class = "md-nav__list" data-md-scrollfix >
< li class = "md-nav__item md-nav__item--active" >
< input class = "md-nav__toggle md-toggle" data-md-toggle = "toc" type = "checkbox" id = "__toc" >
< label class = "md-nav__link md-nav__link--active" for = "__toc" >
Home
< span class = "md-nav__icon md-icon" > < / span >
< / label >
< a href = "." class = "md-nav__link md-nav__link--active" >
Home
< / a >
< nav class = "md-nav md-nav--secondary" aria-label = "Table of contents" >
< label class = "md-nav__title" for = "__toc" >
< span class = "md-nav__icon md-icon" > < / span >
Table of contents
< / label >
< ul class = "md-nav__list" data-md-component = "toc" data-md-scrollfix >
< li class = "md-nav__item" >
< a href = "#setup" class = "md-nav__link" >
Setup
< / a >
< / li >
< li class = "md-nav__item" >
< a href = "#zsh-completions-for-gnu-make" class = "md-nav__link" >
Zsh Completions for GNU Make
< / a >
< / li >
< li class = "md-nav__item" >
< a href = "#why-make" class = "md-nav__link" >
Why Make?
< / a >
< / li >
< li class = "md-nav__item" >
< a href = "#simpler-alternative" class = "md-nav__link" >
Simpler Alternative
< / a >
< / li >
< / ul >
< / nav >
< / li >
< li class = "md-nav__item" >
< a href = "usage/" class = "md-nav__link" >
Usage
< / a >
< / li >
< li class = "md-nav__item md-nav__item--nested" >
2023-01-19 12:21:49 -06:00
< input class = "md-nav__toggle md-toggle " data-md-toggle = "__nav_3" type = "checkbox" id = "__nav_3" >
2022-09-18 10:11:50 -05:00
2022-09-24 17:56:44 -05:00
2022-09-18 10:11:50 -05:00
< div class = "md-nav__link md-nav__link--index " >
< a href = "examples/" > Examples< / a >
< label for = "__nav_3" >
< span class = "md-nav__icon md-icon" > < / span >
< / label >
< / div >
< nav class = "md-nav" aria-label = "Examples" data-md-level = "1" >
< label class = "md-nav__title" for = "__nav_3" >
< span class = "md-nav__icon md-icon" > < / span >
Examples
< / label >
< ul class = "md-nav__list" data-md-scrollfix >
< li class = "md-nav__item md-nav__item--nested" >
2023-01-19 12:21:49 -06:00
< input class = "md-nav__toggle md-toggle " data-md-toggle = "__nav_3_2" type = "checkbox" id = "__nav_3_2" >
2022-09-18 10:11:50 -05:00
< div class = "md-nav__link md-nav__link--index " >
< a href = "examples/check/" > Check< / a >
< / div >
< nav class = "md-nav" aria-label = "Check" data-md-level = "2" >
< label class = "md-nav__title" for = "__nav_3_2" >
< span class = "md-nav__icon md-icon" > < / span >
Check
< / label >
< ul class = "md-nav__list" data-md-scrollfix >
< / ul >
< / nav >
< / li >
< li class = "md-nav__item md-nav__item--nested" >
2023-01-19 12:21:49 -06:00
< input class = "md-nav__toggle md-toggle " data-md-toggle = "__nav_3_3" type = "checkbox" id = "__nav_3_3" >
2022-09-18 10:11:50 -05:00
< div class = "md-nav__link md-nav__link--index " >
< a href = "examples/embedded/" > Embedded< / a >
< / div >
< nav class = "md-nav" aria-label = "Embedded" data-md-level = "2" >
< label class = "md-nav__title" for = "__nav_3_3" >
< span class = "md-nav__icon md-icon" > < / span >
Embedded
< / label >
< ul class = "md-nav__list" data-md-scrollfix >
< / ul >
< / nav >
< / li >
2022-09-24 17:56:44 -05:00
< li class = "md-nav__item md-nav__item--nested" >
2023-01-19 12:21:49 -06:00
< input class = "md-nav__toggle md-toggle " data-md-toggle = "__nav_3_4" type = "checkbox" id = "__nav_3_4" >
2022-09-24 17:56:44 -05:00
< div class = "md-nav__link md-nav__link--index " >
< a href = "examples/recipe-help/" > Recipe help< / a >
< / div >
< nav class = "md-nav" aria-label = "Recipe help" data-md-level = "2" >
< label class = "md-nav__title" for = "__nav_3_4" >
< span class = "md-nav__icon md-icon" > < / span >
Recipe help
< / label >
< ul class = "md-nav__list" data-md-scrollfix >
< / ul >
< / nav >
< / li >
2022-09-18 10:11:50 -05:00
< / ul >
< / nav >
< / li >
< / ul >
< / nav >
< / div >
< / div >
< / div >
< div class = "md-sidebar md-sidebar--secondary" data-md-component = "sidebar" data-md-type = "toc" >
< div class = "md-sidebar__scrollwrap" >
< div class = "md-sidebar__inner" >
< nav class = "md-nav md-nav--secondary" aria-label = "Table of contents" >
< label class = "md-nav__title" for = "__toc" >
< span class = "md-nav__icon md-icon" > < / span >
Table of contents
< / label >
< ul class = "md-nav__list" data-md-component = "toc" data-md-scrollfix >
< li class = "md-nav__item" >
< a href = "#setup" class = "md-nav__link" >
Setup
< / a >
< / li >
< li class = "md-nav__item" >
< a href = "#zsh-completions-for-gnu-make" class = "md-nav__link" >
Zsh Completions for GNU Make
< / a >
< / li >
< li class = "md-nav__item" >
< a href = "#why-make" class = "md-nav__link" >
Why Make?
< / a >
< / li >
< li class = "md-nav__item" >
< a href = "#simpler-alternative" class = "md-nav__link" >
Simpler Alternative
< / a >
< / li >
< / ul >
< / nav >
< / div >
< / div >
< / div >
< div class = "md-content" data-md-component = "content" >
< article class = "md-content__inner md-typeset" >
2023-01-19 12:21:49 -06:00
2022-09-18 10:11:50 -05:00
2023-01-19 12:21:49 -06:00
< h1 > Home< / h1 >
2022-09-18 10:11:50 -05:00
< div align = "center" >
< h1 align = "center" > task.mk < / h1 >
< img src = "https://raw.githubusercontent.com/daylinmorgan/task.mk/main/assets/help.svg" alt = "help" width = 400 >
< p align = "center" >
the task runner for GNU Make you've been missing
< / p >
< / div >
< p > < / br > < / p >
< p > GNU make is an excellent build tool and the task runner we love to hate, but can't escape.
So let's improve the UX to make it the best task runner it can be.< / p >
< p > < code > Task.mk< / code > , is a standalone < code > Makefile< / code > you can deploy alongside your own
to add some QOL improvements for your users and fellow maintainers.< / p >
< p > Current Features:< / p >
< ul >
< li > ANSI escape code support (including NO_COLOR)< / li >
< li > formatted help output< / li >
< li > custom print function< / li >
< li > confirmation prompt< / li >
< / ul >
2022-09-21 16:32:21 -05:00
< p > Depends on < code > GNU Make< / code > , obviously and < code > Python > =3.7< / code > , and < code > bash< / code > (or < code > zsh< / code > ).< / p >
2022-09-18 10:11:50 -05:00
< p > Wait python?!?!, I'm not < code > pip< / code > installing some package just to parse my makefile.
2023-01-19 13:45:04 -06:00
I agree, all you need is one file < a href = "https://github.com/daylinmorgan/task.mk/v23.1.1/task.mk" > < code > .task.mk< / code > < / a > .
2022-09-18 10:11:50 -05:00
You can automagically include it with just two additional lines to your < code > Makefile< / code > (and probably one to your < code > .gitignore< / code > ) and your good to go.< / p >
< h2 id = "setup" > Setup< / h2 >
< p > You can include this as an optional dependency on your project by adding the below lines to the end of your < code > Makefile< / code > .
If someone tries to invoke < code > make help< / code > it will download < code > .task.mk< / code > for them.< / p >
< div class = "highlight" > < pre > < span > < / span > < code > < a id = "__codelineno-0-1" name = "__codelineno-0-1" href = "#__codelineno-0-1" > < / a > < span class = "cp" > -include .task.mk< / span >
2023-01-19 13:45:04 -06:00
< a id = "__codelineno-0-2" name = "__codelineno-0-2" href = "#__codelineno-0-2" > < / a > < span class = "nf" > $(if $(filter help,$(MAKECMDGOALS)),$(if $(wildcard .task.mk),,.task.mk< / span > < span class = "o" > :< / span > < span class = "w" > < / span > ; < span class = "n" > curl< / span > -< span class = "n" > fsSL< / span > < span class = "n" > https< / span > ://< span class = "n" > raw< / span > .< span class = "n" > githubusercontent< / span > .< span class = "n" > com< / span > /< span class = "n" > daylinmorgan< / span > /< span class = "n" > task< / span > .< span class = "n" > mk< / span > /< span class = "n" > v< / span > 23.1.1/< span class = "n" > task< / span > .< span class = "n" > mk< / span > -< span class = "n" > o< / span > .< span class = "n" > task< / span > .< span class = "n" > mk< / span > ))
2022-09-18 10:11:50 -05:00
< / code > < / pre > < / div >
< p > You might also consider making it a consistently downloaded dependency if you plan to use any of it's advanced feature set, by dropping the < code > $(MAKECMDGOALS)< / code > check.< / p >
< div class = "highlight" > < pre > < span > < / span > < code > < a id = "__codelineno-1-1" name = "__codelineno-1-1" href = "#__codelineno-1-1" > < / a > < span class = "cp" > -include .task.mk< / span >
2023-01-19 13:45:04 -06:00
< a id = "__codelineno-1-2" name = "__codelineno-1-2" href = "#__codelineno-1-2" > < / a > < span class = "nf" > $(if $(wildcard .task.mk),,.task.mk< / span > < span class = "o" > :< / span > < span class = "w" > < / span > ; < span class = "n" > curl< / span > -< span class = "n" > fsSL< / span > < span class = "n" > https< / span > ://< span class = "n" > raw< / span > .< span class = "n" > githubusercontent< / span > .< span class = "n" > com< / span > /< span class = "n" > daylinmorgan< / span > /< span class = "n" > task< / span > .< span class = "n" > mk< / span > /< span class = "n" > v< / span > 23.1.1/< span class = "n" > task< / span > .< span class = "n" > mk< / span > -< span class = "n" > o< / span > .< span class = "n" > task< / span > .< span class = "n" > mk< / span > )
2022-09-18 10:11:50 -05:00
< / code > < / pre > < / div >
< p > Alternatively, you can use the builtin rule < code > _update-task.mk< / code > to update to the latest development version.< / p >
< p > See < a href = "./usage" > Usage< / a > to get started running all your tasks.
See < a href = "./examples" > Examples< / a > for more use cases.< / p >
< h2 id = "zsh-completions-for-gnu-make" > Zsh Completions for GNU Make< / h2 >
< p > If you use < code > GNU Make< / code > with zsh you may want to add the following
line to your rc file to allow < code > make< / code > to handle the autocomplete.< / p >
2023-01-19 12:21:49 -06:00
< div class = "highlight" > < pre > < span > < / span > < code > < a id = "__codelineno-2-1" name = "__codelineno-2-1" href = "#__codelineno-2-1" > < / a > zstyle< span class = "w" > < / span > < span class = "s1" > ' :completion::complete:make:*:targets' < / span > < span class = "w" > < / span > call-command< span class = "w" > < / span > < span class = "nb" > true< / span >
2022-09-18 10:11:50 -05:00
< / code > < / pre > < / div >
< h2 id = "why-make" > Why Make?< / h2 >
< p > There are lot of < code > GNU Make< / code > alternatives but none have near the same level of ubiquity.
This project attaches to < code > make< / code > some of the native features of < a href = "https://github.com/casey/just" > < code > just< / code > < / a > , a command runner.< / p >
< p > Just is a great task runner, but it suffers two problems, users probably don't have it installed already, and there is no way to define file specific recipes.
Most of my < code > Makefile< / code > 's are comprised primarily of handy < code > .PHONY< / code > recipes, but I always end up with a few file specific recipes.< / p >
< p > Another interesting project I've evaluated for these purposes is < a href = "https://github.com/go-task/task" > < code > go-task/task< / code > < / a > .
< code > Task< / code > has many of the features of < code > GNU Make< / code > and some novel features of it's own.
But like < code > just< / code > it's a tool people don't usually already have and it's configured using a < code > yaml< / code > file.
< code > Yaml< / code > files can be finicky to work with and and it uses a golang based shell runtime, not your native shell, which might lead to unexpected behavior.< / p >
< h2 id = "simpler-alternative" > Simpler Alternative< / h2 >
< p > But I just want a basic help output, surely I don't need python for this... you would be right.
< code > Task.mk< / code > replaces my old < code > make help< / code > recipe boilerplate which may better serve you (so long as you have < code > sed< / code > /< code > awk< / code > ).< / p >
< div class = "highlight" > < pre > < span > < / span > < code > < a id = "__codelineno-3-1" name = "__codelineno-3-1" href = "#__codelineno-3-1" > < / a > < span class = "c" > ## h, help | show this help< / span >
2023-01-19 12:21:49 -06:00
< a id = "__codelineno-3-2" name = "__codelineno-3-2" href = "#__codelineno-3-2" > < / a > < span class = "nf" > .PHONY< / span > < span class = "o" > :< / span > < span class = "w" > < / span > < span class = "n" > help< / span > < span class = "n" > h< / span >
< a id = "__codelineno-3-3" name = "__codelineno-3-3" href = "#__codelineno-3-3" > < / a > < span class = "nf" > help h< / span > < span class = "o" > :< / span > < span class = "w" > < / span > < span class = "n" > Makefile< / span >
< a id = "__codelineno-3-4" name = "__codelineno-3-4" href = "#__codelineno-3-4" > < / a > < span class = "w" > < / span > @awk< span class = "w" > < / span > -v< span class = "w" > < / span > < span class = "nv" > fill< / span > < span class = "o" > =< / span > < span class = "k" > $(< / span > shell< span class = "w" > < / span > sed< span class = "w" > < / span > -n< span class = "w" > < / span > < span class = "s1" > ' s/^## \(.*\) | .*/\1/p' < / span > < span class = "w" > < / span > $< < span class = "w" > < / span > < span class = "p" > |< / span > < span class = "w" > < / span > wc< span class = "w" > < / span > -L< span class = "k" > )< / span > < span class = "se" > \< / span >
< a id = "__codelineno-3-5" name = "__codelineno-3-5" href = "#__codelineno-3-5" > < / a > < span class = "w" > < / span > < span class = "s1" > ' match($$0,/^## (.*) \|/,name) & & match($$0,/\| (.*)$$/,help)\< / span >
2022-09-18 10:11:50 -05:00
< a id = "__codelineno-3-6" name = "__codelineno-3-6" href = "#__codelineno-3-6" > < / a > < span class = "s1" > {printf " \033[1;93m%*s\033[0m | \033[30m%s\033[0m\n" ,\< / span >
< a id = "__codelineno-3-7" name = "__codelineno-3-7" href = "#__codelineno-3-7" > < / a > < span class = "s1" > fill,name[1],help[1];} match($$0,/^### (.*)/,str) \< / span >
2023-01-19 12:21:49 -06:00
< a id = "__codelineno-3-8" name = "__codelineno-3-8" href = "#__codelineno-3-8" > < / a > < span class = "s1" > {printf " %*s \033[30m%s\033[0m\n" ,fill," " ,str[1];}' < / span > < span class = "w" > < / span > $<
2022-09-18 10:11:50 -05:00
< / code > < / pre > < / div >
< hr >
< div class = "md-source-file" >
< small >
Last update:
2023-01-19 13:45:04 -06:00
< span class = "git-revision-date-localized-plugin git-revision-date-localized-plugin-date" > January 19, 2023< / span >
2022-09-18 10:11:50 -05:00
< br >
Created:
2022-09-25 17:10:08 -05:00
< span class = "git-revision-date-localized-plugin git-revision-date-localized-plugin-date" > September 18, 2022< / span >
2022-09-18 10:11:50 -05:00
< / small >
< / div >
< / article >
< / div >
< / div >
< / main >
< footer class = "md-footer" >
< div class = "md-footer-meta md-typeset" >
< div class = "md-footer-meta__inner md-grid" >
< div class = "md-copyright" >
Made with
< a href = "https://squidfunk.github.io/mkdocs-material/" target = "_blank" rel = "noopener" >
Material for MkDocs
< / a >
< / div >
< / div >
< / div >
< / footer >
< / div >
< div class = "md-dialog" data-md-component = "dialog" >
< div class = "md-dialog__inner md-typeset" > < / div >
< / div >
2023-01-19 12:21:49 -06:00
< script id = "__config" type = "application/json" > { "base" : "." , "features" : [ "navigation.indexes" ] , "search" : "assets/javascripts/workers/search.e5c33ebb.min.js" , "translations" : { "clipboard.copied" : "Copied to clipboard" , "clipboard.copy" : "Copy to clipboard" , "search.result.more.one" : "1 more on this page" , "search.result.more.other" : "# more on this page" , "search.result.none" : "No matching documents" , "search.result.one" : "1 matching document" , "search.result.other" : "# matching documents" , "search.result.placeholder" : "Type to start searching" , "search.result.term.missing" : "Missing" , "select.version" : "Select version" } } < / script >
2022-09-18 10:11:50 -05:00
2022-09-19 00:01:42 -05:00
2023-01-19 12:21:49 -06:00
< script src = "assets/javascripts/bundle.51d95adb.min.js" > < / script >
2022-09-18 10:11:50 -05:00
2022-09-19 00:01:42 -05:00
< script src = "javascripts/asciinema-player.min.js" > < / script >
2022-09-18 10:11:50 -05:00
2022-09-19 00:01:42 -05:00
2022-09-18 10:11:50 -05:00
< / body >
< / html >
