aboutsummaryrefslogtreecommitdiff
path: root/docs/manual
diff options
context:
space:
mode:
authorAqua-sama <aqua@iserlohn-fortress.net>2018-01-11 14:56:04 +0100
committerAqua-sama <aqua@iserlohn-fortress.net>2018-01-11 14:56:04 +0100
commit1d507d8ac3b7a58ce7b2d30991190556dc9b1f9b (patch)
treec8697a69734d29bbb896149acd207e7001814b01 /docs/manual
parentEditing bookmark items (diff)
downloadsmolbote-1d507d8ac3b7a58ce7b2d30991190556dc9b1f9b.tar.xz
Removed docs (moved to site)
Diffstat (limited to 'docs/manual')
-rw-r--r--docs/manual/Bugs.md17
-rw-r--r--docs/manual/Building.md51
-rw-r--r--docs/manual/Contributing.md92
-rw-r--r--docs/manual/Features.1.0.md32
-rw-r--r--docs/manual/Quickstart.md15
5 files changed, 0 insertions, 207 deletions
diff --git a/docs/manual/Bugs.md b/docs/manual/Bugs.md
deleted file mode 100644
index 8d1b086..0000000
--- a/docs/manual/Bugs.md
+++ /dev/null
@@ -1,17 +0,0 @@
-# Reporting bugs
-
-Please include the following when reporting bugs:
-* Operating system used
-* Version of Qt used, any relevant information if you built it yourself
-* Detailed explanation of the bug:
- * what was done
- * what was expected
- * what happened
-
-An example of a bad bug report is:
-> Something happened, and what I pressed the button it broke.
-
-An exmaple of a good bug report is:
-> When I opened the Page menu and pressed Print to PDF, nothing happened.
-
-Send bug reports to _aqua at iserlohn-fortress.net_.
diff --git a/docs/manual/Building.md b/docs/manual/Building.md
deleted file mode 100644
index 5eee024..0000000
--- a/docs/manual/Building.md
+++ /dev/null
@@ -1,51 +0,0 @@
-# Building
-
-## Dependencies
-
-### Libraries
-- [Qt](https://www.qt.io/)
- - an up-to-date version, even thought the codebase should largely work with Qt 5.7 or later
- - WebEngine
-- [libconfig](https://hyperrealm.github.io/libconfig/)
-
-### Tools
-* A working compiler
- - gcc or clang on Linux
- - msvc on Windows due to QtWebEngine
-* cmake
- - minimal version 3.1.0, but please use something up-to-date
-
-## Compiling
-smolbote follows the generic cmake build template.
-```
-# generate makefile
-cmake -DCMAKE_BUILD_TYPE=Release -G "Unix Makefiles" ../smolbote.git
-# build
-make -j 4
-# install
-make DESTDIR=/install/root/goes/here install
-```
-
-### Using libc++
-You can use libc++ over stdlibc++ by setting UseLibCpp to On. Requires clang.
-> -DCMAKE_CXX_COMPILER=/usr/bin/clang++ -DUseLibCpp=On
-
-## Packaging
-
-### Source Tarball
-```
-# Get source code from the repository
-git archive --format=tar HEAD > head.tar
-# Compress with lzip
-lzip -9 --force --output=head.tar.lz head.tar
-# Generate checksum
-sha512sum --binary head.tar.lz > head.tar.lz.sha512
-```
-
-### makepkg
-A PKGBUILD is provided in linux/makepkg/PKGBUILD. Please read before using.
-
-## Troubleshooting
-
-### Cannot link libconfig
-You don't have pkg-config installed.
diff --git a/docs/manual/Contributing.md b/docs/manual/Contributing.md
deleted file mode 100644
index c6d1bcd..0000000
--- a/docs/manual/Contributing.md
+++ /dev/null
@@ -1,92 +0,0 @@
-# Code style
-
-## Guidelines
-* Use generic formats
-
-## Versioning
-- major version: Changed infrequently and almost entirely out of foppery and whim.
-- minor version: Milestone of multiple features.
-- revision: Major bugfixes and each new feature should get a revision.
-
-## Qt
-* Check pointers with ´´´Q_CHECK_PTR´´´ before using or returning them.
-* Avoid using connect SIGNAL and SLOT. Instead use &Class::method. This way, connects are checked during the compile, not at runtime.
-* Where possible, use QVector over QList: http://lists.qt-project.org/pipermail/development/2017-March/029040.html
-
-## clazy
-You can use [clazy](https://github.com/KDE/clazy) to check Qt semantics.
-Requires clang.
-
-To set check levels, set the CLAZY_CHECKS environment variable to 'level0,level1', etc.
-
-### Setting up in qbs
-1. Create a profile for clazy
-```
-qbs-setup-toolchains --type clang /usr/bin/clazy clazy
-qbs-config profiles.clazy.cpp.cCompilerName clang
-qbs-config profiles.clazy.cpp.cxxCompilerName clazy
-```
-2. Create a profile for qt5-clazy
-```
-qbs-setup-qt /usr/bin/qmake-qt5 qt5-clazy
-qbs-config profiles.qt5-clazy.baseProfile clazy
-```
-
-### Setting up in QtCreator
-The simplest way to set it up is to use _clazy_ instead of _clang_.
-
-1. Go to Tools » Options » Build & Run » Compilers
-2. Clone the clang compiler of your choice
-3. Set _Compiler path_ to _/usr/bin/clazy_
-
-This will update the qbs profile that QtCreator uses.
-
-### Reducing clazy noise
-If you want to suppress warnings from headers of Qt or 3rd party code, include
-them with -isystem instead of -I. To do this, you have to
-[modify your Qt profile](clazy-sysincludes) like this:
-
-Find the profile's search path:
-```sh
-$ qbs config --list profiles.qt562.preferences
-profiles.qt562.preferences.qbsSearchPaths: "/home/someone/.config/QtProject/qbs/1.9.0/profiles/qt562"
-```
-
-Replace cpp.includePaths with cpp.systemIncludePaths in the Qt modules of that profile:
-
-```sh
-$ find /home/someone/.config/QtProject/qbs/1.9.0/profiles/qt562/modules/Qt/ -name '*.qbs' | xargs -n1 sed -i s/cpp\.includePaths/cpp.systemIncludePaths/
-```
-
-[clazy-sysincludes]: http://lists.qt-project.org/pipermail/qbs/2017-April/001709.html
-
-# Before you submit
-
-## Licensing
-Smolbote is licensed under GPLv3 _only_. Your code needs to be compatible with
-it, and have a license header in the style used by the project.
-
-### SPDX-License-Identifier
-A full list of license identifiers can be found on [the SPDX website](https://spdx.org/licenses/).
-
-## Style
-Please use the [One True Brace style](https://en.wikipedia.org/wiki/Indent_style#Variant:_1TBS_.28OTBS.29).
-Tabs are 4 spaces.
-
-For ease of use, you can set the following astyle configuration:
-```
---style=otbs
---attach-namespaces
---attach-inlines
---indent=spaces=4
-```
-
-## Format patch for email
-```sh
-git format-patch hash
-```
-where _hash_ is the commit immediately prior to the commit or series of commits
-you want to submit.
-
-Attach the patch file and email it to _aqua at iserlohn-fortress.net_. If
-possible, GPG sign the email.
diff --git a/docs/manual/Features.1.0.md b/docs/manual/Features.1.0.md
deleted file mode 100644
index 59348d3..0000000
--- a/docs/manual/Features.1.0.md
+++ /dev/null
@@ -1,32 +0,0 @@
-# Version 1.0
-* Profiles
- - Application-level profile manager
- - System-level and user-level profile config, with per-profile overrides [todo]
-* Configuration
- - Default system-level config and user-level overrides [todo]
-* Cookies
- - Filter list similar to the URL filter list [todo]
-* Tabs
- - Moving tabs between windows [todo]
- - Tab context menu [todo]
-* Page actions
- - Search [todo]
- - Zoom [todo]
- - Print [todo]
-* Navigation toolbar
- - Back and Forward history [todo]
-
-## Components
-Components should, when possible, be split off into self-contained static
-libraries. This is to reduce recompile times.
-
-### Navigation
-Includes the Address bar (URLLineEdit).
-
-### Bookmarks
-
-- [TODO] Bookmark location should be read from profile, with a default in the config
-- [TODO] Split off xbel implementation into a library
-- [TODO] BookmarksLibrary API
-
-### Downloads
diff --git a/docs/manual/Quickstart.md b/docs/manual/Quickstart.md
deleted file mode 100644
index b8dcaa1..0000000
--- a/docs/manual/Quickstart.md
+++ /dev/null
@@ -1,15 +0,0 @@
-# Quickstart
-
-## Installing and running
-
-### Linux
-
-### Windows
-Grab a package from (not yet available url).
-
-## Configuration files
-On first run, smolbote will create its basic configuration:
-- on Linux, in _~/.config/smolbote_
-- on Windows, in
-
-## Troubleshooting