Skip to content

Commit dc4bbdf

Browse files
committed
Fix formatting in undoing-early-speaker-hacks
The new doc system needs an empty line before bulleted or numbered lists.
1 parent e8fab17 commit dc4bbdf

1 file changed

Lines changed: 8 additions & 6 deletions

File tree

docs/sw/undoing-early-speaker-hacks.md

Lines changed: 8 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Undoing Early Speaker Hacks
33
---
44

5-
### Introduction
5+
# Introduction
66
You are probably here because you tried to enable your speakers early, and a change in config
77
between when you did this and the public release of speaker support broke something. You were
88
warned.
@@ -11,8 +11,9 @@ Below are some fixes for common early adopter hacks. Please try _all_ of them be
1111
Your bug will be ignored if we find that you have failed to rectify any of the issues
1212
below.
1313

14-
### The Pro Audio profile is/was enabled for the internal speakers / headphones
14+
# The Pro Audio profile is/was enabled for the internal speakers / headphones
1515
This one can happen in one of three ways:
16+
1617
* You have changed the profile while headphones were plugged in
1718
* You have been using a very, very, _very_ old version of `asahi-audio`
1819
* You have circumvented Wireplumber node permissions to experiment with device profiles
@@ -24,11 +25,12 @@ In doubt delete WirePlumber's sstate directory (`rm -rf ~/.local/state/wireplumb
2425
and reboot.
2526

2627
The fix in the two other cases is the the same:
28+
2729
1. `rm -rf ~/.local/state/wireplumber/`
2830
2. Reinstall `asahi-audio`, Pipewire _and_ Wireplumber
2931
3. Reboot your machine
3032

31-
### You have files in /etc/ from a prerelease version of asahi-audio
33+
# You have files in /etc/ from a prerelease version of asahi-audio
3234
Very old versions of `asahi-audio` stored their configuration inside `/etc/pipewire/` and
3335
`/etc/wireplumber/`. There should be nothing Asahi related in _either_ of these directories
3436
or any of their subdirectories. To fix this:
@@ -41,7 +43,7 @@ rm -rf /etc/pipewire/pipewire.conf.d/*asahi*
4143
Once you have done this, reinstall `asahi-audio`, Pipewire _and_ Wireplumber then reboot
4244
your system.
4345

44-
### You have files in /usr/share/ from a prerelease version of asahi-audio
46+
# You have files in /usr/share/ from a prerelease version of asahi-audio
4547
Prerelease versions of `asahi-audio` had files in `/usr/share/` that do not match the ones
4648
that shipped with 1.0. These files can conflict with the release versions, causing issues.
4749
You must manually remove all `asahi-audio` files:
@@ -55,11 +57,11 @@ rm -rf /usr/share/pipewire/pipewire.conf.d/*asahi*
5557
Once you have done this, reinstall `asahi-audio`, Pipewire _and_ Wireplumber then reboot
5658
your system.
5759

58-
### You have tried to manually circumvent our kernel-level safety controls
60+
# You have tried to manually circumvent our kernel-level safety controls
5961
Remove `snd_soc_macaudio.please_blow_up_my_speakers` from wherever you added it. This could be
6062
the default kernel command line, `modprobe.d`, or somewhere else. Reboot when this is done.
6163

62-
### Required speaker codec settings are not being applied
64+
# Required speaker codec settings are not being applied
6365
This can happen if you are on an old kernel, or you have manually set `snd_soc_tas2764.apple_quirks`
6466
to some nonstandard value. As above, remove any reference to this module parameter, update your kernel,
6567
then reboot.

0 commit comments

Comments
 (0)