Fix 404 Links in the Docs

Initial test with test.pypi.org was successful

.github/workflows/docs.yml

@@ -2,7 +2,7 @@ on:
   workflow_dispatch:
   push:
     branches:
-      - mttbernardini/chore/modern-packaging
+      - main
 
 concurrency:
   group: "pages"

.github/workflows/release.yml

@@ -42,8 +42,7 @@ jobs:
   upload_pypi:
     needs: [build_wheels, build_sdist]
     runs-on: ubuntu-latest
-    # TODO: set environment back to pypi after testing
+    environment: pypi
-    environment: testpypi
     permissions:
       id-token: write
     steps:
@@ -54,6 +53,3 @@ jobs:
           path: dist
           merge-multiple: true
       - uses: pypa/gh-action-pypi-publish@release/v1
-        # TODO: delete below once workflow is proved functional
-        with:
-          repository-url: https://test.pypi.org/legacy/

README.md

@@ -2,7 +2,7 @@
 
 For documentation, see http://larsimmisch.github.io/pyalsaaudio/
 
-> Author: Casper Wilstrup (cwi@aves.dk)
+> Author: Casper Wilstrup (cwi@aves.dk)  
 > Maintainer: Lars Immisch (lars@ibp.de)
 
 This package contains wrappers for accessing the
@@ -46,14 +46,9 @@ First, get the sources and change to the source directory:
   $ cd pyalsaaudio
 ```
 
-Then, build:
+Then, build and install:
 ```
-  $ python setup.py build
+  $ pip install .
-```
-
-And install:
-```
-  $ sudo python setup.py install
 ```
 
 # Using the API
@@ -62,8 +57,8 @@ distribution; it is also online on [http://larsimmisch.github.io/pyalsaaudio/](h
 
 There are some example programs included with the source:
 
-* [playwav.py](https://github.com/larsimmisch/pyalsaaudio/blob/master/playwav.py) plays back a wav file
+* [playwav.py](./examples/playwav.py) plays back a wav file
-* [playbacktest.py](https://github.com/larsimmisch/pyalsaaudio/blob/master/playbacktest.py) plays back raw sound data read from stdin
+* [playbacktest.py](./examples/playbacktest.py) plays back raw sound data read from stdin
-* [recordtest.py](https://github.com/larsimmisch/pyalsaaudio/blob/master/recordtest.py) captures sound from the microphone and writes
+* [recordtest.py](./examples/recordtest.py) captures sound from the microphone and writes
 it raw to stdout.
-* [mixertest.py](https://github.com/larsimmisch/pyalsaaudio/blob/master/mixertest.py) can be used to manipulate the mixers.
+* [mixertest.py](./examples/mixertest.py) can be used to manipulate the mixers.

doc/README.md

@@ -1,28 +1,18 @@
 # Make a new release
 
-Update the version in setup.py
+Create and push a tag naming the version (i.e. 0.11.1):
 
-    pyalsa_version = '0.9.0'
+    git tag 0.11.1
+    git push origin 0.11.1
 
-Commit and push the update.
+This should trigger a build via a github actions and publish pre-built binaries to pypi.org 
-
-Create and push a tag naming the version (i.e. 0.9.0):
-
-    git tag 0.9.0
-    git push origin 0.9.0
-
-Create the package:
-
-    python3 setup.py sdist
-
-Upload the package
-
-    twine upload dist/*
-
-Don't forget to update the documentation.
 
 # Publish the documentation
 
+All commits to main should trigger a rebuild of the documentation.
+
+## Historical background
+
 The documentation is published through the `gh-pages` branch.
 
 To publish the documentation, you need to clone the `gh-pages` branch of this repository into

doc/libalsaaudio.rst

@@ -807,9 +807,6 @@ Play back the recording with::
 
    $ python playbacktest.py <filename>
 
-playbacktest.py accepts the commandline option
- *-d <device>*.
-
 mixertest.py
 ~~~~~~~~~~~~
 

doc/pyalsaaudio.rst

@@ -77,7 +77,7 @@ Note: the wrappers link with the alsasound library (from the alsa-lib package)
 and need the ALSA headers for compilation.  Verify that you have
 /usr/lib/libasound.so and /usr/include/alsa (or similar paths) before building.
 
-*On Debian/Ubuntu, install libasound2-dev.*
+*On Debian (and probably Ubuntu), install libasound2-dev.*
 
 Naturally you also need to use a kernel with proper ALSA support. This is the
 default in Linux kernel 2.6 and later. If you are using kernel version 2.4 you
@@ -86,11 +86,7 @@ ship with ALSA kernels.
 
 To install, execute the following:  ---   ::
 
-   $ python setup.py build
+   $ pip install .
-
-And then as root:  ---   ::
-
-   # python setup.py install
 
 
 *******