fancy_echo用法和文档的来源

Question

我正在寻找一个安装脚本的起点，它允许我自动配置新的或重新映像的计算机并遇到one by thoughtbot。但是，它经常使用我不熟悉的命令，fancy_echo。

fancy_echo() {
  local fmt="$1"; shift # shellcheck disable=SC2059
  printf "\n$fmt\n" "$@"
}

它也用于此script by dockyard：

fancy_echo "This script will setup your laptop"
fancy_echo "If you want to reuse your old SSH key, copy your SSH config over before running this script"
fancy_echo "During installation, it will ask for your sudo password a few times"

由于这是在命令行中运行并且看起来像bash，我已经尝试过手册页，standalone GNU info system和--help选项，都没有运气。我认为它打印到屏幕但我不知道，所以我问。以下是我的问题：

1. 什么是fancy_echo，它与echo有什么不同？
2. 什么是文档的良好来源？

Answer 1

它不是一个标准命令，没有文档，它只是你复制了它的定义的函数，它是该软件包的内部。

fancy_echo format_string arg arg arg....

相当于

printf format_string arg arg arg....

除了它在输出周围添加换行符。