From f8cfa1fbcdd31d1279d12c394bc5eee420aa08b1 Mon Sep 17 00:00:00 2001
From: Alessandro Mauri <alemauri001@gmail.com>
Date: Sun, 20 Sep 2020 23:48:32 +0200
Subject: [PATCH] lots of changes

- moved alsa guide to own subfolder
- changed header links to be global
- changed footer to give credit for gruvbox
---
 src/_footer.html                  |  4 ++++
 src/_header.html                  |  4 ++--
 src/{alsadoc.md => alsa/part1.md} | 26 ++++++++++++++++++++++++--
 src/alsa/part2.md                 | 20 ++++++++++++++++++++
 4 files changed, 50 insertions(+), 4 deletions(-)
 rename src/{alsadoc.md => alsa/part1.md} (89%)
 create mode 100644 src/alsa/part2.md

diff --git a/src/_footer.html b/src/_footer.html
index 7788702..05d9665 100644
--- a/src/_footer.html
+++ b/src/_footer.html
@@ -7,3 +7,7 @@
 	<a href="https://creativecommons.org/publicdomain/zero/1.0/">
 	Creative Commons CC0 Public Domain Dedication</a>
 </p>
+<p>
+	Special thanks to <a href="https://github.com/morhetz">Pavel Pertsev</a>
+	for creating <a href="https://github.com/morhetz/gruvbox">Gruvbox</a>
+</p>
diff --git a/src/_header.html b/src/_header.html
index b6d4d76..142556a 100644
--- a/src/_header.html
+++ b/src/_header.html
@@ -1,8 +1,8 @@
-<link rel="stylesheet" href="styles.css">
+<link rel="stylesheet" href="//alemauri.eu/styles.css">
 
 <div class="header">
 	<div id="thumb-container">
-		<img src="img/me.jpg" alt="me" id="thumb">
+		<img src="//alemauri.eu/img/me.jpg" alt="me" id="thumb">
 	</div>
 	<div id="links">
 		<a href="./">Home</a>
diff --git a/src/alsadoc.md b/src/alsa/part1.md
similarity index 89%
rename from src/alsadoc.md
rename to src/alsa/part1.md
index 0c7c513..4b9beb0 100644
--- a/src/alsadoc.md
+++ b/src/alsa/part1.md
@@ -1,4 +1,4 @@
-Title: Unofficial ALSA API documentation
+Title: Unofficial ALSA API documentation part 1
 Author: Alessandro Mauri
 
 # Unofficial ALSA API documentation
@@ -11,11 +11,18 @@ Official links:
 
 * ALSA documentation [main page](https://www.alsa-project.org/alsa-doc/alsa-lib/index.html)
 	- The [PCM interface](https://www.alsa-project.org/alsa-doc/alsa-lib/pcm.html)
-
+	- [PCM plugins](https://www.alsa-project.org/alsa-doc/alsa-lib/pcm_plugins.html)
+		* [PCM external plugins SDK](https://www.alsa-project.org/alsa-doc/alsa-lib/pcm_external_plugins.html)
+	- [Device names](https://alsa-project.org/wiki/DeviceNames)
+	- [Resampler](https://alsa-project.org/wiki/ALSAresampler)
+	- [Frames periods](https://alsa-project.org/wiki/FramesPeriods)
+	- [Topology](https://alsa-project.org/wiki/ALSA_topology)
 
 Unofficial links:
 
 * [Userspace documentaion](https://alsa.opensrc.org/)
+* [A close look at ALSA](https://www.volkerschatz.com/noise/alsa.html)
+* ST's (the microchip company) [general look at ALSA](https://wiki.st.com/stm32mpu/wiki/ALSA_overview)
 
 ## Functions
 All the functions I encountered and some documentation / explanation
@@ -273,3 +280,18 @@ ARGS:
 RESULT: RETURN: `(int)` 0 on success or negative code on error
 
 #### `snd_pcm_nonblock`
+Change the nonblocking mode on opened PCMs
+
+```c
+int snd_pcm_nonblock (snd_pcm_t *pcm, int nonblock);
+```
+
+ARGS:
+
+* `(snd_pcm_t *)pcm`: the PCM handle to modify
+* `(int)nonblock`: nonblock mode
+	- 0: block
+	- 1: nonblock
+	- 2: abort
+
+RESULT: RETURN: `(int)` 0 on success or negative code on error
diff --git a/src/alsa/part2.md b/src/alsa/part2.md
new file mode 100644
index 0000000..d264c5a
--- /dev/null
+++ b/src/alsa/part2.md
@@ -0,0 +1,20 @@
+Title: Unofficial ALSA API documentation part 2
+Author: Alessandro Mauri
+
+# Examples, examples, examples
+If there's one thing I love is examples, they are often minimal and not very 
+explicative, moreover multiple examples on the same subject are never the same.
+That said, if you need to reverse-engineer something examples are (most of the
+times)your only resource.
+
+Here's some categorized examples about ALSA:
+
+## The PCM interface
+
+* some [dwm bar](https://github.com/kamiyaa/dwmstatus/tree/master/src) that
+has some good simple code
+
+## Configuration files
+
+* [volh](https://gist.github.com/volh/4587051): play through internal and
+external sound cards, whatever that means