Skip to content
This repository has been archived by the owner on Dec 21, 2023. It is now read-only.

FAQ usability rewrite. #116

Closed
wants to merge 25 commits into from
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
25 commits
Select commit Hold shift + click to select a range
bc57999
Start rewrite of Windows FAQ
jamesbt365 Aug 24, 2023
fd2f7d3
Add "new" title names
jamesbt365 Aug 24, 2023
18bda0f
Add FAQ entry for common cursor problems
jamesbt365 Aug 24, 2023
522653a
add remaining Windows FAQ entries
jamesbt365 Aug 24, 2023
3ab8bd6
Post installation instructions for Windows and Mac
jamesbt365 Aug 24, 2023
c58c73c
Several grammar fixes, addition of commas, and some elaboration.
jamesbt365 Aug 26, 2023
46f94b4
clarity fix
jamesbt365 Aug 26, 2023
7b05e95
Start Linux FAQ rewrite
jamesbt365 Aug 26, 2023
1547c39
tweak linux faq
jamesbt365 Oct 2, 2023
fcba26b
contents layout change
jamesbt365 Oct 2, 2023
21dc316
Further documentation on artist mode
jamesbt365 Oct 2, 2023
02356d8
Add non-systemd & convert_to_portable.bat docs
jamesbt365 Oct 2, 2023
6c708ca
Modify EACCES & ENO* errors
jamesbt365 Oct 3, 2023
8e3027d
Simplify systemd autostart
jamesbt365 Oct 3, 2023
2c17e90
Convert Linux FAQ to Markdown
gonX Oct 8, 2023
20d4b02
linux faq: adjust hid_uclogic reference spacing
gonX Oct 8, 2023
12689f5
linux FAQ: add missing class
gonX Oct 8, 2023
6eaa160
Merge pull request #1 from gonX/rewrite-faq
jamesbt365 Oct 8, 2023
5557b87
mirror changes to Windows FAQ & merge suggestions
jamesbt365 Oct 8, 2023
00553fb
Mention switching to debug mode in OTD.UX Console
jamesbt365 Oct 9, 2023
8a0a7d8
Formatting and language review
jamesbt365 Oct 25, 2023
3173fc2
Simplify styling
X9VoiD Oct 26, 2023
364501f
Improve Linux FAQ structuring
X9VoiD Oct 26, 2023
e422eb2
Merge pull request #2 from X9VoiD/rewrite-faq
jamesbt365 Oct 26, 2023
9a3ab41
Fix daemon logs extension and use user unit
jamesbt365 Oct 26, 2023
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
title: Adding Tablet Support
---

#### WIP
23 changes: 23 additions & 0 deletions OpenTabletDriver.Web/Views/Wiki/Documentation/Logs.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@
---
title: Logs
---

### GUI

To view logs, click on the `Console` tab. Optionally, change filter from `Information` to `Debug` for more detailed logs.

To export logs, click `Help` -> `Export diagnostics...` in the top menu bar.

Sometimes OpenTabletDriver crashes hard. This is usually caused by a bug in OpenTabletDriver. Due to the crash, it will be impossible to retrieve the logs from GUI. In this case, you can find a partial log in the following locations:

| OS | Location |
| --- | --- |
| Windows | `%appdata%\OpenTabletDriver\daemon.log` |
| Linux | `~/.local/share/OpenTabletDriver/daemon.log` |
| macOS | `~/Library/Application Support/OpenTabletDriver/daemon.log` |

### Daemon

The output from daemon is the log.

On Linux when running daemon via systemd service, the log for daemon is recorded by systemd. To view the log, run `journalctl --user-unit opentabletdriver.service`.
51 changes: 51 additions & 0 deletions OpenTabletDriver.Web/Views/Wiki/Documentation/UdevRules.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,51 @@
---
title: Udev Rules
---

Make sure that the installed OpenTabletDriver version is at least **0.6.3.0**. If still not working even with the latest version, refer to the instructions below depending on if you installed OpenTabletDriver via:

- [Package manager](#package-manager)
- [Built from source](#built-from-source)

### Package manager

#### Standard FHS distro

Run the following script in bash as root:

```bash
echo "Finding old udev rules..."
for c in /etc/udev/rules.d/9{0,9}-opentabletdriver.rules; do
if [ -f "${c}" ]; then
echo "Deleting ${c}"
rm "${c}"
fi
done

echo "Finding old kernel blacklist rules..."
if [ -f /etc/modprobe.d/blacklist.conf ]; then
echo "Deleting /etc/modprobe.d/blacklist.conf"
rm /etc/modprobe.d/blacklist.conf
done

udevadm control --reload-rules && udevadm trigger
```

> This script cleans up obsolete udev rules and reloads udev.

Then update the initramfs:

| Distro | Command |
| --- | --- |
| Arch Linux | `sudo mkinitcpio -P` |
| Debian/Ubuntu | `sudo update-initramfs -u` |

For other distros, refer to your distro's documentation on how to update the initramfs.

#### Non-standard FHS distro

Refer to your distro's documentation on how to remove udev rules of the name `90-opentabletdriver.rules` or `99-opentabletdriver.rules`.

### Built from source

Make sure you built OpenTabletDriver via [these instructions](https://github.com/OpenTabletDriver/OpenTabletDriver#linux) and extracted the generic binary tarball correctly.
299 changes: 0 additions & 299 deletions OpenTabletDriver.Web/Views/Wiki/FAQ/Linux.cshtml

This file was deleted.

Loading