Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Automatic mdBook Documentation #2897

Merged
merged 16 commits into from
Jan 25, 2022
Merged
Show file tree
Hide file tree
Changes from 11 commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions .vscode/cspell.dictionaries/workspace.wordlist.txt
Original file line number Diff line number Diff line change
Expand Up @@ -25,6 +25,7 @@ getrandom
globset
itertools
lscolors
mdbook
memchr
multifilereader
onig
Expand Down Expand Up @@ -322,6 +323,7 @@ ucommand
utmpx
uucore
uucore_procs
uudoc
uumain
uutil
uutils
Expand Down
5 changes: 5 additions & 0 deletions Cargo.toml
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,7 @@ version = "0.0.9"
authors = ["uutils developers"]
license = "MIT"
description = "coreutils ~ GNU coreutils (updated); implemented as universal (cross-platform) utils, written in Rust"
default-run = "coreutils"

homepage = "https:/uutils/coreutils"
repository = "https:/uutils/coreutils"
Expand Down Expand Up @@ -389,3 +390,7 @@ unix_socket = "0.5.0"
[[bin]]
name = "coreutils"
path = "src/bin/coreutils.rs"

[[bin]]
name = "uudoc"
path = "src/bin/uudoc.rs"
10 changes: 2 additions & 8 deletions GNUmakefile
Original file line number Diff line number Diff line change
Expand Up @@ -279,10 +279,7 @@ endif
build-coreutils:
${CARGO} build ${CARGOFLAGS} --features "${EXES}" ${PROFILE_CMD} --no-default-features

build-manpages:
cd $(DOCSDIR) && $(MAKE) man

build: build-coreutils build-pkgs build-manpages
build: build-coreutils build-pkgs

$(foreach test,$(filter-out $(SKIP_UTILS),$(PROGS)),$(eval $(call TEST_BUSYBOX,$(test))))

