From 0b431c80fed43cadb7be838e790bd565b9d55f0b Mon Sep 17 00:00:00 2001 From: Luke Shumaker Date: Mon, 25 May 2015 14:34:25 -0600 Subject: doc/: Two spaces between sentences, wrap to 80 columns. --- doc/workflows.md | 36 +++++++++++++++++++----------------- 1 file changed, 19 insertions(+), 17 deletions(-) (limited to 'doc/workflows.md') diff --git a/doc/workflows.md b/doc/workflows.md index fe3c12e..9a8c1a6 100644 --- a/doc/workflows.md +++ b/doc/workflows.md @@ -5,31 +5,34 @@ Describe your packaging workflow here! ## fauno's way -During packaging, I don't usually restart a build from scratch if I have to -make changes to the PKGBUILD. I use a lot of commenting out commands already -ran, `makepkg -R`, etc. When I used `libremakepkg` I ended up using a lot more +During packaging, I don't usually restart a build from scratch if I have to make +changes to the PKGBUILD. I use a lot of commenting out commands already ran, +`makepkg -R`, etc. When I used `libremakepkg` I ended up using a lot more `librechroot` and working from inside the unconfigured chroot, because `makechrootpkg` (the underlying technology for `libremakepkg`) tries to be too smart. When I started writing `treepkg` I found that mounting what I need directly on the chroot and working from inside it was much more comfortable and simple than -having a makepkg wrapper doing funny stuff (for instance, mangling makepkg.conf -and breaking everything.) +having a makepkg wrapper doing funny stuff (for instance, mangling +`makepkg.conf` and breaking everything.) This is how the chroot is configured: -* Create the same user (with same uid) on the chroot that the one I use regularly. +* Create the same user (with same uid) on the chroot that the one I use + regularly. * Give it password-less sudo on the chroot. -* Bind mount /home to /chroot/home, where I have the abslibre-mips64el clone. +* Bind mount `/home` to `/chroot/home`, where I have the abslibre-mips64el + clone. -* Bind mount /var/cache/pacman/pkg to /chroot/var/cache/pacman/pkg +* Bind mount `/var/cache/pacman/pkg` to `/chroot/var/cache/pacman/pkg` -* Put these on system's fstab so I don't have to do it everytime +* Put these on system's `fstab` so I don't have to do it everytime -* Configure makepkg.conf to PKGDEST=CacheDir and SRCDEST to something on my home. +* Configure `makepkg.conf` to `PKGDEST=CacheDir` and `SRCDEST` to something on + my home. Workflow: @@ -38,15 +41,14 @@ Workflow: * From another shell (I use tmux) edit the abslibre or search for updates with `git log --no-merges --numstat`. -* Pick a package and run `treepkg` from its dir on the chroot, or retake - a build with `treepkg /tmp/package-treepkg-xxxx`. (Refer to doc/treepkg - here). +* Pick a package and run `treepkg` from its dir on the chroot, or retake a build + with `treepkg /tmp/package-treepkg-xxxx`. (Refer to `doc/treepkg` here). What this allows: -* Not having to worry about the state of the chroot. `chcleanup` removes and - adds packages in a smart way so shared dependencies stay and others move - along (think of installing and removing qt for a complete kde rebuild). +* Not having to worry about the state of the chroot. `chcleanup` removes and + adds packages in a smart way so shared dependencies stay and others move along + (think of installing and removing qt for a complete kde rebuild). * Building many packages in a row without recreating a chroot for every one of them. @@ -54,7 +56,7 @@ What this allows: * Knowing that any change you made to the chroot stays as you want (no one touches your makepkg.conf) -* Hability to run regular commands, not through a chroot wrapper. I can `cd` to +* Hability to run regular commands, not through a chroot wrapper. I can `cd` to a dir and use `makepkg -whatever` on it and nothing breaks. * No extra code spent on wrappers. -- cgit v1.2.3-54-g00ecf