tighten markup

2 files changed, 57 insertions, 29 deletions

diff --git a/ADMIN.md b/ADMIN.md
index cd2bb3e..c20205b 100644
--- a/ADMIN.md
+++ b/ADMIN.md
@@ -10,26 +10,33 @@
 
 ## System upgrade
 
-Make sure your current system is up-to-date:
+Make sure your current system is up-to-date.  
+Check </etc/apt/sources.list*> files that only current release is used.
+Then update and upgrade:
 
-  * Check /etc/apt/sources.list* files that only current release is used.
-  * Update and upgrade:
+```shell
+apt update
+apt upgrade
+```
 
-	apt update; apt upgrade
+Make sure that all auto-installed packages are marked as such.  
+Start aptitude in fullscreen mode:
 
-Make sure that all auto-installed packages are marked as such:
+```shell
+aptitude -u
+```
 
-  * Start aptitude in fullscreen mode:
-
-	aptitude -u
+In aptitude...:
 
   * Check each installed package: Flag as auto-installed as appropriate
   * Remove no longer used packages as needed (press "g" twice).
 
-Double-check packages unneeded for or alien to current release:
-
-  * Compute package lists:
+Double-check packages unneeded for or alien to current release.  
+Compute package lists:
 
-	localbackuppkglists
+```shell
+localbackuppkglists
+```
 
-  * locate and inspect aliens and explicits below /etc/*/localpkglists.*
+After running the above,
+locate and inspect aliens and explicits below </etc/*/localpkglists.*>.
diff --git a/DEVELOP.md b/DEVELOP.md
index cd2a59f..047adb2 100644
--- a/DEVELOP.md
+++ b/DEVELOP.md
@@ -2,13 +2,15 @@
 
 ## Create build environment
 
-	localcowbuilder-create jessie
-
+```shell
+localcowbuilder-create jessie
+```
 
 ## Refresh build environment
 
-	localcowbuilder-update jessie
-
+```shell
+localcowbuilder-update jessie
+```
 
 ## Build package
 
@@ -16,45 +18,64 @@ Minimal steps involved in building a new package:
 
 Refresh copyright file:
 
-	debian/rules pre-build DEB_MAINTAINER_MODE=1; debian/rules clean DEB_MAINTAINER_MODE=1
+```shell
+DEB_MAINTAINER_MODE=1 debian/rules pre-build
+DEB_MAINTAINER_MODE=1 debian/rules clean
+```
 
 Resolve changelog from git commits:
 
-	gbp dch -a
+```shell
+gbp dch -a
+```
 
 Finalize changelog
 (manually merge/drop items to reflect only product):
 
-	dch -r
+```shell
+dch -r
+```
 
 Build in clean chroot and tag as final:
 
-	localgitcowdebuild sid --git-tag
+```shell
+localgitcowdebuild sid --git-tag
+```
 
 Compare built binaries against previous ones
 (in MC shell):
 
-	debdiff --controlfiles ALL --wl %f %D/%F | less
+```shell
+debdiff --controlfiles ALL --wl %f %D/%F | less
+```
 
 Check lintian warnings/errors:
 
-	lintian *.changes
+```shell
+lintian *.changes
+```
 
 Rebuild source-only package
 (to save bandwidth uploading, and for official rebuild):
 
-	localgitcowdebuild sid -S
+```shell
+localgitcowdebuild sid -S
+```
 
 Sign and upload:
 
-	debsign %f && dput %f
-
+```shell
+debsign %f && dput %f
+```
 
 ## Backport package for main architecture
 
-	localcowdebuild jessie -sa
-
+```shell
+localcowdebuild jessie -sa
+```
 
 ## Backport package for secondary architecture
 
-	localcowdebuild jessie-ia32 -b
+```shell
+localcowdebuild jessie-ia32 -b
+```