Expand Down Expand Up @@ -330,14 +327,11 @@ ifeq (${MULTICALL}, y)
cd $(INSTALLDIR_BIN) && $(foreach prog, $(filter-out coreutils, $(INSTALLEES)), \
ln -fs $(PROG_PREFIX)coreutils $(PROG_PREFIX)$(prog) &&) :
$(if $(findstring test,$(INSTALLEES)), cd $(INSTALLDIR_BIN) && ln -fs $(PROG_PREFIX)coreutils $(PROG_PREFIX)[)
cat $(DOCSDIR)/_build/man/coreutils.1 | gzip > $(INSTALLDIR_MAN)/$(PROG_PREFIX)coreutils.1.gz
else
$(foreach prog, $(INSTALLEES), \
$(INSTALL) $(BUILDDIR)/$(prog) $(INSTALLDIR_BIN)/$(PROG_PREFIX)$(prog);)
$(if $(findstring test,$(INSTALLEES)), $(INSTALL) $(BUILDDIR)/test $(INSTALLDIR_BIN)/$(PROG_PREFIX)[)
endif
$(foreach man, $(filter $(INSTALLEES), $(basename $(notdir $(wildcard $(DOCSDIR)/_build/man/*)))), \
cat $(DOCSDIR)/_build/man/$(man).1 | gzip > $(INSTALLDIR_MAN)/$(PROG_PREFIX)$(man).1.gz &&) :
mkdir -p $(DESTDIR)$(PREFIX)/share/zsh/site-functions
mkdir -p $(DESTDIR)$(PREFIX)/share/bash-completion/completions
mkdir -p $(DESTDIR)$(PREFIX)/share/fish/vendor_completions.d
Expand All @@ -359,4 +353,4 @@ endif
rm -f $(addprefix $(DESTDIR)$(PREFIX)/share/fish/vendor_completions.d/$(PROG_PREFIX),$(addsuffix .fish,$(PROGS)))
rm -f $(addprefix $(INSTALLDIR_MAN)/$(PROG_PREFIX),$(addsuffix .1.gz,$(PROGS)))

.PHONY: all build build-coreutils build-pkgs build-docs test distclean clean busytest install uninstall
.PHONY: all build build-coreutils build-pkgs test distclean clean busytest install uninstall
2 changes: 2 additions & 0 deletions docs/.gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
book
src/utils
28 changes: 0 additions & 28 deletions docs/arch.rst

This file was deleted.

9 changes: 9 additions & 0 deletions docs/book.toml
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
[book]
authors = ["uutils contributors"]
language = "en"
multilingual = false
src = "src"
title = "uutils Documentation"

[output.html]
git-repository-url = "https:/rust-lang/cargo/tree/master/src/doc/src"
12 changes: 12 additions & 0 deletions docs/create_docs.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
# Simple script to create the correct SUMMARY.md and other files
# for the mdbook documentation.
# Note: This will overwrite the existing files!

import os

with open('src/SUMMARY.md', 'w') as summary:
summary.write("# Summary\n\n")
summary.write("[Introduction](index.md)\n")
summary.write("* [Contributing](contributing.md)\n")
for d in sorted(os.listdir('../src/uu')):
summary.write(f"* [{d}](utils/{d}.md)\n")
24 changes: 0 additions & 24 deletions docs/index.rst

This file was deleted.

108 changes: 108 additions & 0 deletions docs/src/SUMMARY.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,108 @@
# Summary

[Introduction](index.md)
* [Installation](installation.md)
* [Contributing](contributing.md)

# Reference
* [Multi-call binary](multicall.md)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this list could be generated too, no ? :)
sorry to be a pain but i hate long static list :)

* [arch](utils/arch.md)
* [base32](utils/base32.md)
* [base64](utils/base64.md)
* [basename](utils/basename.md)
* [basenc](utils/basenc.md)
* [cat](utils/cat.md)
* [chcon](utils/chcon.md)
* [chgrp](utils/chgrp.md)
* [chmod](utils/chmod.md)
* [chown](utils/chown.md)
* [chroot](utils/chroot.md)
* [cksum](utils/cksum.md)
* [comm](utils/comm.md)
* [cp](utils/cp.md)
* [csplit](utils/csplit.md)
* [cut](utils/cut.md)
* [date](utils/date.md)
* [dd](utils/dd.md)
* [df](utils/df.md)
* [dircolors](utils/dircolors.md)
* [dirname](utils/dirname.md)
* [du](utils/du.md)
* [echo](utils/echo.md)
* [env](utils/env.md)
* [expand](utils/expand.md)
* [expr](utils/expr.md)
* [factor](utils/factor.md)
* [false](utils/false.md)
* [fmt](utils/fmt.md)
* [fold](utils/fold.md)
* [groups](utils/groups.md)
* [hashsum](utils/hashsum.md)
* [head](utils/head.md)
* [hostid](utils/hostid.md)
* [hostname](utils/hostname.md)
* [id](utils/id.md)
* [install](utils/install.md)
* [join](utils/join.md)
* [kill](utils/kill.md)
* [link](utils/link.md)
* [ln](utils/ln.md)
* [logname](utils/logname.md)
* [ls](utils/ls.md)
* [mkdir](utils/mkdir.md)
* [mkfifo](utils/mkfifo.md)
* [mknod](utils/mknod.md)
* [mktemp](utils/mktemp.md)
* [more](utils/more.md)
* [mv](utils/mv.md)
* [nice](utils/nice.md)
* [nl](utils/nl.md)
* [nohup](utils/nohup.md)
* [nproc](utils/nproc.md)
* [numfmt](utils/numfmt.md)
* [od](utils/od.md)
* [paste](utils/paste.md)
* [pathchk](utils/pathchk.md)
* [pinky](utils/pinky.md)
* [pr](utils/pr.md)
* [printenv](utils/printenv.md)
* [printf](utils/printf.md)
* [ptx](utils/ptx.md)
* [pwd](utils/pwd.md)
* [readlink](utils/readlink.md)
* [realpath](utils/realpath.md)
* [relpath](utils/relpath.md)
* [rm](utils/rm.md)
* [rmdir](utils/rmdir.md)
* [runcon](utils/runcon.md)
* [seq](utils/seq.md)
* [shred](utils/shred.md)
* [shuf](utils/shuf.md)
* [sleep](utils/sleep.md)
* [sort](utils/sort.md)
* [split](utils/split.md)
* [stat](utils/stat.md)
* [stdbuf](utils/stdbuf.md)
* [sum](utils/sum.md)
* [sync](utils/sync.md)
* [tac](utils/tac.md)
* [tail](utils/tail.md)
* [tee](utils/tee.md)
* [test](utils/test.md)
* [timeout](utils/timeout.md)
* [touch](utils/touch.md)
* [tr](utils/tr.md)
* [true](utils/true.md)
* [truncate](utils/truncate.md)
* [tsort](utils/tsort.md)
* [tty](utils/tty.md)
* [uname](utils/uname.md)
* [unexpand](utils/unexpand.md)
* [uniq](utils/uniq.md)
* [unlink](utils/unlink.md)
* [uptime](utils/uptime.md)
* [users](utils/users.md)
* [wc](utils/wc.md)
* [who](utils/who.md)
* [whoami](utils/whoami.md)
* [yes](utils/yes.md)
1 change: 1 addition & 0 deletions docs/src/contributing.md
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
{{ #include ../../CONTRIBUTING.md }}
20 changes: 20 additions & 0 deletions docs/src/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
# uutils Coreutils Documentation

uutils is an attempt at writing universal (as in cross-platform) CLI
utilities in [Rust](https://www.rust-lang.org). It is available for
Linux, Windows, Mac and other platforms.

The API reference for `uucore`, the library of functions shared between
various utils, is hosted at at
[docs.rs](https://docs.rs/uucore/0.0.12/uucore/).
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
[docs.rs](https://docs.rs/uucore/0.0.12/uucore/).
[docs.rs](https://docs.rs/uucore/latest/uucore/).


uutils is licensed under the [MIT License](https:/uutils/coreutils/LICENSE.md).

## Useful links
* [Releases](https:/uutils/coreutils/releases)
* [Source Code](https:/uutils/coreutils)
* [Issues](https:/uutils/coreutils/issues)
* [Discord](https://discord.gg/wQVJbvJ)

> Note: This manual is automatically generated from the source code and is
> a work in progress.
Loading