From 34b5bcf4e707cbcf49d65bfe2b46309c2125ad29 Mon Sep 17 00:00:00 2001 From: probonopd Date: Wed, 25 Nov 2020 21:56:00 +0100 Subject: [PATCH 001/592] if: "!contains(github.event.head_commit.message, 'ci skip')" [ci skip] --- .github/workflows/main.yml | 1 + 1 file changed, 1 insertion(+) diff --git a/.github/workflows/main.yml b/.github/workflows/main.yml index e912de43..436827a0 100644 --- a/.github/workflows/main.yml +++ b/.github/workflows/main.yml @@ -17,6 +17,7 @@ on: jobs: # This workflow contains a single job called "build" build: + if: "!contains(github.event.head_commit.message, 'ci skip')" # The type of runner that the job will run on runs-on: ubuntu-latest env: From 52fbbf4329c111813219f967439eeb8f3b9c461c Mon Sep 17 00:00:00 2001 From: probonopd Date: Wed, 25 Nov 2020 22:06:09 +0100 Subject: [PATCH 002/592] Update index.md --- index.md | 58 +++++++++++++++++++++++++++++++++++++++++++++++++++----- 1 file changed, 53 insertions(+), 5 deletions(-) diff --git a/index.md b/index.md index a47a9212..12f81d8d 100644 --- a/index.md +++ b/index.md @@ -1,7 +1,55 @@ -# Hello world +# hello -Text +__hello__ (also known as __helloSystem__) is a desktop system for creators with focus on simplicity, elegance, and usability. Its design follows the "Less, but better" philosophy. It is intended as a system for "mere mortals", welcoming to switchers from the Mac. [FreeBSD](https://www.freebsd.org/) is used as the core operating system. Please refer to https://github.com/helloSystem/hello if you would like to learn more about the ideas and principles behind hello. -``` -Code -``` +## Status + +hello is currently being developed. It is not yet available for general use, but advanced users can try out continuous builds of pre-alpha ISO images that can be booted from DVD or USB storage media. + +## System requirements + +* 2 GHz dual core Intel/ARM 64-bit processor +* 4 GiB RAM (system memory for physical and viritualized installs) +* VGA capable of 1024x768 screen resolution +* Either a CD/DVD drive or a USB port for booting the installer media + +In the future, there may also be builds for other processor architectures. We would like to bring down the RAM requirement considerably. + +### Tested hardware + +hello is known to boot to a graphical desktop on the following machines. Auxiliary functionality such as wireless networking, sound over HDMI, sleep, graphics acceleration, etc. has not yet been tested systematically. + +* Acer Revo RL85 +* Dell Inc. OptiPlex 780 + +### Tested virtualization environments + +* VirtualBox host (on FreeBSD) +* VMware host (on Windows) + +## Download + +Continuous builds of pre-alpha ISO images are available for download at https://github.com/helloSystem/ISO/releases/tag/continuous-hello. Note that these get built automatically whenever source code is committed to that repository. Not every build is tested. + +## Troubleshooting + +* __Boot stalls during `Replicate system image to swap-based memdisk`__: This build of the ISO is damaged. Please wait for another continuous build to appear and try again. +* __Boots to a non-graphical `login:` prompt__: Your grahpics hardware was not detected properly. Please try on another machine. + +## Reporting bugs + +Please search https://github.com/helloSystem/ISO/issues for known issues. Feel free to add to existing issues or to open new issues there. + +## Discussing ideas and wishlist items + +Please check https://github.com/helloSystem/hello fist, including the wiki at https://github.com/helloSystem/hello/wiki. Feel free to discuss ideas and wishlist items at https://github.com/helloSystem/hello/issues, but please do keep in mind that in order to achieve the intended goal of simplicity, the team needs to say "no" to most wishlist items that do not further that goal. + +## Contributing + +This project lives from contributions by people like you. + +Here is what we need help with: [Issues flagged with help-wanted](https://github.com/search?q=org%3AhelloSystem+is%3Aissue+is%3Aopen+label%3A%22help+wanted%22), and of course other contributions are also welcome. + +Maybe you'd like to look into one of these: [Issues flagged with good-first-issue](https://github.com/search?q=org%3AhelloSystem+is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22&type=). + +Please see https://github.com/helloSystem/hello/blob/master/CONTRIBUTING.md for more information. From f93af8380090da69a6d1bd0e66be7a6756f86df7 Mon Sep 17 00:00:00 2001 From: probonopd Date: Wed, 25 Nov 2020 22:06:36 +0100 Subject: [PATCH 003/592] Downloading [ci skip] --- index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.md b/index.md index 12f81d8d..c70e90ab 100644 --- a/index.md +++ b/index.md @@ -27,7 +27,7 @@ hello is known to boot to a graphical desktop on the following machines. Auxilia * VirtualBox host (on FreeBSD) * VMware host (on Windows) -## Download +## Downloading Continuous builds of pre-alpha ISO images are available for download at https://github.com/helloSystem/ISO/releases/tag/continuous-hello. Note that these get built automatically whenever source code is committed to that repository. Not every build is tested. From 47b86317e02fc565da13ed1baf477779e396ba25 Mon Sep 17 00:00:00 2001 From: probonopd Date: Wed, 25 Nov 2020 22:08:32 +0100 Subject: [PATCH 004/592] pre-alpha --- conf.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/conf.py b/conf.py index 1a0f7dfb..1ccb91ba 100644 --- a/conf.py +++ b/conf.py @@ -23,7 +23,7 @@ author = 'probono' # The full version, including alpha/beta/rc tags -release = '0.0.1' +release = 'pre-alpha' # -- General configuration --------------------------------------------------- From c7bcfcc5eb6a18045903762f6d15b44f57602089 Mon Sep 17 00:00:00 2001 From: probonopd Date: Wed, 25 Nov 2020 22:13:04 +0100 Subject: [PATCH 005/592] Update index.md --- index.md | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/index.md b/index.md index c70e90ab..9a1c7a25 100644 --- a/index.md +++ b/index.md @@ -29,7 +29,7 @@ hello is known to boot to a graphical desktop on the following machines. Auxilia ## Downloading -Continuous builds of pre-alpha ISO images are available for download at https://github.com/helloSystem/ISO/releases/tag/continuous-hello. Note that these get built automatically whenever source code is committed to that repository. Not every build is tested. +Continuous builds of pre-alpha ISO images are available for download [here](https://github.com/helloSystem/ISO/releases/tag/continuous-hello). Note that these get built automatically whenever source code is committed to that repository. Not every build is tested. ## Troubleshooting @@ -38,11 +38,11 @@ Continuous builds of pre-alpha ISO images are available for download at https:// ## Reporting bugs -Please search https://github.com/helloSystem/ISO/issues for known issues. Feel free to add to existing issues or to open new issues there. +Please search [https://github.com/helloSystem/ISO/issues](https://github.com/helloSystem/ISO/issues) for known issues. Feel free to add to existing issues or to open new issues there. ## Discussing ideas and wishlist items -Please check https://github.com/helloSystem/hello fist, including the wiki at https://github.com/helloSystem/hello/wiki. Feel free to discuss ideas and wishlist items at https://github.com/helloSystem/hello/issues, but please do keep in mind that in order to achieve the intended goal of simplicity, the team needs to say "no" to most wishlist items that do not further that goal. +Please check [https://github.com/helloSystem/hello](https://github.com/helloSystem/hello) fist, including the [wiki](https://github.com/helloSystem/hello/wiki). Feel free to discuss ideas and wishlist items at [https://github.com/helloSystem/hello/issues](https://github.com/helloSystem/hello/issues), but please do keep in mind that in order to achieve the intended goal of simplicity, the team needs to say "no" to most wishlist items that do not further that goal. ## Contributing @@ -52,4 +52,6 @@ Here is what we need help with: [Issues flagged with help-wanted](https://github Maybe you'd like to look into one of these: [Issues flagged with good-first-issue](https://github.com/search?q=org%3AhelloSystem+is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22&type=). -Please see https://github.com/helloSystem/hello/blob/master/CONTRIBUTING.md for more information. +Please see the [CONTRIBUTING.md](https://github.com/helloSystem/hello/blob/master/CONTRIBUTING.md) for more information. + +Developers chat at `#FuryBSD` on `irc.freenode.net`. Since we are working in different timezones, do not expect immediate answers. It is best to stay connected for at least a couple of days or so. From 38caa06361bbfa21128c40018593c18b3528664b Mon Sep 17 00:00:00 2001 From: probonopd Date: Wed, 25 Nov 2020 22:17:26 +0100 Subject: [PATCH 006/592] eval_rst --- index.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/index.md b/index.md index 9a1c7a25..f273c051 100644 --- a/index.md +++ b/index.md @@ -1,5 +1,9 @@ # hello +```eval_rst +.. centered:: Willkommen • Welcome • 欢迎 • Bienvenue • Benvenuto • Bienvenido • ようこそ • Mabuhay • Välkommen • أهلا وسهلا • Добро пожаловать • Merhaba • Bonvenon • 歡迎光臨 +``` + __hello__ (also known as __helloSystem__) is a desktop system for creators with focus on simplicity, elegance, and usability. Its design follows the "Less, but better" philosophy. It is intended as a system for "mere mortals", welcoming to switchers from the Mac. [FreeBSD](https://www.freebsd.org/) is used as the core operating system. Please refer to https://github.com/helloSystem/hello if you would like to learn more about the ideas and principles behind hello. ## Status From 7d1e7862e7552663ba24819e972fa7e9e20cf456 Mon Sep 17 00:00:00 2001 From: probonopd Date: Wed, 25 Nov 2020 22:18:55 +0100 Subject: [PATCH 007/592] important:: --- index.md | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/index.md b/index.md index f273c051..6e9792ab 100644 --- a/index.md +++ b/index.md @@ -33,7 +33,10 @@ hello is known to boot to a graphical desktop on the following machines. Auxilia ## Downloading -Continuous builds of pre-alpha ISO images are available for download [here](https://github.com/helloSystem/ISO/releases/tag/continuous-hello). Note that these get built automatically whenever source code is committed to that repository. Not every build is tested. +Continuous builds of pre-alpha ISO images are available for download [here](https://github.com/helloSystem/ISO/releases/tag/continuous-hello). + +``` important:: Images get built automatically whenever source code is committed. Not every build is tested. +``` ## Troubleshooting From a4f991f59891974c02990573a1fef731f0a13a8e Mon Sep 17 00:00:00 2001 From: probonopd Date: Wed, 25 Nov 2020 22:20:22 +0100 Subject: [PATCH 008/592] Update index.md --- index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.md b/index.md index 6e9792ab..55657f0c 100644 --- a/index.md +++ b/index.md @@ -59,6 +59,6 @@ Here is what we need help with: [Issues flagged with help-wanted](https://github Maybe you'd like to look into one of these: [Issues flagged with good-first-issue](https://github.com/search?q=org%3AhelloSystem+is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22&type=). -Please see the [CONTRIBUTING.md](https://github.com/helloSystem/hello/blob/master/CONTRIBUTING.md) for more information. +Please see the https://github.com/helloSystem/hello/blob/master/CONTRIBUTING.md page for more information. Developers chat at `#FuryBSD` on `irc.freenode.net`. Since we are working in different timezones, do not expect immediate answers. It is best to stay connected for at least a couple of days or so. From 31d8447f76ae9e4149cb3a9dbb5c315ea5227fde Mon Sep 17 00:00:00 2001 From: probonopd Date: Wed, 25 Nov 2020 22:47:36 +0100 Subject: [PATCH 009/592] Create acknowledgements.md --- acknowledgements.md | 58 +++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 58 insertions(+) create mode 100644 acknowledgements.md diff --git a/acknowledgements.md b/acknowledgements.md new file mode 100644 index 00000000..0b453511 --- /dev/null +++ b/acknowledgements.md @@ -0,0 +1,58 @@ +# Acknowledgements + +Grateful acknowledged is made to the following persons and organizations. + +Mentions roughly in the order of first involvement with the project. + +## FreeBSD project +[https://www.freebsd.org/](https://www.freebsd.org/) +* Providing the underlying operating system + +## FreeBSD port maintainers +As listed on [https://www.freshports.org/](https://www.freshports.org/) +* Providing end user applications + +## Simon Peter +__[probonopd](https://github.com/probonopd)__ +@probonopd on twitter +* Founded the project +* Acting as the main developer + +## Joe Maloney +__[pkgdemon](https://github.com/pkgdemon)__ +@FuryBSD on twitter +* Originally wrote the tools to create Live ISOs for FuryBSD + +## FreeBSD Foundation +[https://www.freebsdfoundation.org/](https://www.freebsdfoundation.org/) +* Gave permission to use the trademarks in the 'Install FreeBSD' utility + +## Slawomir Wojciech Wojtczak +__[vermaden](https://github.com/vermaden)__ +@vermaden on twitter +* Provided helpful feedback and configuration advice + +## Reven Martin +__[rekols](https://github.com/rekols)__ +@revenmartin on twitter +* Originally wrote Panda Status Bar, which the hello Menu is based on +* Originally wrote Cyber Dock, which the hello Dock is based on + +## Ale Rimoldi +__[aoloe](https://github.com/aoloe)__ +@a_l_e on twitter +* Implemented Action Search (search through menubar) + +## Antony jr +__[antony-jr](https://github.com/antony-jr)__ +@antonyjr0 on twitter +* Put Search field for Action Search in menubar +* Integrated of 'System' menu into menubar + +## Keshav Bhatt +__[keshavbhatt](https://github.com/keshavbhatt)__ +@keshavmail68 on twitter +* Helped making 'System' menu submenus clickable + +## @FreeBSDHelp on twitter +* Reached out to FreeBSD kernel developers From 32ae54793c418a77bd06dcb88ad0cb99a8c7c383 Mon Sep 17 00:00:00 2001 From: probonopd Date: Wed, 25 Nov 2020 22:49:21 +0100 Subject: [PATCH 010/592] Update index.md --- index.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/index.md b/index.md index 55657f0c..4f705938 100644 --- a/index.md +++ b/index.md @@ -6,6 +6,10 @@ __hello__ (also known as __helloSystem__) is a desktop system for creators with focus on simplicity, elegance, and usability. Its design follows the "Less, but better" philosophy. It is intended as a system for "mere mortals", welcoming to switchers from the Mac. [FreeBSD](https://www.freebsd.org/) is used as the core operating system. Please refer to https://github.com/helloSystem/hello if you would like to learn more about the ideas and principles behind hello. +## Contents + +* [Acknowledgements](acknowledgements.md) + ## Status hello is currently being developed. It is not yet available for general use, but advanced users can try out continuous builds of pre-alpha ISO images that can be booted from DVD or USB storage media. From 5aebf691f1783675bc44f9ff91811a86d8f11bc1 Mon Sep 17 00:00:00 2001 From: probonopd Date: Wed, 25 Nov 2020 22:55:14 +0100 Subject: [PATCH 011/592] Update conf.py --- conf.py | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/conf.py b/conf.py index 1ccb91ba..40daeb85 100644 --- a/conf.py +++ b/conf.py @@ -63,8 +63,8 @@ import os html_context = { 'display_github': True, - 'github_user': os. environ['GITHUB_REPOSITORY'].split("/")[0], - 'github_repo': os. environ['GITHUB_REPOSITORY'].split("/")[1], + 'github_user': os.environ['GITHUB_REPOSITORY'].split("/")[0], + 'github_repo': os.environ['GITHUB_REPOSITORY'].split("/")[1], 'github_version': 'main/', } @@ -73,6 +73,7 @@ # so a file named "default.css" will overwrite the builtin "default.css". html_static_path = ['_static'] +github_doc_root = 'https://github.com/' + os.environ['GITHUB_REPOSITORY'] + '/tree/main/' def setup(app): app.add_config_value('recommonmark_config', { 'url_resolver': lambda url: github_doc_root + url, From 7d305f1ac25da31d8dbf95865e51d1c63fea6fc1 Mon Sep 17 00:00:00 2001 From: probonopd Date: Wed, 25 Nov 2020 23:04:21 +0100 Subject: [PATCH 012/592] Extra '.md' added --- conf.py | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/conf.py b/conf.py index 40daeb85..004161e9 100644 --- a/conf.py +++ b/conf.py @@ -74,9 +74,10 @@ html_static_path = ['_static'] github_doc_root = 'https://github.com/' + os.environ['GITHUB_REPOSITORY'] + '/tree/main/' +# FIXME: Extra '.md' added def setup(app): app.add_config_value('recommonmark_config', { - 'url_resolver': lambda url: github_doc_root + url, + 'url_resolver': lambda url: github_doc_root + url + '.md', 'auto_toc_tree_section': 'Contents', }, True) app.add_transform(AutoStructify) From 95d8f02726336ebc6987b256184ed6310ad47fe4 Mon Sep 17 00:00:00 2001 From: probonopd Date: Wed, 25 Nov 2020 23:09:07 +0100 Subject: [PATCH 013/592] github_doc_root = 'tree/main/' --- conf.py | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/conf.py b/conf.py index 004161e9..e44ac7e9 100644 --- a/conf.py +++ b/conf.py @@ -73,11 +73,10 @@ # so a file named "default.css" will overwrite the builtin "default.css". html_static_path = ['_static'] -github_doc_root = 'https://github.com/' + os.environ['GITHUB_REPOSITORY'] + '/tree/main/' -# FIXME: Extra '.md' added +github_doc_root = 'tree/main/' def setup(app): app.add_config_value('recommonmark_config', { - 'url_resolver': lambda url: github_doc_root + url + '.md', + 'url_resolver': lambda url: github_doc_root + url, 'auto_toc_tree_section': 'Contents', }, True) app.add_transform(AutoStructify) From ecf156ba233aa760c1a7052b2fbb28389b616c0d Mon Sep 17 00:00:00 2001 From: probonopd Date: Wed, 25 Nov 2020 23:17:15 +0100 Subject: [PATCH 014/592] github_doc_root = 'https://github.com/' + os.environ['GITHUB_REPOSITORY'] + '/tree/main/' --- conf.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/conf.py b/conf.py index e44ac7e9..40daeb85 100644 --- a/conf.py +++ b/conf.py @@ -73,7 +73,7 @@ # so a file named "default.css" will overwrite the builtin "default.css". html_static_path = ['_static'] -github_doc_root = 'tree/main/' +github_doc_root = 'https://github.com/' + os.environ['GITHUB_REPOSITORY'] + '/tree/main/' def setup(app): app.add_config_value('recommonmark_config', { 'url_resolver': lambda url: github_doc_root + url, From 51782f95be4dde8bd6514267c3c71de0b34e7d48 Mon Sep 17 00:00:00 2001 From: probonopd Date: Thu, 26 Nov 2020 22:49:50 +0100 Subject: [PATCH 015/592] Update acknowledgements.md --- acknowledgements.md | 1 + 1 file changed, 1 insertion(+) diff --git a/acknowledgements.md b/acknowledgements.md index 0b453511..dae3f734 100644 --- a/acknowledgements.md +++ b/acknowledgements.md @@ -31,6 +31,7 @@ __[pkgdemon](https://github.com/pkgdemon)__ __[vermaden](https://github.com/vermaden)__ @vermaden on twitter * Provided helpful feedback and configuration advice +* Configuration for tap to click and two-finger scrolling for Synaptics and Elan touchpads ## Reven Martin __[rekols](https://github.com/rekols)__ From 00abbb21ffd591965b8ce51d08dcf5a4e85bdef4 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 29 Nov 2020 23:28:23 +0100 Subject: [PATCH 016/592] Update conf.py https://github.com/symuvia/symupy/issues/37#issuecomment-678322450 --- conf.py | 20 +++++++++++++++++--- 1 file changed, 17 insertions(+), 3 deletions(-) diff --git a/conf.py b/conf.py index 40daeb85..70e5014b 100644 --- a/conf.py +++ b/conf.py @@ -74,9 +74,23 @@ html_static_path = ['_static'] github_doc_root = 'https://github.com/' + os.environ['GITHUB_REPOSITORY'] + '/tree/main/' + +# autodoc configuration with AutoStructify +# https://github.com/symuvia/symupy/issues/37#issuecomment-678322450 +# See http://recommonmark.readthedocs.io/en/latest/auto_structify.html +# See the setup function in current conf.py file in the recommonmark repo +# https://github.com/rtfd/recommonmark/blob/master/docs/conf.py#L296 +github_doc_root = 'https://github.com/helloSystem/docs/tree/main/' + +# We can't rely on anchors because GitHub dynamically renders them for +# markdown documents. +linkcheck_anchors = False + def setup(app): app.add_config_value('recommonmark_config', { - 'url_resolver': lambda url: github_doc_root + url, - 'auto_toc_tree_section': 'Contents', - }, True) + 'url_resolver': lambda url: github_doc_root + url, + 'auto_toc_tree_section': 'Contents', + 'enable_eval_rst': True, + 'enable_auto_doc_ref': False, + }, True) app.add_transform(AutoStructify) From 3d8f0cd88e1b6c581145ecce7baf09f4c2669a16 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 30 Nov 2020 00:05:39 +0100 Subject: [PATCH 017/592] enable_auto_toc_tree --- conf.py | 21 ++++----------------- 1 file changed, 4 insertions(+), 17 deletions(-) diff --git a/conf.py b/conf.py index 70e5014b..ab4ec83e 100644 --- a/conf.py +++ b/conf.py @@ -74,23 +74,10 @@ html_static_path = ['_static'] github_doc_root = 'https://github.com/' + os.environ['GITHUB_REPOSITORY'] + '/tree/main/' - -# autodoc configuration with AutoStructify -# https://github.com/symuvia/symupy/issues/37#issuecomment-678322450 -# See http://recommonmark.readthedocs.io/en/latest/auto_structify.html -# See the setup function in current conf.py file in the recommonmark repo -# https://github.com/rtfd/recommonmark/blob/master/docs/conf.py#L296 -github_doc_root = 'https://github.com/helloSystem/docs/tree/main/' - -# We can't rely on anchors because GitHub dynamically renders them for -# markdown documents. -linkcheck_anchors = False - def setup(app): app.add_config_value('recommonmark_config', { - 'url_resolver': lambda url: github_doc_root + url, - 'auto_toc_tree_section': 'Contents', - 'enable_eval_rst': True, - 'enable_auto_doc_ref': False, - }, True) + 'enable_auto_toc_tree': True, + 'url_resolver': lambda url: github_doc_root + url, + 'auto_toc_tree_section': 'Contents', + }, True) app.add_transform(AutoStructify) From 18742df310e589d7f485282c6fea4d457c011dc4 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 30 Nov 2020 00:09:28 +0100 Subject: [PATCH 018/592] Update conf.py --- conf.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/conf.py b/conf.py index ab4ec83e..0dec2b71 100644 --- a/conf.py +++ b/conf.py @@ -73,7 +73,7 @@ # so a file named "default.css" will overwrite the builtin "default.css". html_static_path = ['_static'] -github_doc_root = 'https://github.com/' + os.environ['GITHUB_REPOSITORY'] + '/tree/main/' +github_doc_root = 'https:// ' + os.environ['GITHUB_REPOSITORY'].split("/")[0] + '.github.io/' + os.environ['GITHUB_REPOSITORY'].split("/")[1] + '/' def setup(app): app.add_config_value('recommonmark_config', { 'enable_auto_toc_tree': True, From 83a967ae888a7828007256c74b311634cae558a8 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 30 Nov 2020 00:11:54 +0100 Subject: [PATCH 019/592] github_doc_root --- conf.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/conf.py b/conf.py index 0dec2b71..969cd05e 100644 --- a/conf.py +++ b/conf.py @@ -73,7 +73,7 @@ # so a file named "default.css" will overwrite the builtin "default.css". html_static_path = ['_static'] -github_doc_root = 'https:// ' + os.environ['GITHUB_REPOSITORY'].split("/")[0] + '.github.io/' + os.environ['GITHUB_REPOSITORY'].split("/")[1] + '/' +github_doc_root = '/' + os.environ['GITHUB_REPOSITORY'].split("/")[1] + '/' def setup(app): app.add_config_value('recommonmark_config', { 'enable_auto_toc_tree': True, From b2b7ca79613fee184158ece38cb33f157c01f9d7 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 30 Nov 2020 00:14:45 +0100 Subject: [PATCH 020/592] Update conf.py --- conf.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/conf.py b/conf.py index 969cd05e..95f526a6 100644 --- a/conf.py +++ b/conf.py @@ -73,7 +73,7 @@ # so a file named "default.css" will overwrite the builtin "default.css". html_static_path = ['_static'] -github_doc_root = '/' + os.environ['GITHUB_REPOSITORY'].split("/")[1] + '/' +github_doc_root = 'https://' + os.environ['GITHUB_REPOSITORY'].split("/")[0] + '.github.com/' + os.environ['GITHUB_REPOSITORY'].split("/")[1] + '/' def setup(app): app.add_config_value('recommonmark_config', { 'enable_auto_toc_tree': True, From 2bf5e565483e15251b5c5956bc51fb58153f3d98 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 30 Nov 2020 00:17:23 +0100 Subject: [PATCH 021/592] github.io --- conf.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/conf.py b/conf.py index 95f526a6..5298a2b5 100644 --- a/conf.py +++ b/conf.py @@ -73,7 +73,7 @@ # so a file named "default.css" will overwrite the builtin "default.css". html_static_path = ['_static'] -github_doc_root = 'https://' + os.environ['GITHUB_REPOSITORY'].split("/")[0] + '.github.com/' + os.environ['GITHUB_REPOSITORY'].split("/")[1] + '/' +github_doc_root = 'https://' + os.environ['GITHUB_REPOSITORY'].split("/")[0] + '.github.io/' + os.environ['GITHUB_REPOSITORY'].split("/")[1] + '/' def setup(app): app.add_config_value('recommonmark_config', { 'enable_auto_toc_tree': True, From 32f73abdb8881318b22405ba0e0045169eb50052 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 30 Nov 2020 00:20:48 +0100 Subject: [PATCH 022/592] Update index.md --- index.md | 1 + 1 file changed, 1 insertion(+) diff --git a/index.md b/index.md index 4f705938..21ce7f93 100644 --- a/index.md +++ b/index.md @@ -8,6 +8,7 @@ __hello__ (also known as __helloSystem__) is a desktop system for creators with ## Contents +* [hello](index.md) * [Acknowledgements](acknowledgements.md) ## Status From 77a8472dff773c607a53381d108fcad6a00dc776 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 30 Nov 2020 00:30:21 +0100 Subject: [PATCH 023/592] Update index.md --- index.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/index.md b/index.md index 21ce7f93..3b9ddd0d 100644 --- a/index.md +++ b/index.md @@ -11,6 +11,15 @@ __hello__ (also known as __helloSystem__) is a desktop system for creators with * [hello](index.md) * [Acknowledgements](acknowledgements.md) +``` +.. toctree:: + :maxdepth: 1 + :caption: User Guide + + user/interface + user/urls +``` + ## Status hello is currently being developed. It is not yet available for general use, but advanced users can try out continuous builds of pre-alpha ISO images that can be booted from DVD or USB storage media. From 35afac289a9ad591a1164bd5d4ec21d116437117 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 30 Nov 2020 00:32:09 +0100 Subject: [PATCH 024/592] Update index.md --- index.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/index.md b/index.md index 3b9ddd0d..6781b1b3 100644 --- a/index.md +++ b/index.md @@ -11,8 +11,7 @@ __hello__ (also known as __helloSystem__) is a desktop system for creators with * [hello](index.md) * [Acknowledgements](acknowledgements.md) -``` -.. toctree:: +``` .. toctree:: :maxdepth: 1 :caption: User Guide From de7a34ebb4847deac111b1ae39ea5697993eaa32 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 30 Nov 2020 00:34:15 +0100 Subject: [PATCH 025/592] Update index.md --- index.md | 5 ----- 1 file changed, 5 deletions(-) diff --git a/index.md b/index.md index 6781b1b3..b1a00a24 100644 --- a/index.md +++ b/index.md @@ -6,11 +6,6 @@ __hello__ (also known as __helloSystem__) is a desktop system for creators with focus on simplicity, elegance, and usability. Its design follows the "Less, but better" philosophy. It is intended as a system for "mere mortals", welcoming to switchers from the Mac. [FreeBSD](https://www.freebsd.org/) is used as the core operating system. Please refer to https://github.com/helloSystem/hello if you would like to learn more about the ideas and principles behind hello. -## Contents - -* [hello](index.md) -* [Acknowledgements](acknowledgements.md) - ``` .. toctree:: :maxdepth: 1 :caption: User Guide From f32a77b2929eb6b141a47d70002ca12f29e79bd0 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 30 Nov 2020 00:35:10 +0100 Subject: [PATCH 026/592] Update index.md --- index.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/index.md b/index.md index b1a00a24..abc98613 100644 --- a/index.md +++ b/index.md @@ -10,6 +10,8 @@ __hello__ (also known as __helloSystem__) is a desktop system for creators with :maxdepth: 1 :caption: User Guide + index + acknowledgements user/interface user/urls ``` From 9a4949b79c9af742a8d27af8f5ac2dfbd0704c1d Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 30 Nov 2020 00:42:59 +0100 Subject: [PATCH 027/592] Create contributing.md --- developer/contributing.md | 51 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 51 insertions(+) create mode 100644 developer/contributing.md diff --git a/developer/contributing.md b/developer/contributing.md new file mode 100644 index 00000000..2cc66563 --- /dev/null +++ b/developer/contributing.md @@ -0,0 +1,51 @@ +# Contributing + +If you have found this page, chances are that you are considering to to contribute to this project. + +Awesome! + +This is a small, purely volunteer-driven project, so your contributions are _highly_ welcome. + +## How to get started? + +* Download the pre-alpha Live ISO from https://github.com/helloSystem/ISO/releases/tag/continuous-hello +* Look through the GitHub Issues sections of the projects within https://github.com/helloSystem/ +* A great way to get started is to comment on some GitHub issues. Also feel free to open new ones. We use GitHub Issues as a means of discussion and keeping track of everything, so don't hesitate to use them. General topics not related to any particular component go to https://github.com/helloSystem/hello/issues +* Especially have a look at issues marked with ![](https://user-images.githubusercontent.com/2480569/97901371-64b8ad80-1d3c-11eb-8282-0bfdcd3fe512.png). Here your contributions would be especially helpful, but of course your contibutions to other tickets are more than welcome, too +* There is a liberal amount of `FIXME` and `TODO` in the source code. Reducing the number of those is always highly welcome + +## Our project values + +* Please see https://github.com/helloSystem/hello for the general philosophy of the project +* Always keep in mind that our philosophy is "simple > complicated", "less, but better" +* We prefer small pull requests that change one thing each, rather than large ones that do many things at once +* Please avoid complex code structures that require deep C++ knowledge (e.g., avoid subclassing, pointer arithmetic,... where possible) +* We appreciate code with comments that explain why we are doing something +* Our policy is to merge PRs liberally but roll back changes that cause breakage quickly. `master` must always build and not crash + +## Areas we especially need help with + +Here is what we need help with: [Issues flagged with help-wanted](https://github.com/search?q=org%3AhelloSystem+is%3Aissue+is%3Aopen+label%3A%22help+wanted%22), and of course other contributions are also welcome. + +Maybe you'd like to look into one of these: [Issues flagged with good-first-issue](https://github.com/search?q=org%3AhelloSystem+is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22&type=). + +### FreeBSD related topics + +Skills/resources we don't currently have and would highly appreciate help with + +|Skillset needed|Topic|Status|Rationale|Contact| +|---|---|---|---|---| +|FreeBSD kernel|Overhaul/bugfixing for unionfs.ko to create a read-write root filesystem|Idea|Save time and RAM by not having to copy the whole root filesystem to RAM|probonopd| +|OpenZFS|A way to combine read-only (Live ISO) with read-write (ramdisk) to create a read-write root filesystem|Idea|Save time and RAM by not having to copy the whole root filesystem to RAM|probonopd| +|FreeBSD kernel, graphics|Zero-text bootsplash that shows a boot animation and hides all text unless verbosity is explicitly requested|Idea|Put together "appliance" style systems that are not frightening non-technical users|probonopd| +|FreeBSD build system|Kernel-related packages built for each FreeBSD version ([details](https://github.com/furybsd/furybsd-livecd/issues/241))|idea|Xorg fails on 12.2-RELEASE|probonopd| +|FreeBSD Linuxulator|Make it possible for Linux applications to use FreeBSD D-Bus|Idea|Have Linux applications to use the [global menu](https://github.com/helloSystem/Menu) that is running on FreeBSD|probonopd| +|FreeBSD kernel, Golang|Enable Go-based FUSE filesystems for FreeBSD ([issue](https://github.com/jacobsa/fuse/issues/91))|Idea|Packages that are images rather than archives: Experiment with [distr1](http://distr1.org/) concepts on FreeBSD|probonopd| +|Qt, OpenZFS|ZFS snapshot, clone integration into the file manager|Idea|Expose the power of ZFS to non-technical users|probonopd| + +### Qt related topics + +|Skillset needed|Topic|Status|Rationale|Contact| +|---|---|---|---|---| +|Qt|Improve the Filer (file manager)||Please see https://github.com/helloSystem/Filer/issues|probonopd| +|Qt|Improve the Menu (global menu bar)||Please see https://github.com/helloSystem/Menu/issues|probonopd| From f01eb136dec70d8bf08b0f09e6ced01b821ee300 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 30 Nov 2020 00:43:33 +0100 Subject: [PATCH 028/592] Update index.md --- index.md | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) diff --git a/index.md b/index.md index abc98613..99fdc167 100644 --- a/index.md +++ b/index.md @@ -12,8 +12,13 @@ __hello__ (also known as __helloSystem__) is a desktop system for creators with index acknowledgements - user/interface - user/urls +``` + +``` .. toctree:: + :maxdepth: 1 + :caption: Developer Guide + + developer/contributing ``` ## Status From 93a6f103b1eb48e12ef3a438d351bb4caa5edfc4 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 30 Nov 2020 00:52:15 +0100 Subject: [PATCH 029/592] Update index.md --- index.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/index.md b/index.md index 99fdc167..7976abbb 100644 --- a/index.md +++ b/index.md @@ -9,6 +9,7 @@ __hello__ (also known as __helloSystem__) is a desktop system for creators with ``` .. toctree:: :maxdepth: 1 :caption: User Guide + :hidden: index acknowledgements @@ -17,8 +18,9 @@ __hello__ (also known as __helloSystem__) is a desktop system for creators with ``` .. toctree:: :maxdepth: 1 :caption: Developer Guide + :hidden: - developer/contributing + developer/* ``` ## Status From 7eb28d4d49d44a3801cea937e0893f6f7b5e323d Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 30 Nov 2020 00:59:28 +0100 Subject: [PATCH 030/592] Update index.md --- index.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/index.md b/index.md index 7976abbb..1355db33 100644 --- a/index.md +++ b/index.md @@ -7,7 +7,7 @@ __hello__ (also known as __helloSystem__) is a desktop system for creators with focus on simplicity, elegance, and usability. Its design follows the "Less, but better" philosophy. It is intended as a system for "mere mortals", welcoming to switchers from the Mac. [FreeBSD](https://www.freebsd.org/) is used as the core operating system. Please refer to https://github.com/helloSystem/hello if you would like to learn more about the ideas and principles behind hello. ``` .. toctree:: - :maxdepth: 1 + :maxdepth: 2 :caption: User Guide :hidden: @@ -16,11 +16,11 @@ __hello__ (also known as __helloSystem__) is a desktop system for creators with ``` ``` .. toctree:: - :maxdepth: 1 + :maxdepth: 2 :caption: Developer Guide :hidden: - developer/* + developer/contributing ``` ## Status From dcf112800a5624922b73668516e932b5e794a955 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 30 Nov 2020 01:02:50 +0100 Subject: [PATCH 031/592] Update index.md --- index.md | 11 +---------- 1 file changed, 1 insertion(+), 10 deletions(-) diff --git a/index.md b/index.md index 1355db33..bf35db2b 100644 --- a/index.md +++ b/index.md @@ -8,19 +8,10 @@ __hello__ (also known as __helloSystem__) is a desktop system for creators with ``` .. toctree:: :maxdepth: 2 - :caption: User Guide - :hidden: index acknowledgements -``` - -``` .. toctree:: - :maxdepth: 2 - :caption: Developer Guide - :hidden: - - developer/contributing + developer/* ``` ## Status From 1557bb86f5b9358bc13a2100071cd8130e8b6bac Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 30 Nov 2020 01:05:57 +0100 Subject: [PATCH 032/592] Update index.md --- index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.md b/index.md index bf35db2b..625c5e77 100644 --- a/index.md +++ b/index.md @@ -11,7 +11,7 @@ __hello__ (also known as __helloSystem__) is a desktop system for creators with index acknowledgements - developer/* + developer/contributing ``` ## Status From 2ff731046d6b923d965094a85505d70009069182 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 30 Nov 2020 01:06:36 +0100 Subject: [PATCH 033/592] eval_rst --- index.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/index.md b/index.md index 625c5e77..80759104 100644 --- a/index.md +++ b/index.md @@ -6,7 +6,8 @@ __hello__ (also known as __helloSystem__) is a desktop system for creators with focus on simplicity, elegance, and usability. Its design follows the "Less, but better" philosophy. It is intended as a system for "mere mortals", welcoming to switchers from the Mac. [FreeBSD](https://www.freebsd.org/) is used as the core operating system. Please refer to https://github.com/helloSystem/hello if you would like to learn more about the ideas and principles behind hello. -``` .. toctree:: +```eval_rst +.. toctree:: :maxdepth: 2 index From 357fe89046c34f63a397113f79cccf1640a52146 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 30 Nov 2020 01:06:57 +0100 Subject: [PATCH 034/592] Update index.md --- index.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/index.md b/index.md index 80759104..f401e297 100644 --- a/index.md +++ b/index.md @@ -44,7 +44,8 @@ hello is known to boot to a graphical desktop on the following machines. Auxilia Continuous builds of pre-alpha ISO images are available for download [here](https://github.com/helloSystem/ISO/releases/tag/continuous-hello). -``` important:: Images get built automatically whenever source code is committed. Not every build is tested. +```eval_rst +important:: Images get built automatically whenever source code is committed. Not every build is tested. ``` ## Troubleshooting From 43f2542c8d6edef6ed01c0547a9eb66270fa9dc9 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 30 Nov 2020 01:12:26 +0100 Subject: [PATCH 035/592] Remove index --- index.md | 1 - 1 file changed, 1 deletion(-) diff --git a/index.md b/index.md index f401e297..4dc477bc 100644 --- a/index.md +++ b/index.md @@ -10,7 +10,6 @@ __hello__ (also known as __helloSystem__) is a desktop system for creators with .. toctree:: :maxdepth: 2 - index acknowledgements developer/contributing ``` From e72d5ad650322ac09f1529ed6d540d79fb23ade7 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 30 Nov 2020 01:21:36 +0100 Subject: [PATCH 036/592] Update index.md --- index.md | 17 +++++++++++++++-- 1 file changed, 15 insertions(+), 2 deletions(-) diff --git a/index.md b/index.md index 4dc477bc..db20a33e 100644 --- a/index.md +++ b/index.md @@ -8,12 +8,25 @@ __hello__ (also known as __helloSystem__) is a desktop system for creators with ```eval_rst .. toctree:: - :maxdepth: 2 + :caption: User Guide + :hidden: + :maxdepth: 1 + :glob: acknowledgements - developer/contributing ``` +```eval_rst +.. toctree:: + :caption: Developer Guide + :hidden: + :maxdepth: 1 + :glob: + + developer/* +``` + + ## Status hello is currently being developed. It is not yet available for general use, but advanced users can try out continuous builds of pre-alpha ISO images that can be booted from DVD or USB storage media. From 485d90a47bba8f18c0dd17c169e9862309e892c6 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 30 Nov 2020 01:25:03 +0100 Subject: [PATCH 037/592] user/* [ci skip] --- index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.md b/index.md index db20a33e..b46e4af1 100644 --- a/index.md +++ b/index.md @@ -13,7 +13,7 @@ __hello__ (also known as __helloSystem__) is a desktop system for creators with :maxdepth: 1 :glob: - acknowledgements + user/* ``` ```eval_rst From 033cf4da0bee4ee6a5ff957e5d87a1f573e9d2b4 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 30 Nov 2020 01:25:35 +0100 Subject: [PATCH 038/592] Rename acknowledgements.md to user/100-acknowledgements.md [ci skip] --- acknowledgements.md => user/100-acknowledgements.md | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename acknowledgements.md => user/100-acknowledgements.md (100%) diff --git a/acknowledgements.md b/user/100-acknowledgements.md similarity index 100% rename from acknowledgements.md rename to user/100-acknowledgements.md From b44ce9001b70b0e0c7b7f006f6b37f629fd1e21a Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 30 Nov 2020 01:25:59 +0100 Subject: [PATCH 039/592] Rename contributing.md to 100-contributing.md --- developer/{contributing.md => 100-contributing.md} | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename developer/{contributing.md => 100-contributing.md} (100%) diff --git a/developer/contributing.md b/developer/100-contributing.md similarity index 100% rename from developer/contributing.md rename to developer/100-contributing.md From 51c2662a9fa2f569f310116e9104ec8610b65983 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 30 Nov 2020 01:28:03 +0100 Subject: [PATCH 040/592] Update index.md [ci skip] --- index.md | 63 ++------------------------------------------------------ 1 file changed, 2 insertions(+), 61 deletions(-) diff --git a/index.md b/index.md index b46e4af1..0a9493c4 100644 --- a/index.md +++ b/index.md @@ -10,7 +10,7 @@ __hello__ (also known as __helloSystem__) is a desktop system for creators with .. toctree:: :caption: User Guide :hidden: - :maxdepth: 1 + :maxdepth: 2 :glob: user/* @@ -20,67 +20,8 @@ __hello__ (also known as __helloSystem__) is a desktop system for creators with .. toctree:: :caption: Developer Guide :hidden: - :maxdepth: 1 + :maxdepth: 2 :glob: developer/* ``` - - -## Status - -hello is currently being developed. It is not yet available for general use, but advanced users can try out continuous builds of pre-alpha ISO images that can be booted from DVD or USB storage media. - -## System requirements - -* 2 GHz dual core Intel/ARM 64-bit processor -* 4 GiB RAM (system memory for physical and viritualized installs) -* VGA capable of 1024x768 screen resolution -* Either a CD/DVD drive or a USB port for booting the installer media - -In the future, there may also be builds for other processor architectures. We would like to bring down the RAM requirement considerably. - -### Tested hardware - -hello is known to boot to a graphical desktop on the following machines. Auxiliary functionality such as wireless networking, sound over HDMI, sleep, graphics acceleration, etc. has not yet been tested systematically. - -* Acer Revo RL85 -* Dell Inc. OptiPlex 780 - -### Tested virtualization environments - -* VirtualBox host (on FreeBSD) -* VMware host (on Windows) - -## Downloading - -Continuous builds of pre-alpha ISO images are available for download [here](https://github.com/helloSystem/ISO/releases/tag/continuous-hello). - -```eval_rst -important:: Images get built automatically whenever source code is committed. Not every build is tested. -``` - -## Troubleshooting - -* __Boot stalls during `Replicate system image to swap-based memdisk`__: This build of the ISO is damaged. Please wait for another continuous build to appear and try again. -* __Boots to a non-graphical `login:` prompt__: Your grahpics hardware was not detected properly. Please try on another machine. - -## Reporting bugs - -Please search [https://github.com/helloSystem/ISO/issues](https://github.com/helloSystem/ISO/issues) for known issues. Feel free to add to existing issues or to open new issues there. - -## Discussing ideas and wishlist items - -Please check [https://github.com/helloSystem/hello](https://github.com/helloSystem/hello) fist, including the [wiki](https://github.com/helloSystem/hello/wiki). Feel free to discuss ideas and wishlist items at [https://github.com/helloSystem/hello/issues](https://github.com/helloSystem/hello/issues), but please do keep in mind that in order to achieve the intended goal of simplicity, the team needs to say "no" to most wishlist items that do not further that goal. - -## Contributing - -This project lives from contributions by people like you. - -Here is what we need help with: [Issues flagged with help-wanted](https://github.com/search?q=org%3AhelloSystem+is%3Aissue+is%3Aopen+label%3A%22help+wanted%22), and of course other contributions are also welcome. - -Maybe you'd like to look into one of these: [Issues flagged with good-first-issue](https://github.com/search?q=org%3AhelloSystem+is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22&type=). - -Please see the https://github.com/helloSystem/hello/blob/master/CONTRIBUTING.md page for more information. - -Developers chat at `#FuryBSD` on `irc.freenode.net`. Since we are working in different timezones, do not expect immediate answers. It is best to stay connected for at least a couple of days or so. From 5b824376bbb7281f33d1077c75a8b8ae41191aa0 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 30 Nov 2020 01:28:51 +0100 Subject: [PATCH 041/592] Create 20-getting-started.md [ci skip] --- user/20-getting-started.md | 34 ++++++++++++++++++++++++++++++++++ 1 file changed, 34 insertions(+) create mode 100644 user/20-getting-started.md diff --git a/user/20-getting-started.md b/user/20-getting-started.md new file mode 100644 index 00000000..0f3f3817 --- /dev/null +++ b/user/20-getting-started.md @@ -0,0 +1,34 @@ +# Getting started + +## Status + +hello is currently being developed. It is not yet available for general use, but advanced users can try out continuous builds of pre-alpha ISO images that can be booted from DVD or USB storage media. + +## System requirements + +* 2 GHz dual core Intel/ARM 64-bit processor +* 4 GiB RAM (system memory for physical and viritualized installs) +* VGA capable of 1024x768 screen resolution +* Either a CD/DVD drive or a USB port for booting the installer media + +In the future, there may also be builds for other processor architectures. We would like to bring down the RAM requirement considerably. + +### Tested hardware + +hello is known to boot to a graphical desktop on the following machines. Auxiliary functionality such as wireless networking, sound over HDMI, sleep, graphics acceleration, etc. has not yet been tested systematically. + +* Acer Revo RL85 +* Dell Inc. OptiPlex 780 + +### Tested virtualization environments + +* VirtualBox host (on FreeBSD) +* VMware host (on Windows) + +## Downloading + +Continuous builds of pre-alpha ISO images are available for download [here](https://github.com/helloSystem/ISO/releases/tag/continuous-hello). + +```eval_rst +important:: Images get built automatically whenever source code is committed. Not every build is tested. +``` From f15ffde68fe3375cb541ec67f7bf2fdca53a1b1f Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 30 Nov 2020 01:29:57 +0100 Subject: [PATCH 042/592] Create 90-troubleshooting.md --- user/90-troubleshooting.md | 10 ++++++++++ 1 file changed, 10 insertions(+) create mode 100644 user/90-troubleshooting.md diff --git a/user/90-troubleshooting.md b/user/90-troubleshooting.md new file mode 100644 index 00000000..a3516cad --- /dev/null +++ b/user/90-troubleshooting.md @@ -0,0 +1,10 @@ +# Troubleshooting + +## Known issues + +* __Boot stalls during `Replicate system image to swap-based memdisk`__: This build of the ISO is damaged. Please wait for another continuous build to appear and try again. +* __Boots to a non-graphical `login:` prompt__: Your grahpics hardware was not detected properly. Please try on another machine. + +## Reporting bugs + +Please search [https://github.com/helloSystem/ISO/issues](https://github.com/helloSystem/ISO/issues) for known issues. Feel free to add to existing issues or to open new issues there. From 40b4db18356cb99458f38c070c356ef1005dc44b Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 30 Nov 2020 01:32:44 +0100 Subject: [PATCH 043/592] Make link clickable [ci skip] --- index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.md b/index.md index 0a9493c4..81dfd681 100644 --- a/index.md +++ b/index.md @@ -4,7 +4,7 @@ .. centered:: Willkommen • Welcome • 欢迎 • Bienvenue • Benvenuto • Bienvenido • ようこそ • Mabuhay • Välkommen • أهلا وسهلا • Добро пожаловать • Merhaba • Bonvenon • 歡迎光臨 ``` -__hello__ (also known as __helloSystem__) is a desktop system for creators with focus on simplicity, elegance, and usability. Its design follows the "Less, but better" philosophy. It is intended as a system for "mere mortals", welcoming to switchers from the Mac. [FreeBSD](https://www.freebsd.org/) is used as the core operating system. Please refer to https://github.com/helloSystem/hello if you would like to learn more about the ideas and principles behind hello. +__hello__ (also known as __helloSystem__) is a desktop system for creators with focus on simplicity, elegance, and usability. Its design follows the "Less, but better" philosophy. It is intended as a system for "mere mortals", welcoming to switchers from the Mac. [FreeBSD](https://www.freebsd.org/) is used as the core operating system. Please refer to [https://github.com/helloSystem/hello](https://github.com/helloSystem/hello) if you would like to learn more about the ideas and principles behind hello. ```eval_rst .. toctree:: From ace6cc8e83cb7c906024515d656b0e34b5e27d88 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 30 Nov 2020 01:33:17 +0100 Subject: [PATCH 044/592] Rename 20-getting-started.md to 020-getting-started.md [ci skip] --- user/{20-getting-started.md => 020-getting-started.md} | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename user/{20-getting-started.md => 020-getting-started.md} (100%) diff --git a/user/20-getting-started.md b/user/020-getting-started.md similarity index 100% rename from user/20-getting-started.md rename to user/020-getting-started.md From dfdb00492d818a593d9b3049313001b7d4cd61f6 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 30 Nov 2020 01:33:29 +0100 Subject: [PATCH 045/592] Rename 90-troubleshooting.md to 090-troubleshooting.md --- user/{90-troubleshooting.md => 090-troubleshooting.md} | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename user/{90-troubleshooting.md => 090-troubleshooting.md} (100%) diff --git a/user/90-troubleshooting.md b/user/090-troubleshooting.md similarity index 100% rename from user/90-troubleshooting.md rename to user/090-troubleshooting.md From e31ce548324d01858e85b9f402a98ff2a8b7673e Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 30 Nov 2020 01:36:41 +0100 Subject: [PATCH 046/592] Update 090-troubleshooting.md [ci skip] --- user/090-troubleshooting.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/user/090-troubleshooting.md b/user/090-troubleshooting.md index a3516cad..a7d675a6 100644 --- a/user/090-troubleshooting.md +++ b/user/090-troubleshooting.md @@ -5,6 +5,10 @@ * __Boot stalls during `Replicate system image to swap-based memdisk`__: This build of the ISO is damaged. Please wait for another continuous build to appear and try again. * __Boots to a non-graphical `login:` prompt__: Your grahpics hardware was not detected properly. Please try on another machine. +## Getting help + +Developers chat at `#FuryBSD` on `irc.freenode.net`. Since we are working in different timezones, do not expect immediate answers. It is best to stay connected for at least a couple of days or so. + ## Reporting bugs Please search [https://github.com/helloSystem/ISO/issues](https://github.com/helloSystem/ISO/issues) for known issues. Feel free to add to existing issues or to open new issues there. From a55e97a022f9e002da084981165a3fe7ff231bbc Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 30 Nov 2020 01:37:51 +0100 Subject: [PATCH 047/592] Create 150-contact.md --- developer/150-contact.md | 3 +++ 1 file changed, 3 insertions(+) create mode 100644 developer/150-contact.md diff --git a/developer/150-contact.md b/developer/150-contact.md new file mode 100644 index 00000000..fe335b7a --- /dev/null +++ b/developer/150-contact.md @@ -0,0 +1,3 @@ +# Contact + +Developers chat at `#FuryBSD` on `irc.freenode.net`. Since we are working in different timezones, do not expect immediate answers. It is best to stay connected for at least a couple of days or so. From 1b4961afd0ae9eb474adc4e442bfcc3c58b9e8cb Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 30 Nov 2020 01:39:25 +0100 Subject: [PATCH 048/592] Update 100-acknowledgements.md --- user/100-acknowledgements.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/user/100-acknowledgements.md b/user/100-acknowledgements.md index dae3f734..54803fc2 100644 --- a/user/100-acknowledgements.md +++ b/user/100-acknowledgements.md @@ -57,3 +57,7 @@ __[keshavbhatt](https://github.com/keshavbhatt)__ ## @FreeBSDHelp on twitter * Reached out to FreeBSD kernel developers + +## TheAssassin +__[TheAssassin](https://github.com/TheAssassin)__ +* Provided Sphinx evangelism and ReStructuredText help From 89a8fb6edf53e5f3d7287f908f4e17315511277b Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 30 Nov 2020 01:39:59 +0100 Subject: [PATCH 049/592] Update 100-acknowledgements.md [ci skip] --- user/100-acknowledgements.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/user/100-acknowledgements.md b/user/100-acknowledgements.md index 54803fc2..59219461 100644 --- a/user/100-acknowledgements.md +++ b/user/100-acknowledgements.md @@ -60,4 +60,4 @@ __[keshavbhatt](https://github.com/keshavbhatt)__ ## TheAssassin __[TheAssassin](https://github.com/TheAssassin)__ -* Provided Sphinx evangelism and ReStructuredText help +* Improved documentation by providing Sphinx evangelism and ReStructuredText help From 9bd824ee4c57c8827bec5814ed3928240691c53d Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 30 Nov 2020 01:46:26 +0100 Subject: [PATCH 050/592] Create 095-feedback.md --- user/095-feedback.md | 9 +++++++++ 1 file changed, 9 insertions(+) create mode 100644 user/095-feedback.md diff --git a/user/095-feedback.md b/user/095-feedback.md new file mode 100644 index 00000000..b03c5444 --- /dev/null +++ b/user/095-feedback.md @@ -0,0 +1,9 @@ +# Providing feedback + +## Sharing your experience + +If you would share your experience with helloSystem on twitter, use the [`#helloSystem` hashtag](https://twitter.com/hashtag/helloSystem). + +## Discussing ideas and wishlist items + +Please check [https://github.com/helloSystem/hello](https://github.com/helloSystem/hello) fist, including the [wiki](https://github.com/helloSystem/hello/wiki). Feel free to discuss ideas and wishlist items at [https://github.com/helloSystem/hello/issues](https://github.com/helloSystem/hello/issues), but please do keep in mind that in order to achieve the intended goal of simplicity, the team needs to say "no" to most wishlist items that do not further that goal. From a028884485a908619cda45633c591a383b2f1f83 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 30 Nov 2020 01:55:55 +0100 Subject: [PATCH 051/592] Create menu.md --- user/components/menu.md | 41 +++++++++++++++++++++++++++++++++++++++++ 1 file changed, 41 insertions(+) create mode 100644 user/components/menu.md diff --git a/user/components/menu.md b/user/components/menu.md new file mode 100644 index 00000000..e7fbf763 --- /dev/null +++ b/user/components/menu.md @@ -0,0 +1,41 @@ +# Menu + +The menu bar at the top of the screen lets you perform, among others, the following functions: + +* Get information about your computer +* Hide and unhide windows +* Launch applications +* Shut down your computer +* Search in application menus +* See date and time + +## Getting computer information + +Select "About This Computer" from the "System" menu. + +## Managing windows + +Select "Hide all" to minimize all windows to the Dock. + +Select "Unhide all" to get all windows back on screen. + +## Launching applications + +Select an application from "Applications", "Utilities", or "Preferences" in the "Applications" menu. + +A quicker way to launch an application is to press Alt+Space, enter a few characters of the application name, select one of the matches from the list, and press the Enter key. + +* Shutting down + +To shut down your computer, select "Log Out" from the "System" menu, then click "Shut Down". You can also choose "Restart" if you want to restart your computer, or "Log Out" if you would like to log out of the current graphical session. + +## Searching in application menus + +Click into the "Search in Menu" box in the menu bar, or press Alt+Space. Then enter a few characters of the menu entry you would like to execute, select one of the matches from the list, and press the Enter key. + +## Date and time + +Date and time in your current timezone are displayed at the right hand side of the menu bar. + + +* See date and time From 37b0275e48d872d3a25f5ac0adf962e9984ad9a4 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 30 Nov 2020 01:56:27 +0100 Subject: [PATCH 052/592] Update menu.md --- user/components/menu.md | 5 +---- 1 file changed, 1 insertion(+), 4 deletions(-) diff --git a/user/components/menu.md b/user/components/menu.md index e7fbf763..b9571bf0 100644 --- a/user/components/menu.md +++ b/user/components/menu.md @@ -25,7 +25,7 @@ Select an application from "Applications", "Utilities", or "Preferences" in the A quicker way to launch an application is to press Alt+Space, enter a few characters of the application name, select one of the matches from the list, and press the Enter key. -* Shutting down +## Shutting down To shut down your computer, select "Log Out" from the "System" menu, then click "Shut Down". You can also choose "Restart" if you want to restart your computer, or "Log Out" if you would like to log out of the current graphical session. @@ -36,6 +36,3 @@ Click into the "Search in Menu" box in the menu bar, or press Alt+Space. Then en ## Date and time Date and time in your current timezone are displayed at the right hand side of the menu bar. - - -* See date and time From c2f46cd62ac9818095686169543b629501a64a11 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 30 Nov 2020 02:00:34 +0100 Subject: [PATCH 053/592] FreeBSD Hardware Compatibility link --- user/020-getting-started.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/user/020-getting-started.md b/user/020-getting-started.md index 0f3f3817..cfafa650 100644 --- a/user/020-getting-started.md +++ b/user/020-getting-started.md @@ -13,6 +13,8 @@ hello is currently being developed. It is not yet available for general use, but In the future, there may also be builds for other processor architectures. We would like to bring down the RAM requirement considerably. +Please refer to [FreeBSD Hardware Compatibility](https://www.freebsd.org/doc/en_US.ISO8859-1/books/faq/hardware.html) for more information on individual components. + ### Tested hardware hello is known to boot to a graphical desktop on the following machines. Auxiliary functionality such as wireless networking, sound over HDMI, sleep, graphics acceleration, etc. has not yet been tested systematically. From c597f20d8960184dd5491a58406284a6f399b3e3 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 30 Nov 2020 02:02:03 +0100 Subject: [PATCH 054/592] Update index.md --- index.md | 1 + 1 file changed, 1 insertion(+) diff --git a/index.md b/index.md index 81dfd681..334597a3 100644 --- a/index.md +++ b/index.md @@ -14,6 +14,7 @@ __hello__ (also known as __helloSystem__) is a desktop system for creators with :glob: user/* + user/components/* ``` ```eval_rst From 5a7613da5603f0f9c91c6e68f2a6bcc7759b4ebf Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 30 Nov 2020 02:15:12 +0100 Subject: [PATCH 055/592] Create 050-components.md --- user/050-components.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) create mode 100644 user/050-components.md diff --git a/user/050-components.md b/user/050-components.md new file mode 100644 index 00000000..7212566a --- /dev/null +++ b/user/050-components.md @@ -0,0 +1,12 @@ +# Components + +hello conststs of the following components, each of which are described in this section: + +```eval_rst +.. toctree:: + :caption: User Guide + :maxdepth: 2 + :glob: + + user/components/* +``` From 70fabb71f6217afee71ffb4f2bc1a3397720bc2f Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 30 Nov 2020 02:15:36 +0100 Subject: [PATCH 056/592] Update 050-components.md --- user/050-components.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/user/050-components.md b/user/050-components.md index 7212566a..1a04439a 100644 --- a/user/050-components.md +++ b/user/050-components.md @@ -4,7 +4,7 @@ hello conststs of the following components, each of which are described in this ```eval_rst .. toctree:: - :caption: User Guide + :caption: Components :maxdepth: 2 :glob: From 4820c82bcc67b2ab32fdf124d1f73ffd5d812130 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 30 Nov 2020 02:20:27 +0100 Subject: [PATCH 057/592] Update 050-components.md --- user/050-components.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/user/050-components.md b/user/050-components.md index 1a04439a..dd573c1b 100644 --- a/user/050-components.md +++ b/user/050-components.md @@ -8,5 +8,5 @@ hello conststs of the following components, each of which are described in this :maxdepth: 2 :glob: - user/components/* + components/* ``` From 4d0179d028353216714a5b39b6b59778d17606de Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 30 Nov 2020 02:20:45 +0100 Subject: [PATCH 058/592] Update index.md --- index.md | 1 - 1 file changed, 1 deletion(-) diff --git a/index.md b/index.md index 334597a3..81dfd681 100644 --- a/index.md +++ b/index.md @@ -14,7 +14,6 @@ __hello__ (also known as __helloSystem__) is a desktop system for creators with :glob: user/* - user/components/* ``` ```eval_rst From 35f1bf863bd5fefcb8545df6b7a8e3090240b05d Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 30 Nov 2020 02:39:21 +0100 Subject: [PATCH 059/592] Create index.md --- user/index.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) create mode 100644 user/index.md diff --git a/user/index.md b/user/index.md new file mode 100644 index 00000000..958aa658 --- /dev/null +++ b/user/index.md @@ -0,0 +1,13 @@ +# User Guide + +```eval_rst +.. toctree:: + :maxdepth: 2 + :glob: + + getting-started + components + troubleshooting + feedback + acknowledgements +``` From 8be7c2777977e15f9e78ada35b402ab3bb15ccb9 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 30 Nov 2020 02:42:27 +0100 Subject: [PATCH 060/592] Restructure --- developer/{150-contact.md => contact.md} | 0 developer/{100-contributing.md => contributing.md} | 0 developer/index.md | 10 ++++++++++ index.md | 2 -- user/{100-acknowledgements.md => acknowledgements.md} | 0 user/{050-components.md => components.md} | 0 user/{095-feedback.md => feedback.md} | 0 user/{020-getting-started.md => getting-started.md} | 0 user/{090-troubleshooting.md => troubleshooting.md} | 0 9 files changed, 10 insertions(+), 2 deletions(-) rename developer/{150-contact.md => contact.md} (100%) rename developer/{100-contributing.md => contributing.md} (100%) create mode 100644 developer/index.md rename user/{100-acknowledgements.md => acknowledgements.md} (100%) rename user/{050-components.md => components.md} (100%) rename user/{095-feedback.md => feedback.md} (100%) rename user/{020-getting-started.md => getting-started.md} (100%) rename user/{090-troubleshooting.md => troubleshooting.md} (100%) diff --git a/developer/150-contact.md b/developer/contact.md similarity index 100% rename from developer/150-contact.md rename to developer/contact.md diff --git a/developer/100-contributing.md b/developer/contributing.md similarity index 100% rename from developer/100-contributing.md rename to developer/contributing.md diff --git a/developer/index.md b/developer/index.md new file mode 100644 index 00000000..182dbe8f --- /dev/null +++ b/developer/index.md @@ -0,0 +1,10 @@ +# Developer Guide + +```eval_rst +.. toctree:: + :maxdepth: 2 + :glob: + + contributing + contact +``` diff --git a/index.md b/index.md index 81dfd681..3bc4b817 100644 --- a/index.md +++ b/index.md @@ -8,7 +8,6 @@ __hello__ (also known as __helloSystem__) is a desktop system for creators with ```eval_rst .. toctree:: - :caption: User Guide :hidden: :maxdepth: 2 :glob: @@ -18,7 +17,6 @@ __hello__ (also known as __helloSystem__) is a desktop system for creators with ```eval_rst .. toctree:: - :caption: Developer Guide :hidden: :maxdepth: 2 :glob: diff --git a/user/100-acknowledgements.md b/user/acknowledgements.md similarity index 100% rename from user/100-acknowledgements.md rename to user/acknowledgements.md diff --git a/user/050-components.md b/user/components.md similarity index 100% rename from user/050-components.md rename to user/components.md diff --git a/user/095-feedback.md b/user/feedback.md similarity index 100% rename from user/095-feedback.md rename to user/feedback.md diff --git a/user/020-getting-started.md b/user/getting-started.md similarity index 100% rename from user/020-getting-started.md rename to user/getting-started.md diff --git a/user/090-troubleshooting.md b/user/troubleshooting.md similarity index 100% rename from user/090-troubleshooting.md rename to user/troubleshooting.md From 9bf929b818d6e2b7aca77049809e5d427c3d168c Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 30 Nov 2020 02:45:01 +0100 Subject: [PATCH 061/592] Update index.md --- index.md | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff --git a/index.md b/index.md index 3bc4b817..2d9ebe03 100644 --- a/index.md +++ b/index.md @@ -10,16 +10,14 @@ __hello__ (also known as __helloSystem__) is a desktop system for creators with .. toctree:: :hidden: :maxdepth: 2 - :glob: - user/* + user/index ``` ```eval_rst .. toctree:: :hidden: :maxdepth: 2 - :glob: - developer/* + developer/index ``` From 5f6f31c132e4c4b25c9d036646c1f31d5d267251 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 30 Nov 2020 02:47:11 +0100 Subject: [PATCH 062/592] Update index.md --- index.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/index.md b/index.md index 2d9ebe03..1d9c4abd 100644 --- a/index.md +++ b/index.md @@ -1,3 +1,7 @@ +.. image:: https://raw.githubusercontent.com/helloSystem/hello/1d1e69be8a689c5e0a176df821c14f0b49b241a4/branding/hello_variation.svg + :align: center + :width: 300px + # hello ```eval_rst From d04bae06bfa7cc3f2d9ce1a69c97a72b93f5a7d8 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 30 Nov 2020 02:47:31 +0100 Subject: [PATCH 063/592] Update index.md --- index.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/index.md b/index.md index 1d9c4abd..26d1b159 100644 --- a/index.md +++ b/index.md @@ -1,6 +1,8 @@ +```eval_rst .. image:: https://raw.githubusercontent.com/helloSystem/hello/1d1e69be8a689c5e0a176df821c14f0b49b241a4/branding/hello_variation.svg :align: center :width: 300px +``` # hello From d7f000020e15adeeed075d79abc6e627911d6459 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 30 Nov 2020 19:39:48 +0100 Subject: [PATCH 064/592] Restructure --- Makefile | 5 +- {user => developer}/acknowledgements.md | 2 +- developer/building.md | 91 +++++++++++++++++++ developer/distributions.md | 11 +++ developer/index.md | 3 + index.md | 4 +- requirements.txt | 10 ++ user/components.md | 7 +- user/components/applications.md | 11 +++ user/components/applications/chromium.md | 12 +++ user/components/preferences.md | 11 +++ .../preferences/boot-environments.md | 47 ++++++++++ user/components/preferences/desktop.md | 15 +++ user/components/preferences/shortcuts.md | 29 ++++++ user/components/system.md | 11 +++ user/components/system/dock.md | 17 ++++ user/components/system/filer.md | 33 +++++++ user/components/system/launch.md | 39 ++++++++ user/components/{ => system}/menu.md | 0 user/components/utilities.md | 11 +++ .../components/utilities/create-live-media.md | 32 +++++++ user/components/utilities/install.md | 46 ++++++++++ user/components/windows.md | 17 ++++ user/index.md | 1 - 24 files changed, 456 insertions(+), 9 deletions(-) rename {user => developer}/acknowledgements.md (98%) create mode 100644 developer/building.md create mode 100644 developer/distributions.md create mode 100644 requirements.txt create mode 100644 user/components/applications.md create mode 100644 user/components/applications/chromium.md create mode 100644 user/components/preferences.md create mode 100644 user/components/preferences/boot-environments.md create mode 100644 user/components/preferences/desktop.md create mode 100644 user/components/preferences/shortcuts.md create mode 100644 user/components/system.md create mode 100644 user/components/system/dock.md create mode 100644 user/components/system/filer.md create mode 100644 user/components/system/launch.md rename user/components/{ => system}/menu.md (100%) create mode 100644 user/components/utilities.md create mode 100644 user/components/utilities/create-live-media.md create mode 100644 user/components/utilities/install.md create mode 100644 user/components/windows.md diff --git a/Makefile b/Makefile index d4bb2cbb..ce46b206 100644 --- a/Makefile +++ b/Makefile @@ -12,7 +12,10 @@ BUILDDIR = _build help: @$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O) -.PHONY: help Makefile +watch: + sphinx-autobuild "$(SOURCEDIR)" "$(BUILDDIR)" --ignore "*__jb*__*" + +.PHONY: help Makefile watch # Catch-all target: route all unknown targets to Sphinx using the new # "make mode" option. $(O) is meant as a shortcut for $(SPHINXOPTS). diff --git a/user/acknowledgements.md b/developer/acknowledgements.md similarity index 98% rename from user/acknowledgements.md rename to developer/acknowledgements.md index 59219461..fa61a4c7 100644 --- a/user/acknowledgements.md +++ b/developer/acknowledgements.md @@ -27,7 +27,7 @@ __[pkgdemon](https://github.com/pkgdemon)__ [https://www.freebsdfoundation.org/](https://www.freebsdfoundation.org/) * Gave permission to use the trademarks in the 'Install FreeBSD' utility -## Slawomir Wojciech Wojtczak +## Sławomir Wojciech Wojtczak __[vermaden](https://github.com/vermaden)__ @vermaden on twitter * Provided helpful feedback and configuration advice diff --git a/developer/building.md b/developer/building.md new file mode 100644 index 00000000..cc8c6286 --- /dev/null +++ b/developer/building.md @@ -0,0 +1,91 @@ +# Building the Live ISO + +helloSystem get assembled from upstream FreeBSD components, components in the FreeBSD packages system, and custom components from the helloSystem repositories. + +helloSystem is not a derivative (fork) of FreeBSD (like e.g., GhostBSD), but strives to be "real FreeBSD" as far as possible. Hence, helloSystem does not build all source code, but relies on binaries provided by FreeBSD wherever possible. + +helloSystem is distributed as an installable Live ISO file. This file gets built by the [hello Live ISO builder](https://github.com/helloSystem/ISO). + +Continuous builds of the ISO get produced automatically on a continuous integration (CI) system for each git commit. + +However, it is also possible to build the ISO locally, which is especially handy for testing and development. + +## System requirements for building + +* A FreeBSD or helloSystem installed on the computer. The FreeBSD version needs to match the FreeBSD version of the helloSystem ISO being built (e.g., `12.2-RELEASE`) +* 2 GHz dual core processor +* 4 GiB RAM (system memory) +* 50 GB of hard-drive space +* Either a CD-RW/DVD-RW drive or a USB port for writing the Live media +* A fast internet connection + +## Building the Live ISO + +``` +git clone https://github.com/helloSystem/ISO +cd ISO +sudo ./build.sh hello +``` + +The resulting Live ISO will be located at `/usr/local/furybsd/iso/`. + +## Writing Live Media to USB drive + +``` +sudo dd if=/usr/local/furybsd/iso/FuryBSD-12.1-XFCE.iso of=/dev/daX bs=4m status=progress +``` + +Replace `daX` with the respective device name. + +``` .. warning:: + This will overwrite the entire contents of the selected device. Take extra caution when determining the device name. + + This operation cannot be undone. +``` + +For end users, there is the __Create Live Media__ application that can conveniently download and write Live Media with a graphical user interface. + +## Burning Live Media to DVD + +You can use the `cdrecord` command line tool to burn Live Media to DVD. + +``` +pkg install cdrtools +cdrecord /usr/local/furybsd/iso/.iso +``` + +## Customizing the Live ISO + +helloSystem is built in a way that makes it trivially easy to apply your own changes to it. + +### Different desktop environments + +Simply replace `hello` with the name of one of the supported desktop environments, such as + +* cinnamon +* gnome +* kde +* openbox +* xfce + +While the resulting image will be built on the same infrastructure, those will not be helloSystem builds and are not supported by the project. Still, the community may find them useful. + +### Customizing the set of packages + +To add or remove packages, edit `settings/packages.` and rebuild the image. Substitute `` with `hello` or one of the desktop environments mentioned above. + +### Customizing configuration + +Configuration is applied using _transient packages_ that get generated on-the-fly from the contents of the `overlays/` directory. + +* Overlays for the boot disk are stored in `overlays/boot` +* Overlays for the initial ramdisk are stored in `overlays/ramdisk` +* Overlays for the main filesystem are stored in `overlays/uzip//files/`. Note that to be included in a build, the overlay called `` must be listed in `settings/overlays.`. Substitute `` with `hello` or one of the desktop environments mentioned above. + +For example, a file that is supposed to appear in `/usr/local/bin/app` on the main filesystem could be stored in `overlays/uzip/hello/files/usr/local/bin/app`. + +### Customizing the build script + +If a file called `settings/script.` exists, then it will be executed during the build. Substitute `` with `hello` or one of the desktop environments mentioned above. For building helloSystem, `settings/script.hello` performs actions such as installing applications that are not coming from FreeBSD packages, setting the wallpaper, installing fonts that are not coming from FreeBSD, and so on. + +All desktop-specific build steps should go into this file. diff --git a/developer/distributions.md b/developer/distributions.md new file mode 100644 index 00000000..11e429a2 --- /dev/null +++ b/developer/distributions.md @@ -0,0 +1,11 @@ +# Note to distributions + +helloSystem is designed, developed, and tested as an integrated operating system. It is not a desktop environment designed to run on various operating systems or distributions. + +Focusing on building one coherent operating system greatly simplifies the code, the development and testing process, and ultimately increases quality. + +__Please do not try to include helloSystem in third-party distributions.__ While you are free to use components from helloSystem for your own projects as far as their respective licenses permit, please be aware that we may not always be interested in contributions that increase portability, especially if they would incrase complexity significantly. + +__Please do not call your derivatives "hello" or "helloSystem"__. In order to keep support and maintenance burden low, please give clearly distinguishable names to your derivatives. + +Please do not hesitate to contact the team if you have questions regarding this policy. diff --git a/developer/index.md b/developer/index.md index 182dbe8f..8c97ca2c 100644 --- a/developer/index.md +++ b/developer/index.md @@ -6,5 +6,8 @@ :glob: contributing + building + distributions + acknowledgements contact ``` diff --git a/index.md b/index.md index 26d1b159..4a972239 100644 --- a/index.md +++ b/index.md @@ -4,12 +4,12 @@ :width: 300px ``` -# hello - ```eval_rst .. centered:: Willkommen • Welcome • 欢迎 • Bienvenue • Benvenuto • Bienvenido • ようこそ • Mabuhay • Välkommen • أهلا وسهلا • Добро пожаловать • Merhaba • Bonvenon • 歡迎光臨 ``` +# hello + __hello__ (also known as __helloSystem__) is a desktop system for creators with focus on simplicity, elegance, and usability. Its design follows the "Less, but better" philosophy. It is intended as a system for "mere mortals", welcoming to switchers from the Mac. [FreeBSD](https://www.freebsd.org/) is used as the core operating system. Please refer to [https://github.com/helloSystem/hello](https://github.com/helloSystem/hello) if you would like to learn more about the ideas and principles behind hello. ```eval_rst diff --git a/requirements.txt b/requirements.txt new file mode 100644 index 00000000..85d53a0e --- /dev/null +++ b/requirements.txt @@ -0,0 +1,10 @@ +wheel +sphinx>=3.3.0 +sphinx_rtd_theme +sphinx-autobuild +sphinx_git +#sphinx-reredirects +sphinxext-rediraffe +# will only work once a new release is made after sphinx-rtd-theme 0.5.0 +sphinx-last-updated-by-git +recommonmark diff --git a/user/components.md b/user/components.md index dd573c1b..1b389a1f 100644 --- a/user/components.md +++ b/user/components.md @@ -1,12 +1,11 @@ -# Components +# Getting to know the system -hello conststs of the following components, each of which are described in this section: +helloSystem conststs of the following key components, each of which are described in this section: ```eval_rst .. toctree:: - :caption: Components :maxdepth: 2 :glob: - + components/* ``` diff --git a/user/components/applications.md b/user/components/applications.md new file mode 100644 index 00000000..5161f1ab --- /dev/null +++ b/user/components/applications.md @@ -0,0 +1,11 @@ +# Applications + +helloSystem comes with the following applications, each of which are described in this section: + +```eval_rst +.. toctree:: + :maxdepth: 2 + :glob: + + applications/* +``` diff --git a/user/components/applications/chromium.md b/user/components/applications/chromium.md new file mode 100644 index 00000000..a746ffbb --- /dev/null +++ b/user/components/applications/chromium.md @@ -0,0 +1,12 @@ +# Chromium + +Chromium is the web browser that comes with helloSystem by default. + +Upon first start of the Chromium browser, the following extensions are automatically installed from [https://chrome.google.com/webstore/](https://chrome.google.com/webstore/) to increase privacy and convenience: + +* __I don't care about cookies__: Tries to remove annoying cookie popups automatically. Visit [https://www.i-dont-care-about-cookies.eu](https://www.i-dont-care-about-cookies.eu) to learn more about this extension. Deactivate or uninstall this extension if you would like to see cookie popups +* __uBlock Origin__: Tries to block unwanted adversising and tracking. Visit [https://github.com/gorhill/uBlock](https://github.com/gorhill/uBlock) to learn more about this extension. Deactivate or uninstall this extension if you would like to see adversising and allow trackers to track you. + +You can uninstall those extensions at any time from within Chromomium. + +If wou would like Chromium not to install those extensions from the Chrome Web Store in the first place, remove the files in `/usr/local/share/chromium/extensions/*.json` prior to launching Chromium for the first time. diff --git a/user/components/preferences.md b/user/components/preferences.md new file mode 100644 index 00000000..792f9d6d --- /dev/null +++ b/user/components/preferences.md @@ -0,0 +1,11 @@ +# Preferences + +helloSystem comes with the following preferences applications, each of which are described in this section: + +```eval_rst +.. toctree:: + :maxdepth: 2 + :glob: + + preferences/* +``` diff --git a/user/components/preferences/boot-environments.md b/user/components/preferences/boot-environments.md new file mode 100644 index 00000000..0dd629aa --- /dev/null +++ b/user/components/preferences/boot-environments.md @@ -0,0 +1,47 @@ +# Boot Environments + +_Boot Environments_ are bootable clones of snapshots of the working system. Boot Environments allow you to create a safe failback Boot Environmnent before upgrading or making major changes to the system. + +Other applications may create Boot Environmnents automatically before performing critical operations such as major operating system upgrades. + +``` .. warning:: + Boot Environments by default do not cover all locations, such as `/home` where your personal data is usually stored. +``` + +The __Boot Environments__ preferences application lets you view, create, remove, mount, and boot into Boot Environments. + +``` .. note:: + Boot Environments functionality cannot be used when the system is running from Live media. It can only be used when the system has been installed to a disk. +``` + +## Viewing Boot Environments + +Open the __Boot Environments__ preferences application. If you have a user password set, you will be asked to enter your credentials. Only users in whe administrative group (`wheel`) can use the Boot Environments application by default. + +You will see the available Boot Environments. + +## Creating Boot Environments + +To create a new Boot Environment, click "New..." and enter a name for the new Boot Environment. + +## Removing Boot Environments + +Select a Boot Environment by clicking on it, and then press "Remove". Note that you cannot remove the currently active Boot Environment. + +## Mounting Boot Environments + +You can make available, or "mount", existing Boot Environments, e.g., in order to inspect them or to copy files from there. + +To do this, select a Boot Environment by clicking on it, and then press "Mount". Note that you cannot mout the currently active Boot Environment since it is already mounted at `/`. + +The selected Boot Environment will be mounted, and a Filer window will be opened at the mountpoint of the Boot Environment. + +## Booting into a Boot Environment + +Activate a Boot Environment by checking its checkbox, and then press "Restart...". The computer will restart into the selected Boot Environment. + +## More Information + +Advanced users can use the `bectl` command on the command line, which the __Boot Environments__ preferences application is using under the hood. + +For more information regarding Boot Environments, please refer to the [ZFS Boot Environments](https://bsd-pl.org/assets/talks/2018-07-30_1_S%C5%82awomir-Wojciech-Wojtczak_ZFS-Boot-Environments.pdf) presentation by Sławomir Wojciech Wojtczak. diff --git a/user/components/preferences/desktop.md b/user/components/preferences/desktop.md new file mode 100644 index 00000000..b65a55bf --- /dev/null +++ b/user/components/preferences/desktop.md @@ -0,0 +1,15 @@ +# Desktop + +The __Desktop__ preferences application allows you do customize the behavior of your computer's desktop. + +## Background + +In this section of the __Desktop__ preferences application, you can select a background color and an optional background image. If an image is selected, you can choose how it should be scaled on the screen. + +## Label Text + +In this section of the __Desktop__ preferences application, you can select a font and color for the text beneath icons on the desktop. + +## Advanced + +Under the __advanced__ tab of the __Desktop__ preferences application, advanced users can adjust additional aspects of the behavior of the desktop. Most users should leave the defaults. This tab may go away in a future version. diff --git a/user/components/preferences/shortcuts.md b/user/components/preferences/shortcuts.md new file mode 100644 index 00000000..74da44ee --- /dev/null +++ b/user/components/preferences/shortcuts.md @@ -0,0 +1,29 @@ +# Shortcut Keys + +The __Shortcut Keys__ preferences application lets you view and edit system-wide keyboard shortcuts. + +A __shortcut__ is a key or key combination you can press to invoke a defined action on your computer. Shortcuts can be defined by applications (per-application shortcuts), or can affect the whole system (system-wide shortcuts). + +``` .. note:: + The Shortcut Keys preferences application lets you view and edit system-wide keyboard shortcuts only, not per-application shortcuts. Some applications contain similar functionality inside the respective application to view and edit per-application keyboard shortcuts. +``` + +## Default shortcuts + +Open the __Shortcut Keys__ preferences application to view the default system-wide shortcuts. + +Notable default shortcuts include: + +* Press __Alt+Space__ to __search in the Menu__ (e.g., to launch applications or to execute commands in the frontmost application) +* Press __Ctrl+Alt+Esc__ and click on an application window to __forcefully quit an application__ that is malfunctioning +* Press __Alt+Shift+3__ or the __PrtScn__ key on your keyboard to __take a screenshot__ + +This list is not exhaustive. + +## Viewing shortcuts + +For a complete list of system-wide shortcuts, please open the __Shortcut Keys__ preferences application to view the default shortcuts. + +## Editing shortcuts + +Use the buttons in the __Shortcut Keys__ preferences application to add, remove, and modify system-wide shortcuts. diff --git a/user/components/system.md b/user/components/system.md new file mode 100644 index 00000000..a54d3435 --- /dev/null +++ b/user/components/system.md @@ -0,0 +1,11 @@ +# System components + +helloSystem comes with the following system components, each of which are described in this section: + +```eval_rst +.. toctree:: + :maxdepth: 2 + :glob: + + system/* +``` diff --git a/user/components/system/dock.md b/user/components/system/dock.md new file mode 100644 index 00000000..2ddfab88 --- /dev/null +++ b/user/components/system/dock.md @@ -0,0 +1,17 @@ +# Dock + +The __Dock__ is a quick way to launch the most commonly used applications, and a way to see which applications are running at a glance. + +It typically sits at the bottom of the screen. + +## Launching applications + +To launch an application, click on it in the Dock. + +## Seeing running applications + +Running applications are marked with a dot below the application icon in the Dock. + +## Keeping applications in the Dock + +To keep an application in the Dock even if it is not running, click on its icon in the Dock with the right mouse key, and select "Pin" from the context menu. diff --git a/user/components/system/filer.md b/user/components/system/filer.md new file mode 100644 index 00000000..8cbdb097 --- /dev/null +++ b/user/components/system/filer.md @@ -0,0 +1,33 @@ +# Filer + +__Filer__ is the application that you can use to manage objects like files, folders, and applications on your computer. + +Filer can perform typical tasks of a file manager: +* Open files and folders +* Create, move, and delete files and folders + +In helloSystem, many tasks are done in the Filer that would require extra tools in other operating systems. For example, you can use the Filer to +* Launch applications (instead of using a dedicated launcher) +* Make applications available to the system (instead of using a package manager or compiling from source) +* Remove applications (instead of using a package manager) +* Accessing files on remote computers (instead of using a dedicated application that can access files over ssh/sftp) + +## Launching applications + +To launch an application, double-click it in Filer. In case you double-click on a binary that is lacking the execute permission, a dialog will ask you whether you would like to make the binary executable. + +## Making applications available to the system + +Applications for helloSystem typically come as application bundles. An application bundle looks like a file but is actually stored as a directory on disk. To make an application available to the system, simply move or copy it to one of the well-known locations for applications, such as `/Applications` for system-wide applications, or `~/Applications` (in your home directory) for per-user applications. + +In addition to applications specifically offered for helloSystem, advanced users can use the tools provided by FreeBSD to compile applications from the ports tree, and/or to install FreeBSD packages. + +## Removing applications + +To remove an application from the system, move it to the Trash. + +## Accessing files on remote computers + +Computers on the local area network that are offering access via SFTP are automatically discovered and are shown in the "Network" area of Filer. Double-click on a network directory to access it. You will be asked to provide valid credentials (username, password) of an account on the remote computer. For this to work, computers need to provide SFTP services and announce them over dns-sd (Zeroconf, Bonjour). + +It is also possible to access files on computers that are not on the local area network. To do so, enter `sftp://hostname.tld` in the address bar of Filer and press the Enter key. diff --git a/user/components/system/launch.md b/user/components/system/launch.md new file mode 100644 index 00000000..aaade05d --- /dev/null +++ b/user/components/system/launch.md @@ -0,0 +1,39 @@ + # launch + + ```eval_rst + .. epigraph:: + + "It’s not just what it looks like and feels like. Design is how it works." + + -- Steve Jobs +``` + + The `launch` command is used to launch graphical applications on helloSystem. When you select an application from the [Menu](menu.md) or the [Dock](dock.md), then the `launch` command is invoked to actually launch the application. + + ```eval_rst + .. hint:: + + As an end user who is using the graphical user interface exclusively, you will not need to interact with the `launch` command directly and can skip this section. + ``` + + + + ## Background + + On UNIX systems, applications are typically launched by entering the name of the executable file, which is searched in a fixed list of directories determined by the `$PATH` environment variable. + + Many graphical desktop environments use `.desktop` files to integrate applications with the system. While this has traditionally worked well for installed applications, it does not work well for dynamically changing applications that are moved in the filesystem, such as `.app` bundles or `.AppDir` directories. Also, it does not handle mutliple versions of the same application gracefully. Hence, helloSystem uses the `launch` command to launch graphical applications. This has the following advantages: + + * You do not need to know the path to the application to be launched, even if the applciation is not on the `$PATH` + * If something goes wrong and the application cannot be launched, then a graphical error message will be shown on the screen + * If multiple versions of an application are available on the system, the most recent one will be launched automatically (unless specified otherwise by the user) __(to be implemented)__ + + ## Using the `launch` command + + Whenever possible, graphical applications should be launched through the `launch` command on helloSystem. + + There are several ways in which the `launch` command can be invoked: + + * `launch /Applications/Filer.app` + * `launch Filer.app` + * `launch Filer` diff --git a/user/components/menu.md b/user/components/system/menu.md similarity index 100% rename from user/components/menu.md rename to user/components/system/menu.md diff --git a/user/components/utilities.md b/user/components/utilities.md new file mode 100644 index 00000000..1b1a8de6 --- /dev/null +++ b/user/components/utilities.md @@ -0,0 +1,11 @@ +# Utilities + +helloSystem comes with the following utilities, each of which are described in this section: + +```eval_rst +.. toctree:: + :maxdepth: 2 + :glob: + + utilities/* +``` diff --git a/user/components/utilities/create-live-media.md b/user/components/utilities/create-live-media.md new file mode 100644 index 00000000..898a7ffe --- /dev/null +++ b/user/components/utilities/create-live-media.md @@ -0,0 +1,32 @@ +# Create Live Media + +A __Live Medium__ is a storage device that can be used to start your computer with the helloSystem without having to install helloSystem to the internal storage of the computer. It allows you to try out helloSystem without making any changes to the software installed on your computer. Almost all functionality of helloSystem is available in Live mode, with very few exceptions. Changes being made, including files created, will be discarded when the system is shut down or retarted. + +The __Create Live Media__ utility provides an easy and convenient way to create bootable Live Media on devices such as USB sticks. It downloads and writes Live ISOs to devices in one go. + +This is useful if you are running helloSystem and would like to write a newer (or experimental) version of the system to a bootable storage device. + +## Prerequisites + +In order to create a Live medium, you need +* A computer running any version of helloSystem with the __Create Live Media__ utility +* A fast internet connection (a typical download is around 2 GiB) +* A suitable external storage device, e.g., a USB3 device. USB2 devices can be used but performance may be degraded. On some systems, other storage media such as SD cards or microSD cards can be used. Consult the documentation that came with your computer to determine which type of media can be used to start your computer. + +``` .. note:: + The **Create Live Media** utility cannot be used on other operating systems such as Windows, Linux, or macOS. + + If you would like to create Live Media for helloSystem using one of those operating systems, you can use applications that can write images to USB storage devices, such as [balenaEtcher](https://www.balena.io/etcher/). +``` + +## Downloading and writing Live Media + +The __Create Live Media__ utility downloads and writes a Live ISO image in one go to a storage medium. Open the __Create Live Media__ utility and follow the instructions on screen. + +``` .. warning:: + The **Create Live Media** utility will overwrite the entire contents of the selected device, including all of its pre-existing partitions. Take extra caution when selecting the target device. + + This operation cannot be undone. +``` + +Once the image has been written to the device successfully, you can restart your computer to start from the Live Medium, or remove the device and insert it into another computer to start that computer from the Live Medium. diff --git a/user/components/utilities/install.md b/user/components/utilities/install.md new file mode 100644 index 00000000..0ee19a69 --- /dev/null +++ b/user/components/utilities/install.md @@ -0,0 +1,46 @@ +# Install FreeBSD + +Once you have tried out helloSystem from the live medium, you may want to install the system to the hard disk in your computer, or an externally attached storage device. + +The __Install FreeBSD__ utility lets you install helloSystem on your computer from a running Live system. + +``` .. note:: + The utility is called **Install FreeBSD** to signify that helloSystem contains a largely unmodified FreeBSD core operating system. It might be renamed "Install helloSystem" in the future. +``` + +When you install helloSystem using the __Install FreeBSD__ utility, the installed system will behave like the Live system in most aspects. + +## Prerequisites + +* A bootable helloSystem Live Medium +* A computer capable of starting from the Live Medium +* An internal or external storage device with 8 GB of storage space. More space is highly recommended to allow for adding applications and documents + +## Installing helloSystem + +Start your computer from a helloSystem Live Medium. Open the __Install FreeBSD__ utility and follow the instructions on screen. + +The installer starts by presenting a summary of FreeBSD. Click on "Continue". To install the software, you must agree to the terms of the software license agreemement. Click on "Continue" to proceed. Click on a destination disk on which the operating system should be installed. A warning will inform you that the entire disk will be erased. Confirm whether you want to do this by clicking on the appropriate button. + +``` .. warning:: + The **Install FreeBSD** utility will overwrite the entire contents of the selected device, including all of its pre-existing partitions. Take extra caution when selecting the target device. + + This operation cannot be undone. +``` + +If you are really sure that you have selected the correct device, click "Continue". + +In the next step, you will create an account for the main user of the computer. The information entered here is used to identify the main user of the computer. This user will have administrative permissions (will be member of the `wheel` group). + +* In the field __Full Name__, enter your first name(s), followed by a blank, followed by your last name. Example: `John Doe`. This field can be left blank if you prefer not to provide your full name +* The field __Username__ will be automatically populated with a suggested username. It must not contain any special characters such as blanks. You can override the suggested default if you like. Example: `jdoe` +* Enter a password into the __Password__ field. Repeat the same password in the __Retype Password__ field. These fields can be left blank if you prefer not to use a password, but this will mean that anyone with access to your computer will be able to log in, and you will not be able to log in over the network +* The field __Computer Name__ will be automatically populated with a suggested computer name (hostname). This name will be used to identify your computer on the local area network. It must not contain any special characters such as blanks. You can override the suggested default if you like. Example: `Johns-TravelMate-B117-M` +* Check the checkbox __Enable users to log in over the network (ssh)__ if you would like to allow accessing the computer remotely. By default, this requires a passwort to be set for the computer account +* Check the checkbox __Set time zone based on current location__ if you would like timezone on the installed system to be set automatically. This feature requires an active internet connection + +Click "Continue" to proceed. The system will be installed to the selected disk. This process typically takes a couple of minutes depending on your system configuration, during which a progress bar will be shown. + +You can click on "Installer Log" at any time to see a detailed log of the actions performed by the installer and details on any possible errors. + +Once the installation has completed, remove the Live medium from your computer and click the "Restart" button to start the newly installed system. diff --git a/user/components/windows.md b/user/components/windows.md new file mode 100644 index 00000000..95fd7068 --- /dev/null +++ b/user/components/windows.md @@ -0,0 +1,17 @@ +# Windows + +helloSystem provides a graphical desktop experience that should be familiar to users of existing desktop operating systems. + +## Traffic lights + +Windows contain three buttons, called "traffic lights": + +* __Red__: Click this button to close the window +* __Yellow__: Click this button to hide (minimize) the window. To make the window appear again, click on its icon in the Dock, or select "Unhide all" from the System menu +* __Green__: Click this button to make the window use the full screen real estate available (maximize). Click this button again to resize the window to its previous size + +## Resizing windows + +Place the mouse cursor in any edge of the window. The cursor will change. Click and drag the mouse to resize the window. + +Alternatively, click in the window title with the right-hand mouse button and select "Resize" from the menu, then drag the mouse to resize the window. diff --git a/user/index.md b/user/index.md index 958aa658..73c8bae8 100644 --- a/user/index.md +++ b/user/index.md @@ -9,5 +9,4 @@ components troubleshooting feedback - acknowledgements ``` From 73810414adf5ca66e311945f68f6d1bc1a51f28b Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 30 Nov 2020 19:40:35 +0100 Subject: [PATCH 065/592] Delete make.bat [ci skip] --- make.bat | 35 ----------------------------------- 1 file changed, 35 deletions(-) delete mode 100644 make.bat diff --git a/make.bat b/make.bat deleted file mode 100644 index 2119f510..00000000 --- a/make.bat +++ /dev/null @@ -1,35 +0,0 @@ -@ECHO OFF - -pushd %~dp0 - -REM Command file for Sphinx documentation - -if "%SPHINXBUILD%" == "" ( - set SPHINXBUILD=sphinx-build -) -set SOURCEDIR=. -set BUILDDIR=_build - -if "%1" == "" goto help - -%SPHINXBUILD% >NUL 2>NUL -if errorlevel 9009 ( - echo. - echo.The 'sphinx-build' command was not found. Make sure you have Sphinx - echo.installed, then set the SPHINXBUILD environment variable to point - echo.to the full path of the 'sphinx-build' executable. Alternatively you - echo.may add the Sphinx directory to PATH. - echo. - echo.If you don't have Sphinx installed, grab it from - echo.http://sphinx-doc.org/ - exit /b 1 -) - -%SPHINXBUILD% -M %1 %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O% -goto end - -:help -%SPHINXBUILD% -M help %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O% - -:end -popd From 6ff5959cccd5ca85ebaf29d99ec2b74c454d0832 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 30 Nov 2020 19:50:22 +0100 Subject: [PATCH 066/592] Local development server [ci skip] --- README.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/README.md b/README.md index 5c79725b..44bf31af 100644 --- a/README.md +++ b/README.md @@ -6,3 +6,17 @@ It uses Sphinx, recommonmark, and GitHub Actions to produce documentation from t * https://stackoverflow.com/a/62967771 * https://recommonmark.readthedocs.io/en/latest/ + +## Local development server + +Use a local development server that regenerates the output whenever the input changes: + +``` +sudo pkg install -y py37-pip +pip-3.7 install -r requirements.txt +export GITHUB_REPOSITORY="helloSystem/docs" +export PATH=~/.local/bin/:$PATH +make watch +``` + +Now open http://127.0.0.1:8000 in a web browser. It will be regenerated and refreshed whenever one of the input files changes. From c23d6e7e6658d81c5453ae42b0e0ae0c6d8abf51 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 30 Nov 2020 19:52:17 +0100 Subject: [PATCH 067/592] Update acknowledgements.md --- developer/acknowledgements.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/developer/acknowledgements.md b/developer/acknowledgements.md index fa61a4c7..248d941c 100644 --- a/developer/acknowledgements.md +++ b/developer/acknowledgements.md @@ -1,6 +1,6 @@ # Acknowledgements -Grateful acknowledged is made to the following persons and organizations. +Grateful acknowledgement is made to the following persons and organizations. Mentions roughly in the order of first involvement with the project. From 572a7c927077e7d6a6394efc706b13dcd044cb21 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 30 Nov 2020 20:34:27 +0100 Subject: [PATCH 068/592] Add Autostart --- user/components/autostart.md | 9 +++++++++ 1 file changed, 9 insertions(+) create mode 100644 user/components/autostart.md diff --git a/user/components/autostart.md b/user/components/autostart.md new file mode 100644 index 00000000..ad6e3bdb --- /dev/null +++ b/user/components/autostart.md @@ -0,0 +1,9 @@ +# Autostart + +The __Autostart__ mechanism provides an easy way to automatically start applications whenever the computer is started (to be precise, when a user is logged into a graphical desktop session). Applications can be either `.app` bundles or `.AppDir` directories. + +* __System-wide autostart__: Place applications (or symlinks to applications) into the `/Applications` folder to have them started for all users of the computer + +* __Per-user autostart__: Place applications (or symlinks to applications) into the `~/Applications` folder (in your home folder) to have them started for all users of the computer. You can create the folder if it does not exist yet + +The `launch` command is invoked for each of those applications and launches the applications. From 25ecfdec58c0344172188b33edc684901347a00d Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 30 Nov 2020 20:36:44 +0100 Subject: [PATCH 069/592] 'enable_auto_toc_tree': False --- conf.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/conf.py b/conf.py index 5298a2b5..8e2971ec 100644 --- a/conf.py +++ b/conf.py @@ -76,7 +76,7 @@ github_doc_root = 'https://' + os.environ['GITHUB_REPOSITORY'].split("/")[0] + '.github.io/' + os.environ['GITHUB_REPOSITORY'].split("/")[1] + '/' def setup(app): app.add_config_value('recommonmark_config', { - 'enable_auto_toc_tree': True, + 'enable_auto_toc_tree': False, 'url_resolver': lambda url: github_doc_root + url, 'auto_toc_tree_section': 'Contents', }, True) From 8e958f552fbad52069e662b67c4fd38e4645a60d Mon Sep 17 00:00:00 2001 From: TheAssassin Date: Mon, 30 Nov 2020 20:43:20 +0100 Subject: [PATCH 070/592] Several fixes (#2) * No need for duplicate toctrees * Ignore all Python bytecode files * Import make.sh from docs.appimage.org Makes building locally a lot easier. * Improve Python config code --- .gitignore | 3 ++- conf.py | 28 +++++++++++++++++++++------- index.md | 9 +-------- make.sh | 27 +++++++++++++++++++++++++++ 4 files changed, 51 insertions(+), 16 deletions(-) create mode 100755 make.sh diff --git a/.gitignore b/.gitignore index 26485b04..66c29f36 100644 --- a/.gitignore +++ b/.gitignore @@ -1,5 +1,6 @@ __pycache__ -*.pyc +*.py[c|o] *.swp /_build /doctrees +.venv/ diff --git a/conf.py b/conf.py index 8e2971ec..4675339f 100644 --- a/conf.py +++ b/conf.py @@ -10,12 +10,16 @@ # add these directories to sys.path here. If the directory is relative to the # documentation root, use os.path.abspath to make it absolute, like shown here. # -# import os + +import os + # import sys # sys.path.insert(0, os.path.abspath('.')) + import recommonmark from recommonmark.transform import AutoStructify + # -- Project information ----------------------------------------------------- project = 'helloSystem' @@ -59,12 +63,16 @@ # html_theme = 'sphinx_rtd_theme' +# specify a fallback value for local builds +# FIXME: find a way to use relative URLs instead of absolute URLs to better support URLs +GITHUB_REPOSITORY = os.environ.get("GITHUB_REPOSITORY", "helloSystem/docs") +GITHUB_REPO_OWNER, GITHUB_REPO_NAME = GITHUB_REPOSITORY.split("/")[0:2] + # Display "Edit on GitHub" -import os html_context = { 'display_github': True, - 'github_user': os.environ['GITHUB_REPOSITORY'].split("/")[0], - 'github_repo': os.environ['GITHUB_REPOSITORY'].split("/")[1], + 'github_user': GITHUB_REPO_OWNER, + 'github_repo': GITHUB_REPO_NAME, 'github_version': 'main/', } @@ -73,11 +81,17 @@ # so a file named "default.css" will overwrite the builtin "default.css". html_static_path = ['_static'] -github_doc_root = 'https://' + os.environ['GITHUB_REPOSITORY'].split("/")[0] + '.github.io/' + os.environ['GITHUB_REPOSITORY'].split("/")[1] + '/' +github_doc_root = 'https://' + GITHUB_REPO_OWNER + '.github.io/' + GITHUB_REPO_NAME + '/' + def setup(app): - app.add_config_value('recommonmark_config', { + app.add_config_value( + 'recommonmark_config', + { 'enable_auto_toc_tree': False, 'url_resolver': lambda url: github_doc_root + url, 'auto_toc_tree_section': 'Contents', - }, True) + }, + True + ) + app.add_transform(AutoStructify) diff --git a/index.md b/index.md index 4a972239..7f02cec1 100644 --- a/index.md +++ b/index.md @@ -18,12 +18,5 @@ __hello__ (also known as __helloSystem__) is a desktop system for creators with :maxdepth: 2 user/index -``` - -```eval_rst -.. toctree:: - :hidden: - :maxdepth: 2 - developer/index -``` +``` diff --git a/make.sh b/make.sh new file mode 100755 index 00000000..66e912d7 --- /dev/null +++ b/make.sh @@ -0,0 +1,27 @@ +#! /bin/bash + +set -e + +CUR_DIR=$(readlink -f $(dirname "$0")) + +cd "$CUR_DIR" + +VENV="$CUR_DIR"/.venv + +if [ ! -d "$VENV" ] || [ ! -e "$VENV"/bin/activate ]; then + echo $(tput bold)$(tput setaf 2)"Creating new virtual environment in $VENV"$(tput sgr0) + PYTHON=python3 + which python3.6 &>/dev/null && PYTHON=python3.6 + "$PYTHON" -m venv "$VENV" +fi + +source "$VENV"/bin/activate + +# this snippet should allow us to call pip install only if the requirements file has been touched +if [ ! -f "$VENV"/requirements.txt ] || [ $(sha256sum requirements.txt | cut -d' ' -f1) != $(sha256sum "$VENV"/requirements.txt | cut -d' ' -f1) ]; then + echo $(tput bold)$(tput setaf 2)"Requirements updated, reinstalling"$(tput sgr0) + cp requirements.txt "$VENV"/requirements.txt + pip install -U -r "$VENV"/requirements.txt +fi + +make "$@" From a4a99da89dbd0967274ff9f405440ad44dd74e07 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 30 Nov 2020 20:53:15 +0100 Subject: [PATCH 071/592] Fix typo [ci skip] --- user/components/applications/chromium.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/user/components/applications/chromium.md b/user/components/applications/chromium.md index a746ffbb..b80ec34b 100644 --- a/user/components/applications/chromium.md +++ b/user/components/applications/chromium.md @@ -7,6 +7,6 @@ Upon first start of the Chromium browser, the following extensions are automatic * __I don't care about cookies__: Tries to remove annoying cookie popups automatically. Visit [https://www.i-dont-care-about-cookies.eu](https://www.i-dont-care-about-cookies.eu) to learn more about this extension. Deactivate or uninstall this extension if you would like to see cookie popups * __uBlock Origin__: Tries to block unwanted adversising and tracking. Visit [https://github.com/gorhill/uBlock](https://github.com/gorhill/uBlock) to learn more about this extension. Deactivate or uninstall this extension if you would like to see adversising and allow trackers to track you. -You can uninstall those extensions at any time from within Chromomium. +You can uninstall those extensions at any time from within Chromium. If wou would like Chromium not to install those extensions from the Chrome Web Store in the first place, remove the files in `/usr/local/share/chromium/extensions/*.json` prior to launching Chromium for the first time. From fd2ba89064cec1b9fefd209717b6f038436e99aa Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 30 Nov 2020 22:23:49 +0100 Subject: [PATCH 072/592] Build epub and qthelp files --- README.md | 20 ++++++++++++++++++-- buildDocs.sh | 20 ++++++++++++++++---- requirements.txt | 1 + 3 files changed, 35 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index 44bf31af..59b1ae49 100644 --- a/README.md +++ b/README.md @@ -12,11 +12,27 @@ It uses Sphinx, recommonmark, and GitHub Actions to produce documentation from t Use a local development server that regenerates the output whenever the input changes: ``` -sudo pkg install -y py37-pip +sudo pkg install -y py37-pip gmake # on FreeBSD, e.g., on helloSystem pip-3.7 install -r requirements.txt export GITHUB_REPOSITORY="helloSystem/docs" export PATH=~/.local/bin/:$PATH -make watch +gmake watch ``` Now open http://127.0.0.1:8000 in a web browser. It will be regenerated and refreshed whenever one of the input files changes. + +## Local output generation + +One can also generate documentation in various output formats locally: + +``` +sudo pkg install -y py37-pip gmake # on FreeBSD, e.g., on helloSystem +pip-3.7 install -r requirements.txt +export GITHUB_REPOSITORY="helloSystem/docs" +export PATH=~/.local/bin/:$PATH +gmake html +gmake epub +gmake html +gmake qthelp +qmake # list more output formats +``` diff --git a/buildDocs.sh b/buildDocs.sh index 2e850d62..9889f632 100644 --- a/buildDocs.sh +++ b/buildDocs.sh @@ -18,9 +18,9 @@ set -x ################### apt-get update -apt-get -y install git rsync python3-pip +apt-get -y install git rsync python3-pip qttools5-dev-tools pip3 install setuptools wheel -pip3 install sphinx sphinx-autobuild sphinx-rtd-theme commonmark recommonmark +pip3 install sphinx sphinx-autobuild sphinx-rtd-theme commonmark recommonmark sphinxcontrib-qthelp ##################### # DECLARE VARIABLES # @@ -36,9 +36,21 @@ export SOURCE_DATE_EPOCH=$(git log -1 --pretty=%ct) # build our documentation with sphinx (see ./conf.py) # * https://www.sphinx-doc.org/en/master/usage/quickstart.html#running-the-build -make -C . clean -sphinx-build -b html . _build +make clean +make html +make epub +make qthelp +qcollectiongenerator _build/qthelp/*.qhcp +# sphinx-build -b html . _build # make -C ./docs html + +##################################### +# Upload outputs to GitHub Releases # +##################################### + +wget https://github.com/tcnksm/ghr/files/5247714/ghr.zip +unzip ghr.zip +./ghr -delete -t "${G_TOKEN}" -u "${GITHUB_ACTOR}" -r "${GITHUB_REPOSITORY}" -c "${GITHUB_SHA::7}" continuous _build/qthelp/*.qhc _build/epub/*.epub ####################### # Update GitHub Pages # diff --git a/requirements.txt b/requirements.txt index 85d53a0e..91898449 100644 --- a/requirements.txt +++ b/requirements.txt @@ -8,3 +8,4 @@ sphinxext-rediraffe # will only work once a new release is made after sphinx-rtd-theme 0.5.0 sphinx-last-updated-by-git recommonmark +sphinxcontrib-qthelp From 60303478bd3cf063b6e85420aac6ec85cdd194d5 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 30 Nov 2020 22:30:08 +0100 Subject: [PATCH 073/592] Do not build triggered by creating continuous tags --- .github/workflows/main.yml | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/.github/workflows/main.yml b/.github/workflows/main.yml index 436827a0..f4d468d0 100644 --- a/.github/workflows/main.yml +++ b/.github/workflows/main.yml @@ -7,9 +7,11 @@ on: # Triggers the workflow on push or pull request events but only for the main branch push: branches: [ main ] + tags-ignore: + - 'continuous' pull_request: branches: [ main ] - + # Allows you to run this workflow manually from the Actions tab workflow_dispatch: From 7ccc24eba3c1ef6b86de7a0b144849e40f0e6027 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 30 Nov 2020 22:32:10 +0100 Subject: [PATCH 074/592] qt5-default qt5-qmake --- buildDocs.sh | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/buildDocs.sh b/buildDocs.sh index 9889f632..42a212f4 100644 --- a/buildDocs.sh +++ b/buildDocs.sh @@ -18,7 +18,7 @@ set -x ################### apt-get update -apt-get -y install git rsync python3-pip qttools5-dev-tools +apt-get -y install git rsync python3-pip qttools5-dev-tools qt5-default qt5-qmake pip3 install setuptools wheel pip3 install sphinx sphinx-autobuild sphinx-rtd-theme commonmark recommonmark sphinxcontrib-qthelp From 0d89c62eaebb3d7e0953eec2c828fce7a185d365 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 30 Nov 2020 22:37:45 +0100 Subject: [PATCH 075/592] Use correct ghr --- buildDocs.sh | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/buildDocs.sh b/buildDocs.sh index 42a212f4..2df42f7b 100644 --- a/buildDocs.sh +++ b/buildDocs.sh @@ -48,9 +48,9 @@ qcollectiongenerator _build/qthelp/*.qhcp # Upload outputs to GitHub Releases # ##################################### -wget https://github.com/tcnksm/ghr/files/5247714/ghr.zip -unzip ghr.zip -./ghr -delete -t "${G_TOKEN}" -u "${GITHUB_ACTOR}" -r "${GITHUB_REPOSITORY}" -c "${GITHUB_SHA::7}" continuous _build/qthelp/*.qhc _build/epub/*.epub +wget "https://github.com/tcnksm/ghr/releases/download/v0.13.0/ghr_v0.13.0_linux_amd64.tar.gz" +tar xf ghr_*.tar.gz +./ghr_*/ghr -delete -t "${G_TOKEN}" -u "${GITHUB_ACTOR}" -r "${GITHUB_REPOSITORY}" -c "${GITHUB_SHA::7}" continuous _build/qthelp/*.qhc _build/epub/*.epub ####################### # Update GitHub Pages # From 77817de43875c0d310238966fa439777c23632e2 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 30 Nov 2020 22:54:31 +0100 Subject: [PATCH 076/592] Update buildDocs.sh --- buildDocs.sh | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/buildDocs.sh b/buildDocs.sh index 2df42f7b..e20b43fb 100644 --- a/buildDocs.sh +++ b/buildDocs.sh @@ -48,9 +48,11 @@ qcollectiongenerator _build/qthelp/*.qhcp # Upload outputs to GitHub Releases # ##################################### +mkdir -p out +cp continuous _build/qthelp/*.qhc _build/epub/*.epub out/ wget "https://github.com/tcnksm/ghr/releases/download/v0.13.0/ghr_v0.13.0_linux_amd64.tar.gz" tar xf ghr_*.tar.gz -./ghr_*/ghr -delete -t "${G_TOKEN}" -u "${GITHUB_ACTOR}" -r "${GITHUB_REPOSITORY}" -c "${GITHUB_SHA::7}" continuous _build/qthelp/*.qhc _build/epub/*.epub +./ghr_*/ghr -delete -t "${G_TOKEN}" -u "${GITHUB_ACTOR}" -r "${GITHUB_REPOSITORY}" -c "${GITHUB_SHA::7}" out/* ####################### # Update GitHub Pages # From d6e04b70dcfd431a7e104190d3a975754856c12f Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 30 Nov 2020 22:55:24 +0100 Subject: [PATCH 077/592] Clean pre-existing directory [ci skip] --- buildDocs.sh | 1 + 1 file changed, 1 insertion(+) diff --git a/buildDocs.sh b/buildDocs.sh index e20b43fb..f6bf2385 100644 --- a/buildDocs.sh +++ b/buildDocs.sh @@ -48,6 +48,7 @@ qcollectiongenerator _build/qthelp/*.qhcp # Upload outputs to GitHub Releases # ##################################### +rm -rf ./out/ || true mkdir -p out cp continuous _build/qthelp/*.qhc _build/epub/*.epub out/ wget "https://github.com/tcnksm/ghr/releases/download/v0.13.0/ghr_v0.13.0_linux_amd64.tar.gz" From 854e9c5323ccecef693d7ad05a728edf75a8ed8e Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 30 Nov 2020 23:01:56 +0100 Subject: [PATCH 078/592] Update buildDocs.sh --- buildDocs.sh | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/buildDocs.sh b/buildDocs.sh index f6bf2385..ed8e7541 100644 --- a/buildDocs.sh +++ b/buildDocs.sh @@ -50,10 +50,10 @@ qcollectiongenerator _build/qthelp/*.qhcp rm -rf ./out/ || true mkdir -p out -cp continuous _build/qthelp/*.qhc _build/epub/*.epub out/ +cp _build/qthelp/*.qhc _build/epub/*.epub out/ wget "https://github.com/tcnksm/ghr/releases/download/v0.13.0/ghr_v0.13.0_linux_amd64.tar.gz" tar xf ghr_*.tar.gz -./ghr_*/ghr -delete -t "${G_TOKEN}" -u "${GITHUB_ACTOR}" -r "${GITHUB_REPOSITORY}" -c "${GITHUB_SHA::7}" out/* +./ghr_*/ghr -delete -t "${G_TOKEN}" -u "${GITHUB_ACTOR}" -r "${GITHUB_REPOSITORY}" -c "${GITHUB_SHA::7}" continuous out/* ####################### # Update GitHub Pages # From e7ecad43c800aea7d31a89164408ce0fc6c9824a Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 30 Nov 2020 23:05:27 +0100 Subject: [PATCH 079/592] Update buildDocs.sh --- buildDocs.sh | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/buildDocs.sh b/buildDocs.sh index ed8e7541..aa7fe438 100644 --- a/buildDocs.sh +++ b/buildDocs.sh @@ -53,7 +53,7 @@ mkdir -p out cp _build/qthelp/*.qhc _build/epub/*.epub out/ wget "https://github.com/tcnksm/ghr/releases/download/v0.13.0/ghr_v0.13.0_linux_amd64.tar.gz" tar xf ghr_*.tar.gz -./ghr_*/ghr -delete -t "${G_TOKEN}" -u "${GITHUB_ACTOR}" -r "${GITHUB_REPOSITORY}" -c "${GITHUB_SHA::7}" continuous out/* +./ghr_*/ghr -delete -t "${G_TOKEN}" -u "${GITHUB_ACTOR}" -r "${GITHUB_REPOSITORY}" -c "${GITHUB_SHA::7}" continuous out/ ####################### # Update GitHub Pages # From 2b2bea76b64f4485fdc026cb08fb4015c57e6ee3 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 30 Nov 2020 23:23:55 +0100 Subject: [PATCH 080/592] Update buildDocs.sh --- buildDocs.sh | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/buildDocs.sh b/buildDocs.sh index aa7fe438..b0975b81 100644 --- a/buildDocs.sh +++ b/buildDocs.sh @@ -53,7 +53,9 @@ mkdir -p out cp _build/qthelp/*.qhc _build/epub/*.epub out/ wget "https://github.com/tcnksm/ghr/releases/download/v0.13.0/ghr_v0.13.0_linux_amd64.tar.gz" tar xf ghr_*.tar.gz -./ghr_*/ghr -delete -t "${G_TOKEN}" -u "${GITHUB_ACTOR}" -r "${GITHUB_REPOSITORY}" -c "${GITHUB_SHA::7}" continuous out/ +GH_USER=$(echo "${GITHUB_REPOSITORY}" | cut -d "/" -f 1) +GH_REPO=$(echo "${GITHUB_REPOSITORY}" | cut -d "/" -f 2) +./ghr_*/ghr -delete -t "${G_TOKEN}" -u "${GH_USER}" -r "${GH_REPO}" -c "${GITHUB_SHA::7}" continuous out/ ####################### # Update GitHub Pages # From 56d42f09d67548e56d8d4a69891a26a9e60a001a Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 30 Nov 2020 23:30:07 +0100 Subject: [PATCH 081/592] Update buildDocs.sh --- buildDocs.sh | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/buildDocs.sh b/buildDocs.sh index b0975b81..7ef6debe 100644 --- a/buildDocs.sh +++ b/buildDocs.sh @@ -55,7 +55,7 @@ wget "https://github.com/tcnksm/ghr/releases/download/v0.13.0/ghr_v0.13.0_linux_ tar xf ghr_*.tar.gz GH_USER=$(echo "${GITHUB_REPOSITORY}" | cut -d "/" -f 1) GH_REPO=$(echo "${GITHUB_REPOSITORY}" | cut -d "/" -f 2) -./ghr_*/ghr -delete -t "${G_TOKEN}" -u "${GH_USER}" -r "${GH_REPO}" -c "${GITHUB_SHA::7}" continuous out/ +./ghr_*/ghr -delete -t "${G_TOKEN}" -u "${GH_USER}" -r "${GH_REPO}" -c "${GITHUB_SHA}" continuous out/ ####################### # Update GitHub Pages # From 58933a3a20a2dee43dcf83523bc7ba31baa9cf08 Mon Sep 17 00:00:00 2001 From: probonopd Date: Tue, 1 Dec 2020 18:53:18 +0100 Subject: [PATCH 082/592] Add Sharing.app --- user/components/preferences/sharing.md | 48 ++++++++++++++++++++++++++ 1 file changed, 48 insertions(+) create mode 100644 user/components/preferences/sharing.md diff --git a/user/components/preferences/sharing.md b/user/components/preferences/sharing.md new file mode 100644 index 00000000..a52c57b6 --- /dev/null +++ b/user/components/preferences/sharing.md @@ -0,0 +1,48 @@ +# Sharing + +The __Sharing__ preferences application lets you make your computer accessible from the network. + +## Computer Name + +The __Computer Name__ (hostname) is displayed. You can change it. Changes in the Computer Name will take effect upon restarting the computer. + +## Remote Login + +Check the __Remote Login__ checkbox to make your computer accessible over ssh. + +## Screen Sharing + +Check the __Screen Sharing__ checkbox to make your computer accessible through VNC over ssh and advertise it on the network. The __Screen Sharing__ checkbox will automatically be unchecked when the computer is restarted or after a connection has been made and has ended. + +## Accessing the screen of remote computers + +## Accessing the screen of a remote computer that has Screen Sharing enabled + +If Screen Sharing is active on the remote computer, then you can connect over the local area network as follows: + +* Install the `ssvnc` package +* On the command line, type `ssvnc-gui` and press Enter +* Click "Find" +* Select the computer you want to connect to from the list +* Add `user@` before the hostname. Replace `user` with your username on the remote computer +* Click "Use SSH" +* Click "Connect" +* When promted, enter the password of your computer account on the remote computer + +## Accessing the screen of a remote computer that has Remote Login enabled + +If Screen Sharing is not active but Remote Login is active on the remote computer, then you can connect over the local area network and enable Screen Sharing as follows. Replace `user` with your username on the remote computer, and `FreeBSD.local.` with the hostname of the remote computer: + +``` +ssh -t -L 5900:localhost:5900 user@FreeBSD.local. 'x11vnc -display :0 -auth /home/user/.Xauthority -once -localhost' +``` + +Log into the remote computer. Then start the Remote Desktop client as follows: + +``` +ssvncviewer localhost +``` + +``` .. note:: + A graphical Remote Desktop client that does this automatically for you may be offered in the future. +``` From 620b9374f233999ed76317f7045b19f2e3b9ea98 Mon Sep 17 00:00:00 2001 From: probonopd Date: Tue, 1 Dec 2020 19:00:38 +0100 Subject: [PATCH 083/592] ./_build/html/ --- buildDocs.sh | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/buildDocs.sh b/buildDocs.sh index 7ef6debe..1f5e3289 100644 --- a/buildDocs.sh +++ b/buildDocs.sh @@ -67,7 +67,7 @@ git config --global user.name "${GITHUB_ACTOR}" git config --global user.email "${GITHUB_ACTOR}@users.noreply.github.com" docroot=`mktemp -d` -rsync -av "./_build/" "${docroot}/" +rsync -av "./_build/html/" "${docroot}/" pushd "${docroot}" From d11f056a7e33edcb481bb76c30755af25293415d Mon Sep 17 00:00:00 2001 From: probonopd Date: Tue, 1 Dec 2020 21:13:29 +0100 Subject: [PATCH 084/592] Graphical error message if something goes wrong --- user/components/system/launch.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/user/components/system/launch.md b/user/components/system/launch.md index aaade05d..48f808b1 100644 --- a/user/components/system/launch.md +++ b/user/components/system/launch.md @@ -16,8 +16,6 @@ As an end user who is using the graphical user interface exclusively, you will not need to interact with the `launch` command directly and can skip this section. ``` - - ## Background On UNIX systems, applications are typically launched by entering the name of the executable file, which is searched in a fixed list of directories determined by the `$PATH` environment variable. @@ -25,8 +23,10 @@ Many graphical desktop environments use `.desktop` files to integrate applications with the system. While this has traditionally worked well for installed applications, it does not work well for dynamically changing applications that are moved in the filesystem, such as `.app` bundles or `.AppDir` directories. Also, it does not handle mutliple versions of the same application gracefully. Hence, helloSystem uses the `launch` command to launch graphical applications. This has the following advantages: * You do not need to know the path to the application to be launched, even if the applciation is not on the `$PATH` + * If multiple versions of an application are available on the system, the most recent one will be launched automatically (unless specified otherwise by the user) __(to be implemented)__ * If something goes wrong and the application cannot be launched, then a graphical error message will be shown on the screen - * If multiple versions of an application are available on the system, the most recent one will be launched automatically (unless specified otherwise by the user) __(to be implemented)__ + + ![Graphical error message if something goes wrong](https://pbs.twimg.com/media/EoLKXl7WEAAWCtQ?format=png) ## Using the `launch` command From 5d049d32317a6aeef83662bc3df00c76d1840d00 Mon Sep 17 00:00:00 2001 From: probonopd Date: Tue, 1 Dec 2020 21:20:16 +0100 Subject: [PATCH 085/592] Add Sharing.app picture --- user/components/preferences/sharing.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/user/components/preferences/sharing.md b/user/components/preferences/sharing.md index a52c57b6..76ee361e 100644 --- a/user/components/preferences/sharing.md +++ b/user/components/preferences/sharing.md @@ -2,6 +2,8 @@ The __Sharing__ preferences application lets you make your computer accessible from the network. +![Sharing.app](https://pbs.twimg.com/media/EoK8buxXYAIdtvJ?format=png) + ## Computer Name The __Computer Name__ (hostname) is displayed. You can change it. Changes in the Computer Name will take effect upon restarting the computer. @@ -43,6 +45,4 @@ Log into the remote computer. Then start the Remote Desktop client as follows: ssvncviewer localhost ``` -``` .. note:: - A graphical Remote Desktop client that does this automatically for you may be offered in the future. -``` +You should now be able to see and operate the screen. From af87fddd17e1b930dba7bdc117e5b70553d1d7e7 Mon Sep 17 00:00:00 2001 From: probonopd Date: Tue, 1 Dec 2020 21:24:11 +0100 Subject: [PATCH 086/592] Update sharing.md --- user/components/preferences/sharing.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/user/components/preferences/sharing.md b/user/components/preferences/sharing.md index 76ee361e..d38ba407 100644 --- a/user/components/preferences/sharing.md +++ b/user/components/preferences/sharing.md @@ -14,7 +14,7 @@ Check the __Remote Login__ checkbox to make your computer accessible over ssh. ## Screen Sharing -Check the __Screen Sharing__ checkbox to make your computer accessible through VNC over ssh and advertise it on the network. The __Screen Sharing__ checkbox will automatically be unchecked when the computer is restarted or after a connection has been made and has ended. +Check the __Screen Sharing__ checkbox to make the screen of your computer accessible through VNC over ssh and advertise it on the network. This allows another user who has an account on your computer to view the screen, and to control the computer as if they were sitting in front of it. This can be helpful, e.g., for getting help from colleagues. The __Screen Sharing__ checkbox will automatically be unchecked when the computer is restarted or after a connection has been made and has ended. ## Accessing the screen of remote computers From e250bcd39b1561b2babff72d0c261902df9a831f Mon Sep 17 00:00:00 2001 From: probonopd Date: Tue, 1 Dec 2020 21:27:30 +0100 Subject: [PATCH 087/592] Update applications.md --- user/components/applications.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/user/components/applications.md b/user/components/applications.md index 5161f1ab..d536e137 100644 --- a/user/components/applications.md +++ b/user/components/applications.md @@ -1,5 +1,9 @@ # Applications +Most applications in helloSystem come in the form of __application bundles__. An application bundle is an application that looks like a file but is actually a directory, containing not only the application but also auxiliary files such as icons and other resources. To view the contents of an application bundle, right-click on it and select "Open in new Tab". + +![Viewing the contents of an application bundle](https://pbs.twimg.com/media/EoK9u7vXUAAJFPn?format=png) + helloSystem comes with the following applications, each of which are described in this section: ```eval_rst From e50f3fe7d645cab54b1f462b7e51ac55b1883a1e Mon Sep 17 00:00:00 2001 From: probonopd Date: Tue, 1 Dec 2020 21:29:28 +0100 Subject: [PATCH 088/592] Update applications.md [ci skip] --- user/components/applications.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/user/components/applications.md b/user/components/applications.md index d536e137..1f02b224 100644 --- a/user/components/applications.md +++ b/user/components/applications.md @@ -1,6 +1,6 @@ # Applications -Most applications in helloSystem come in the form of __application bundles__. An application bundle is an application that looks like a file but is actually a directory, containing not only the application but also auxiliary files such as icons and other resources. To view the contents of an application bundle, right-click on it and select "Open in new Tab". +Most applications in helloSystem come in the form of __application bundles__. An application bundle is an application that looks and behaves like a file but is actually a directory, containing not only the application but also auxiliary files such as icons and other resources. To view the contents of an application bundle, right-click on it and select "Open in new Tab". This is useful especially for open source applications written in languages such as PyQt5, because you can interactively edit the source code and test your changes. ![Viewing the contents of an application bundle](https://pbs.twimg.com/media/EoK9u7vXUAAJFPn?format=png) From 3d74b319828130eb317de581bfa0a70c27d07b7a Mon Sep 17 00:00:00 2001 From: probonopd Date: Tue, 1 Dec 2020 21:35:03 +0100 Subject: [PATCH 089/592] Update menu.md --- user/components/system/menu.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/user/components/system/menu.md b/user/components/system/menu.md index b9571bf0..d464984a 100644 --- a/user/components/system/menu.md +++ b/user/components/system/menu.md @@ -1,5 +1,7 @@ # Menu +![Menu](https://pbs.twimg.com/media/EniEQ0uXIAEA2O5?format=png) + The menu bar at the top of the screen lets you perform, among others, the following functions: * Get information about your computer From 8d7d0047e9bdb06c289523b3e24583b8f8271431 Mon Sep 17 00:00:00 2001 From: probonopd Date: Tue, 1 Dec 2020 21:40:33 +0100 Subject: [PATCH 090/592] Update install.md --- user/components/utilities/install.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/user/components/utilities/install.md b/user/components/utilities/install.md index 0ee19a69..3eaae8c5 100644 --- a/user/components/utilities/install.md +++ b/user/components/utilities/install.md @@ -8,6 +8,8 @@ The __Install FreeBSD__ utility lets you install helloSystem on your computer fr The utility is called **Install FreeBSD** to signify that helloSystem contains a largely unmodified FreeBSD core operating system. It might be renamed "Install helloSystem" in the future. ``` +![Install FreeBSD](https://user-images.githubusercontent.com/2480569/93003377-7d77c480-f53e-11ea-9e2d-aed1b41a17df.png) + When you install helloSystem using the __Install FreeBSD__ utility, the installed system will behave like the Live system in most aspects. ## Prerequisites From 5e3bbe2df6885ea277925500d5f9b21fb71f5679 Mon Sep 17 00:00:00 2001 From: probonopd Date: Tue, 1 Dec 2020 21:44:50 +0100 Subject: [PATCH 091/592] Update create-live-media.md --- user/components/utilities/create-live-media.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/user/components/utilities/create-live-media.md b/user/components/utilities/create-live-media.md index 898a7ffe..70ce68eb 100644 --- a/user/components/utilities/create-live-media.md +++ b/user/components/utilities/create-live-media.md @@ -4,6 +4,8 @@ A __Live Medium__ is a storage device that can be used to start your computer wi The __Create Live Media__ utility provides an easy and convenient way to create bootable Live Media on devices such as USB sticks. It downloads and writes Live ISOs to devices in one go. +![Create Live Media](https://user-images.githubusercontent.com/2480569/100794701-3bb03900-341e-11eb-8c18-e45fc68b7dbe.png) + This is useful if you are running helloSystem and would like to write a newer (or experimental) version of the system to a bootable storage device. ## Prerequisites From 77d8373ea09cfa661c5c5caec9e06dcbe4a11557 Mon Sep 17 00:00:00 2001 From: probonopd Date: Thu, 3 Dec 2020 19:39:42 +0100 Subject: [PATCH 092/592] Update acknowledgements.md --- developer/acknowledgements.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/developer/acknowledgements.md b/developer/acknowledgements.md index 248d941c..714d5107 100644 --- a/developer/acknowledgements.md +++ b/developer/acknowledgements.md @@ -20,7 +20,7 @@ __[probonopd](https://github.com/probonopd)__ ## Joe Maloney __[pkgdemon](https://github.com/pkgdemon)__ -@FuryBSD on twitter +malco2001 on irc.freenode.net (#FuryBSD) * Originally wrote the tools to create Live ISOs for FuryBSD ## FreeBSD Foundation From eba2a011a8a9fc028643d28dc2b09954540fbff8 Mon Sep 17 00:00:00 2001 From: probonopd Date: Thu, 3 Dec 2020 20:36:33 +0100 Subject: [PATCH 093/592] Update getting-started.md --- user/getting-started.md | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/user/getting-started.md b/user/getting-started.md index cfafa650..e16ff615 100644 --- a/user/getting-started.md +++ b/user/getting-started.md @@ -24,8 +24,12 @@ hello is known to boot to a graphical desktop on the following machines. Auxilia ### Tested virtualization environments -* VirtualBox host (on FreeBSD) -* VMware host (on Windows) +![helloSystem on VirtualBox in BIOS EFI mode](https://user-images.githubusercontent.com/2480569/101068320-dc2a6880-3598-11eb-9304-28655c8f17a5.png) + +* VirtualBox host (on FreeBSD), known to work in BIOS and EFI mode +* VMware host (on Windows), possibly only working in BIOS mode? + +Please report back about the results on your virtualization environment. ## Downloading From b687cc6fd82dde76f60bf26b469ac0fcfd561c68 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 5 Dec 2020 16:05:16 +0100 Subject: [PATCH 094/592] Add boot [ci skip] --- developer/index.md | 1 + 1 file changed, 1 insertion(+) diff --git a/developer/index.md b/developer/index.md index 8c97ca2c..c79e806e 100644 --- a/developer/index.md +++ b/developer/index.md @@ -5,6 +5,7 @@ :maxdepth: 2 :glob: + boot contributing building distributions From c7909908ebbf2a33661bb9b12b90cd4adc8445dc Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 5 Dec 2020 16:06:04 +0100 Subject: [PATCH 095/592] Create boot.md --- developer/boot.md | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) create mode 100644 developer/boot.md diff --git a/developer/boot.md b/developer/boot.md new file mode 100644 index 00000000..c3f3793c --- /dev/null +++ b/developer/boot.md @@ -0,0 +1,18 @@ +# Boot process + +## Live system + +This is a simplified description of the boot process. There may be additional aspects which still need to be documented. + +1. The bootloader gets loaded +1. The bootloader loads the kernel modules that are required for the Live system boot process as specified in `overlays/boot/boot/loader.conf`. Note that the bootloader apparently is not smart enough to load the dependencies of kernel modules, so one needs to manually specify those as well. (For example, zfs.ko up to FreeBSD 12 requires `opensolaris.ko` and from 13 onward requires `cryptodev`.) +1. The bootloader loads the ramdisk image `ramdisk.ufs` as specified in `overlays/boot/boot/loader.conf`. The contents of the ramdisk image are specified in `overlays/ramdisk` +1. `init.sh` from the ramdisk image gets executed as specified in `overlays/ramdisk/init.sh`. It constructs a r/w Live filesystem tree (e.g., by copying the system image to swap-based memdisk) at `/livecd` +1. `/usr/local/bin/furybsd-init-helper` gets executed by `init.sh` in a chroot of the live filesystem, `/livecd`. It is defined in `overlays/uzip/furybsd-live-settings/files/usr/local/bin/furybsd-init-helper` and deals with loading Xorg configuration based on the detected devices on PCI, and with loading virtualization-related drivers +1. The `/livecd` chroot is exited +1. `init.sh` from the ramdisk image exits +1. `etc/rc` from the ramdisk image gets executed as specified in `overlays/ramdisk/etc/rc` (by what?). It tells the kernel to "reroot" (not "chroot") into the live filesystem, `/livecd` using `reboot -r` + +## Installed system + +The boot process is the regular FreeBSD boot process. From b694dd4de6b0ebfa81a74e8758055631e77cf3e6 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 5 Dec 2020 16:06:20 +0100 Subject: [PATCH 096/592] Update boot.md --- developer/boot.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/developer/boot.md b/developer/boot.md index c3f3793c..5c3863ad 100644 --- a/developer/boot.md +++ b/developer/boot.md @@ -5,7 +5,7 @@ This is a simplified description of the boot process. There may be additional aspects which still need to be documented. 1. The bootloader gets loaded -1. The bootloader loads the kernel modules that are required for the Live system boot process as specified in `overlays/boot/boot/loader.conf`. Note that the bootloader apparently is not smart enough to load the dependencies of kernel modules, so one needs to manually specify those as well. (For example, zfs.ko up to FreeBSD 12 requires `opensolaris.ko` and from 13 onward requires `cryptodev`.) +1. The bootloader loads the kernel modules that are required for the Live system boot process as specified in `overlays/boot/boot/loader.conf`. Note that the bootloader apparently is not smart enough to load the dependencies of kernel modules, so one needs to manually specify those as well. (For example, zfs.ko up to FreeBSD 12 requires `opensolaris.ko` and from 13 onward requires `cryptodev.ko`.) 1. The bootloader loads the ramdisk image `ramdisk.ufs` as specified in `overlays/boot/boot/loader.conf`. The contents of the ramdisk image are specified in `overlays/ramdisk` 1. `init.sh` from the ramdisk image gets executed as specified in `overlays/ramdisk/init.sh`. It constructs a r/w Live filesystem tree (e.g., by copying the system image to swap-based memdisk) at `/livecd` 1. `/usr/local/bin/furybsd-init-helper` gets executed by `init.sh` in a chroot of the live filesystem, `/livecd`. It is defined in `overlays/uzip/furybsd-live-settings/files/usr/local/bin/furybsd-init-helper` and deals with loading Xorg configuration based on the detected devices on PCI, and with loading virtualization-related drivers From 131fb8a9ed2c824201e4adc8287ae05e09a7596e Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 5 Dec 2020 16:06:46 +0100 Subject: [PATCH 097/592] Update boot.md --- developer/boot.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/developer/boot.md b/developer/boot.md index 5c3863ad..c6581ad2 100644 --- a/developer/boot.md +++ b/developer/boot.md @@ -5,7 +5,7 @@ This is a simplified description of the boot process. There may be additional aspects which still need to be documented. 1. The bootloader gets loaded -1. The bootloader loads the kernel modules that are required for the Live system boot process as specified in `overlays/boot/boot/loader.conf`. Note that the bootloader apparently is not smart enough to load the dependencies of kernel modules, so one needs to manually specify those as well. (For example, zfs.ko up to FreeBSD 12 requires `opensolaris.ko` and from 13 onward requires `cryptodev.ko`.) +1. The bootloader loads the kernel modules that are required for the Live system boot process as specified in `overlays/boot/boot/loader.conf`. Note that the bootloader apparently is not smart enough to load the dependencies of kernel modules, so one needs to manually specify those as well. For example, zfs.ko up to FreeBSD 12 requires `opensolaris.ko` and from 13 onward requires `cryptodev.ko` 1. The bootloader loads the ramdisk image `ramdisk.ufs` as specified in `overlays/boot/boot/loader.conf`. The contents of the ramdisk image are specified in `overlays/ramdisk` 1. `init.sh` from the ramdisk image gets executed as specified in `overlays/ramdisk/init.sh`. It constructs a r/w Live filesystem tree (e.g., by copying the system image to swap-based memdisk) at `/livecd` 1. `/usr/local/bin/furybsd-init-helper` gets executed by `init.sh` in a chroot of the live filesystem, `/livecd`. It is defined in `overlays/uzip/furybsd-live-settings/files/usr/local/bin/furybsd-init-helper` and deals with loading Xorg configuration based on the detected devices on PCI, and with loading virtualization-related drivers From bed68d52df5669ac22f5fc88749e1554940035f6 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 5 Dec 2020 16:12:13 +0100 Subject: [PATCH 098/592] Update boot.md --- developer/boot.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/developer/boot.md b/developer/boot.md index c6581ad2..6e0b6a4c 100644 --- a/developer/boot.md +++ b/developer/boot.md @@ -2,10 +2,14 @@ ## Live system +The ISO contains a Live system filesystem image in uzip format. This filesystem image contains the filesystem used when running the ISO. During the Live system boot process, the image needs to get mounted and needs to get turned into a read-write filesystem so that one can make changes to the running system. + +FreeBSD does not have a standard way to achieve this, so custom code has to be used. + This is a simplified description of the boot process. There may be additional aspects which still need to be documented. 1. The bootloader gets loaded -1. The bootloader loads the kernel modules that are required for the Live system boot process as specified in `overlays/boot/boot/loader.conf`. Note that the bootloader apparently is not smart enough to load the dependencies of kernel modules, so one needs to manually specify those as well. For example, zfs.ko up to FreeBSD 12 requires `opensolaris.ko` and from 13 onward requires `cryptodev.ko` +1. The bootloader loads the kernel modules that are required for the Live system boot process as specified in `overlays/boot/boot/loader.conf`. Note that the bootloader apparently is not smart enough to load the dependencies of kernel modules, so one needs to manually specify those as well. For example, `zfs.ko` up to FreeBSD 12 requires `opensolaris.ko` and from 13 onward requires `cryptodev.ko` 1. The bootloader loads the ramdisk image `ramdisk.ufs` as specified in `overlays/boot/boot/loader.conf`. The contents of the ramdisk image are specified in `overlays/ramdisk` 1. `init.sh` from the ramdisk image gets executed as specified in `overlays/ramdisk/init.sh`. It constructs a r/w Live filesystem tree (e.g., by copying the system image to swap-based memdisk) at `/livecd` 1. `/usr/local/bin/furybsd-init-helper` gets executed by `init.sh` in a chroot of the live filesystem, `/livecd`. It is defined in `overlays/uzip/furybsd-live-settings/files/usr/local/bin/furybsd-init-helper` and deals with loading Xorg configuration based on the detected devices on PCI, and with loading virtualization-related drivers From 5114b511a9bacb0cdb3ed11a14f612800b89d585 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 5 Dec 2020 16:13:12 +0100 Subject: [PATCH 099/592] Update boot.md --- developer/boot.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/developer/boot.md b/developer/boot.md index 6e0b6a4c..a01c6659 100644 --- a/developer/boot.md +++ b/developer/boot.md @@ -2,9 +2,9 @@ ## Live system -The ISO contains a Live system filesystem image in uzip format. This filesystem image contains the filesystem used when running the ISO. During the Live system boot process, the image needs to get mounted and needs to get turned into a read-write filesystem so that one can make changes to the running system. +The ISO contains a compressed Live system filesystem image in uzip format. This filesystem image contains the filesystem used when running the ISO. During the Live system boot process, the image needs to get mounted and needs to get turned into a read-write filesystem so that one can make changes to the running system. -FreeBSD does not have a standard way to achieve this, so custom code has to be used. +FreeBSD does not have a standard way to achieve this, so custom code has to be used. (The ISOs provided by the FreeBSD project do not use a compressed Live system filesystem image, and do not result in a read-write filesystem when being booted.) This is a simplified description of the boot process. There may be additional aspects which still need to be documented. From 5645528cd70be5c442a7e3c41eb39634d7e83837 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 5 Dec 2020 17:12:15 +0100 Subject: [PATCH 100/592] Update boot.md --- developer/boot.md | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/developer/boot.md b/developer/boot.md index a01c6659..3ec55839 100644 --- a/developer/boot.md +++ b/developer/boot.md @@ -11,12 +11,17 @@ This is a simplified description of the boot process. There may be additional as 1. The bootloader gets loaded 1. The bootloader loads the kernel modules that are required for the Live system boot process as specified in `overlays/boot/boot/loader.conf`. Note that the bootloader apparently is not smart enough to load the dependencies of kernel modules, so one needs to manually specify those as well. For example, `zfs.ko` up to FreeBSD 12 requires `opensolaris.ko` and from 13 onward requires `cryptodev.ko` 1. The bootloader loads the ramdisk image `ramdisk.ufs` as specified in `overlays/boot/boot/loader.conf`. The contents of the ramdisk image are specified in `overlays/ramdisk` -1. `init.sh` from the ramdisk image gets executed as specified in `overlays/ramdisk/init.sh`. It constructs a r/w Live filesystem tree (e.g., by copying the system image to swap-based memdisk) at `/livecd` +1. `init.sh` from the ramdisk image gets executed as specified in `overlays/ramdisk/init.sh`. It constructs a r/w Live filesystem tree (e.g., by replicating the system image to swap-based memdisk) at `/livecd` 1. `/usr/local/bin/furybsd-init-helper` gets executed by `init.sh` in a chroot of the live filesystem, `/livecd`. It is defined in `overlays/uzip/furybsd-live-settings/files/usr/local/bin/furybsd-init-helper` and deals with loading Xorg configuration based on the detected devices on PCI, and with loading virtualization-related drivers 1. The `/livecd` chroot is exited 1. `init.sh` from the ramdisk image exits 1. `etc/rc` from the ramdisk image gets executed as specified in `overlays/ramdisk/etc/rc` (by what?). It tells the kernel to "reroot" (not "chroot") into the live filesystem, `/livecd` using `reboot -r` +### Troubleshooting + +* __Hangs or reboots during replicating the system image to swap-based memdisk.__ The ISO is damaged. About one out of 10 builds of the ISO have this issue. Simply build a new ISO or wait for the next ISO to be available for download +* __"Cannot mount tmpfs on /dev/reroot: Operation not supported by device".__ Check that `zfs.ko` and its dependencies are really loaded. + ## Installed system The boot process is the regular FreeBSD boot process. From 66433962b61aa3838e10b1a3547fbeba1600671d Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 5 Dec 2020 17:12:50 +0100 Subject: [PATCH 101/592] Update boot.md --- developer/boot.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/developer/boot.md b/developer/boot.md index 3ec55839..ec204e42 100644 --- a/developer/boot.md +++ b/developer/boot.md @@ -20,7 +20,7 @@ This is a simplified description of the boot process. There may be additional as ### Troubleshooting * __Hangs or reboots during replicating the system image to swap-based memdisk.__ The ISO is damaged. About one out of 10 builds of the ISO have this issue. Simply build a new ISO or wait for the next ISO to be available for download -* __"Cannot mount tmpfs on /dev/reroot: Operation not supported by device".__ Check that `zfs.ko` and its dependencies are really loaded. +* __"Cannot mount tmpfs on /dev/reroot: Operation not supported by device".__ Reason unkown. Are needed kernel modules missing? ## Installed system From dad42e5937f3be1075108460f32e2252972c944f Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 5 Dec 2020 18:28:30 +0100 Subject: [PATCH 102/592] Create keyboard.md --- user/components/preferences/keyboard.md | 3 +++ 1 file changed, 3 insertions(+) create mode 100644 user/components/preferences/keyboard.md diff --git a/user/components/preferences/keyboard.md b/user/components/preferences/keyboard.md new file mode 100644 index 00000000..30916b3a --- /dev/null +++ b/user/components/preferences/keyboard.md @@ -0,0 +1,3 @@ +# Keyboard + +The __Keyboard__ preferences application lets you change the keyboard layout (language) of your attached keyboard. From 6ea16d79032d0c5d0aa89b87c9c2aa540a1d4701 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 5 Dec 2020 18:30:22 +0100 Subject: [PATCH 103/592] Update keyboard.md --- user/components/preferences/keyboard.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/user/components/preferences/keyboard.md b/user/components/preferences/keyboard.md index 30916b3a..f873e107 100644 --- a/user/components/preferences/keyboard.md +++ b/user/components/preferences/keyboard.md @@ -1,3 +1,7 @@ # Keyboard The __Keyboard__ preferences application lets you change the keyboard layout (language) of your attached keyboard. + +``` .. note:: + The keyboard layout (language) gets set automatically during system startup if an official Raspberry Pi keyboard is attached or the system is running on Macintosh hardware, which has the prev-lang:kbd EFI key set. +``` From 0e55e9bb091290f3665d5c152111ad43b1912a6b Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 5 Dec 2020 19:16:00 +0100 Subject: [PATCH 104/592] Graphical desktop boot start process --- developer/boot.md | 11 +++++++++-- 1 file changed, 9 insertions(+), 2 deletions(-) diff --git a/developer/boot.md b/developer/boot.md index ec204e42..3c570e83 100644 --- a/developer/boot.md +++ b/developer/boot.md @@ -1,6 +1,6 @@ # Boot process -## Live system +## Live system early boot process The ISO contains a compressed Live system filesystem image in uzip format. This filesystem image contains the filesystem used when running the ISO. During the Live system boot process, the image needs to get mounted and needs to get turned into a read-write filesystem so that one can make changes to the running system. @@ -16,12 +16,19 @@ This is a simplified description of the boot process. There may be additional as 1. The `/livecd` chroot is exited 1. `init.sh` from the ramdisk image exits 1. `etc/rc` from the ramdisk image gets executed as specified in `overlays/ramdisk/etc/rc` (by what?). It tells the kernel to "reroot" (not "chroot") into the live filesystem, `/livecd` using `reboot -r` +1 From here on, the boot process is the regular FreeBSD boot process ### Troubleshooting * __Hangs or reboots during replicating the system image to swap-based memdisk.__ The ISO is damaged. About one out of 10 builds of the ISO have this issue. Simply build a new ISO or wait for the next ISO to be available for download * __"Cannot mount tmpfs on /dev/reroot: Operation not supported by device".__ Reason unkown. Are needed kernel modules missing? -## Installed system +## Installed system boot process The boot process is the regular FreeBSD boot process. + +## Graphical desktop boot start process + +1. The system is configured in `/etc/rc.conf` to start the `slim` login manager. This also results in Xorg being started +1. `slim` is configured in `/usr/local/etc/slim.conf` to start `start-hello` once the user has logged in, or if autologin has occured +1. The `/usr/local/bin/start-hello` shell script starts the various components of the helloSystem desktop From 3df65ed5a1bcfaf8a8b34e21e303451bbaf1b6ae Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 5 Dec 2020 19:16:33 +0100 Subject: [PATCH 105/592] Graphical desktop start process [ci skip] --- developer/boot.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/developer/boot.md b/developer/boot.md index 3c570e83..02ac23b8 100644 --- a/developer/boot.md +++ b/developer/boot.md @@ -27,7 +27,7 @@ This is a simplified description of the boot process. There may be additional as The boot process is the regular FreeBSD boot process. -## Graphical desktop boot start process +## Graphical desktop start process 1. The system is configured in `/etc/rc.conf` to start the `slim` login manager. This also results in Xorg being started 1. `slim` is configured in `/usr/local/etc/slim.conf` to start `start-hello` once the user has logged in, or if autologin has occured From d35d5806090696547ee47eb4ed02a97f47279310 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 6 Dec 2020 11:33:58 +0100 Subject: [PATCH 106/592] Create calculator.md --- user/components/utilities/calculator.md | 5 +++++ 1 file changed, 5 insertions(+) create mode 100644 user/components/utilities/calculator.md diff --git a/user/components/utilities/calculator.md b/user/components/utilities/calculator.md new file mode 100644 index 00000000..07b53cf8 --- /dev/null +++ b/user/components/utilities/calculator.md @@ -0,0 +1,5 @@ +# Calculator + +The __Calculator__ application is a simple graphic calculator application. + +Actually, it is a [Calculator Construction Set](https://www.folklore.org/StoryView.py?story=Calculator_Construction_Set.txt). From fe0d06b77944055d706f715c5dedcd5a9fedff1c Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 6 Dec 2020 11:37:46 +0100 Subject: [PATCH 107/592] Update acknowledgements.md --- developer/acknowledgements.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/developer/acknowledgements.md b/developer/acknowledgements.md index 714d5107..e2564892 100644 --- a/developer/acknowledgements.md +++ b/developer/acknowledgements.md @@ -61,3 +61,7 @@ __[keshavbhatt](https://github.com/keshavbhatt)__ ## TheAssassin __[TheAssassin](https://github.com/TheAssassin)__ * Improved documentation by providing Sphinx evangelism and ReStructuredText help + +## Leodanis Pozo Ramos +__[lpozo](https://github.com/lpozo)__ +* Wrote tutorial and sample code that forms the basis for Calculator.app From a4f6443db862ad856f53d1b2f0ca54362e339259 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 6 Dec 2020 11:48:48 +0100 Subject: [PATCH 108/592] Add applications to TOC [ci skip] --- developer/index.md | 1 + 1 file changed, 1 insertion(+) diff --git a/developer/index.md b/developer/index.md index c79e806e..16620ed8 100644 --- a/developer/index.md +++ b/developer/index.md @@ -6,6 +6,7 @@ :glob: boot + applications contributing building distributions From 13f00687f9ba1fce91a867b1ef4b9f8a16bba666 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 6 Dec 2020 11:51:56 +0100 Subject: [PATCH 109/592] Create applications.md --- developer/applications.md | 9 +++++++++ 1 file changed, 9 insertions(+) create mode 100644 developer/applications.md diff --git a/developer/applications.md b/developer/applications.md new file mode 100644 index 00000000..668b7cc8 --- /dev/null +++ b/developer/applications.md @@ -0,0 +1,9 @@ +# Applications + +Frontend applications for system graphical user interfaces written for helloSystem should be +* Simple to use +* Easy to hack on +* Open Source (2-clause BSD licensed by default, but similar permissive licenses may also be acceptable) +* Ideally written in PyQt + +Please see [https://github.com/learnpyqt/15-minute-apps](https://github.com/learnpyqt/15-minute-apps) for what we mean by "Simple to use" and "Easy to hack on". From e4dab947e600f7ff22bf261f4f06eda2cdfdd52b Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 6 Dec 2020 11:53:21 +0100 Subject: [PATCH 110/592] Update applications.md --- developer/applications.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/developer/applications.md b/developer/applications.md index 668b7cc8..3a2c2873 100644 --- a/developer/applications.md +++ b/developer/applications.md @@ -1,9 +1,11 @@ # Applications -Frontend applications for system graphical user interfaces written for helloSystem should be +Applications specifically written for helloSystem, especially Preferences and Utilities applications, should be * Simple to use * Easy to hack on * Open Source (2-clause BSD licensed by default, but similar permissive licenses may also be acceptable) * Ideally written in PyQt +They should come as `.app` bundles with no external dependencies apart from what comes with helloSystem by default on the Live ISO. + Please see [https://github.com/learnpyqt/15-minute-apps](https://github.com/learnpyqt/15-minute-apps) for what we mean by "Simple to use" and "Easy to hack on". From 0d80e2d859050722383528dd811e800cdd48557f Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 6 Dec 2020 11:55:19 +0100 Subject: [PATCH 111/592] Update applications.md --- developer/applications.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/developer/applications.md b/developer/applications.md index 3a2c2873..e67ffbbd 100644 --- a/developer/applications.md +++ b/developer/applications.md @@ -5,7 +5,6 @@ Applications specifically written for helloSystem, especially Preferences and Ut * Easy to hack on * Open Source (2-clause BSD licensed by default, but similar permissive licenses may also be acceptable) * Ideally written in PyQt - -They should come as `.app` bundles with no external dependencies apart from what comes with helloSystem by default on the Live ISO. +* Come as simplified `.app` bundles with no external dependencies apart from what comes with helloSystem by default on the Live ISO. Please see [https://github.com/learnpyqt/15-minute-apps](https://github.com/learnpyqt/15-minute-apps) for what we mean by "Simple to use" and "Easy to hack on". From 7c21e8e9705ef6ccb8eb574b11cb6c5ab55984ac Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 6 Dec 2020 11:55:30 +0100 Subject: [PATCH 112/592] Update applications.md --- developer/applications.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/developer/applications.md b/developer/applications.md index e67ffbbd..ad3ccff8 100644 --- a/developer/applications.md +++ b/developer/applications.md @@ -5,6 +5,6 @@ Applications specifically written for helloSystem, especially Preferences and Ut * Easy to hack on * Open Source (2-clause BSD licensed by default, but similar permissive licenses may also be acceptable) * Ideally written in PyQt -* Come as simplified `.app` bundles with no external dependencies apart from what comes with helloSystem by default on the Live ISO. +* Come as simplified `.app` bundles with no external dependencies apart from what comes with helloSystem by default on the Live ISO Please see [https://github.com/learnpyqt/15-minute-apps](https://github.com/learnpyqt/15-minute-apps) for what we mean by "Simple to use" and "Easy to hack on". From b3ca7f578da725b40d8b853077a6686e854778e6 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 6 Dec 2020 11:56:23 +0100 Subject: [PATCH 113/592] Create sticky-notes.md --- user/components/utilities/sticky-notes.md | 5 +++++ 1 file changed, 5 insertions(+) create mode 100644 user/components/utilities/sticky-notes.md diff --git a/user/components/utilities/sticky-notes.md b/user/components/utilities/sticky-notes.md new file mode 100644 index 00000000..49af1710 --- /dev/null +++ b/user/components/utilities/sticky-notes.md @@ -0,0 +1,5 @@ +# Sticky Notes + +The __Sticky Notes__ allows you to keep notes on your computer. + +Right-click on its icon in the menu bar to add new notes, show all notes, and change preferences. From fffbbf82356e98a9868a36b992ba88d53c7fdc13 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 6 Dec 2020 16:58:37 +0100 Subject: [PATCH 114/592] Update boot.md --- developer/boot.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/developer/boot.md b/developer/boot.md index 02ac23b8..994c5ca5 100644 --- a/developer/boot.md +++ b/developer/boot.md @@ -23,6 +23,15 @@ This is a simplified description of the boot process. There may be additional as * __Hangs or reboots during replicating the system image to swap-based memdisk.__ The ISO is damaged. About one out of 10 builds of the ISO have this issue. Simply build a new ISO or wait for the next ISO to be available for download * __"Cannot mount tmpfs on /dev/reroot: Operation not supported by device".__ Reason unkown. Are needed kernel modules missing? +### Boot into verbose single-user mode + +If your computer hangs during booting, you can boot into __verbose single-user mode__. This allows you to inspect the Live system early boot process and to enter commands manually that would otherwise be executed automatically. + +1. For a short time during boot, it says `Hit [Enter] to boot immediately, or any other key for command prompt.`. Press the __Esc__ key on your keyboard immediately when you see this +1. Type `unset boot_mute` and press the __Enter__ key. This disables the graphical splash screen +1. Type `set console=text` and press the __Enter__ key. This results in boot messages being shown on screen +1. Type `boot -v -s` and press the __Enter__ key. This results in the system being booted in verbose single-user mode + ## Installed system boot process The boot process is the regular FreeBSD boot process. From 6d3034bee1600a5528cebf84115c9c99a03bc785 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 6 Dec 2020 17:11:53 +0100 Subject: [PATCH 115/592] Update boot.md --- developer/boot.md | 15 ++++++++++++++- 1 file changed, 14 insertions(+), 1 deletion(-) diff --git a/developer/boot.md b/developer/boot.md index 994c5ca5..8f140d5d 100644 --- a/developer/boot.md +++ b/developer/boot.md @@ -23,15 +23,28 @@ This is a simplified description of the boot process. There may be additional as * __Hangs or reboots during replicating the system image to swap-based memdisk.__ The ISO is damaged. About one out of 10 builds of the ISO have this issue. Simply build a new ISO or wait for the next ISO to be available for download * __"Cannot mount tmpfs on /dev/reroot: Operation not supported by device".__ Reason unkown. Are needed kernel modules missing? +### Boot in verbose mode + +If you would like to observe the details of the boot process, you can start your computer in __verbose mode__. This allows you to inspect the Live system early boot process and to enter commands manually that would otherwise be executed automatically. + +1. For a short time during boot, it says `Hit [Enter] to boot immediately, or any other key for command prompt.`. Press the __Esc__ key on your keyboard immediately when you see this +1. Type `unset boot_mute` and press the __Enter__ key. This disables the graphical splash screen +1. Type `set console=text` and press the __Enter__ key. This results in boot messages being shown on screen +1. Type `boot -v` and press the __Enter__ key. This results in the system being booted in verbose mode + +The computer should boot into a graphical desktop. + ### Boot into verbose single-user mode -If your computer hangs during booting, you can boot into __verbose single-user mode__. This allows you to inspect the Live system early boot process and to enter commands manually that would otherwise be executed automatically. +If your computer hangs during booting, you can boot into __verbose single-user mode__. This allows advanced users, administrators, and developers to inspect the Live system early boot process and to enter commands manually that would otherwise be executed automatically. 1. For a short time during boot, it says `Hit [Enter] to boot immediately, or any other key for command prompt.`. Press the __Esc__ key on your keyboard immediately when you see this 1. Type `unset boot_mute` and press the __Enter__ key. This disables the graphical splash screen 1. Type `set console=text` and press the __Enter__ key. This results in boot messages being shown on screen 1. Type `boot -v -s` and press the __Enter__ key. This results in the system being booted in verbose single-user mode +The computer should boot into a text console rescue system in which parts of `init.sh` from the ramdisk image have run. + ## Installed system boot process The boot process is the regular FreeBSD boot process. From 24378b73b69b29c64ef2eb55dd6860478e655f53 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 6 Dec 2020 17:29:43 +0100 Subject: [PATCH 116/592] Troubleshooting the graphical desktop start process --- developer/boot.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/developer/boot.md b/developer/boot.md index 8f140d5d..9fd38d7b 100644 --- a/developer/boot.md +++ b/developer/boot.md @@ -18,7 +18,7 @@ This is a simplified description of the boot process. There may be additional as 1. `etc/rc` from the ramdisk image gets executed as specified in `overlays/ramdisk/etc/rc` (by what?). It tells the kernel to "reroot" (not "chroot") into the live filesystem, `/livecd` using `reboot -r` 1 From here on, the boot process is the regular FreeBSD boot process -### Troubleshooting +### Troubleshooting the Live system early boot process * __Hangs or reboots during replicating the system image to swap-based memdisk.__ The ISO is damaged. About one out of 10 builds of the ISO have this issue. Simply build a new ISO or wait for the next ISO to be available for download * __"Cannot mount tmpfs on /dev/reroot: Operation not supported by device".__ Reason unkown. Are needed kernel modules missing? @@ -54,3 +54,7 @@ The boot process is the regular FreeBSD boot process. 1. The system is configured in `/etc/rc.conf` to start the `slim` login manager. This also results in Xorg being started 1. `slim` is configured in `/usr/local/etc/slim.conf` to start `start-hello` once the user has logged in, or if autologin has occured 1. The `/usr/local/bin/start-hello` shell script starts the various components of the helloSystem desktop + +### Troubleshooting the graphical desktop start process + +* Login manager (`slim`) says __Failed to execute login command__. Check the `/usr/local/bin/start-hello` shell script. From ed4d049a18771afeb3c40b15d86020009cad8f5d Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 6 Dec 2020 17:31:30 +0100 Subject: [PATCH 117/592] The FreeBSD Booting Process --- developer/boot.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/developer/boot.md b/developer/boot.md index 9fd38d7b..a10a9306 100644 --- a/developer/boot.md +++ b/developer/boot.md @@ -45,10 +45,6 @@ If your computer hangs during booting, you can boot into __verbose single-user m The computer should boot into a text console rescue system in which parts of `init.sh` from the ramdisk image have run. -## Installed system boot process - -The boot process is the regular FreeBSD boot process. - ## Graphical desktop start process 1. The system is configured in `/etc/rc.conf` to start the `slim` login manager. This also results in Xorg being started @@ -58,3 +54,7 @@ The boot process is the regular FreeBSD boot process. ### Troubleshooting the graphical desktop start process * Login manager (`slim`) says __Failed to execute login command__. Check the `/usr/local/bin/start-hello` shell script. + +## Installed system boot process + +The boot process is the regular FreeBSD boot process. Please refer to [The FreeBSD Booting Process](https://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/boot.html) for more information. From 58ee15e255c35bd98f716822f4e6123284a9a7a4 Mon Sep 17 00:00:00 2001 From: probonopd Date: Tue, 8 Dec 2020 01:20:14 +0100 Subject: [PATCH 118/592] Update boot.md --- developer/boot.md | 10 ++++------ 1 file changed, 4 insertions(+), 6 deletions(-) diff --git a/developer/boot.md b/developer/boot.md index a10a9306..d26091f9 100644 --- a/developer/boot.md +++ b/developer/boot.md @@ -27,9 +27,8 @@ This is a simplified description of the boot process. There may be additional as If you would like to observe the details of the boot process, you can start your computer in __verbose mode__. This allows you to inspect the Live system early boot process and to enter commands manually that would otherwise be executed automatically. -1. For a short time during boot, it says `Hit [Enter] to boot immediately, or any other key for command prompt.`. Press the __Esc__ key on your keyboard immediately when you see this -1. Type `unset boot_mute` and press the __Enter__ key. This disables the graphical splash screen -1. Type `set console=text` and press the __Enter__ key. This results in boot messages being shown on screen +1. While the bootloader is running, keep the __Backspace__ key pressed until you see an `OK` prompt (alternatively, for a short time during boot, it says `Hit [Enter] to boot immediately, or any other key for command prompt.`. Press the __Esc__ key on your keyboard immediately when you see this) +1. Type `unset boot_mute` and press the __Enter__ key. This disables the graphical splash screen and results in boot messages being shown 1. Type `boot -v` and press the __Enter__ key. This results in the system being booted in verbose mode The computer should boot into a graphical desktop. @@ -38,9 +37,8 @@ The computer should boot into a graphical desktop. If your computer hangs during booting, you can boot into __verbose single-user mode__. This allows advanced users, administrators, and developers to inspect the Live system early boot process and to enter commands manually that would otherwise be executed automatically. -1. For a short time during boot, it says `Hit [Enter] to boot immediately, or any other key for command prompt.`. Press the __Esc__ key on your keyboard immediately when you see this -1. Type `unset boot_mute` and press the __Enter__ key. This disables the graphical splash screen -1. Type `set console=text` and press the __Enter__ key. This results in boot messages being shown on screen +1. While the bootloader is running, keep the __Backspace__ key pressed until you see an `OK` prompt (alternatively, for a short time during boot, it says `Hit [Enter] to boot immediately, or any other key for command prompt.`. Press the __Esc__ key on your keyboard immediately when you see this) +1. Type `unset boot_mute` and press the __Enter__ key. This disables the graphical splash screen and results in boot messages being shown 1. Type `boot -v -s` and press the __Enter__ key. This results in the system being booted in verbose single-user mode The computer should boot into a text console rescue system in which parts of `init.sh` from the ramdisk image have run. From f5dd7c2ecc012cb8fb0deebfc909fdad66076816 Mon Sep 17 00:00:00 2001 From: probonopd Date: Tue, 8 Dec 2020 02:53:00 +0100 Subject: [PATCH 119/592] Update getting-started.md --- user/getting-started.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/user/getting-started.md b/user/getting-started.md index e16ff615..fbe71b05 100644 --- a/user/getting-started.md +++ b/user/getting-started.md @@ -33,7 +33,7 @@ Please report back about the results on your virtualization environment. ## Downloading -Continuous builds of pre-alpha ISO images are available for download [here](https://github.com/helloSystem/ISO/releases/tag/continuous-hello). +Pre-alpha ISO images are available for download [here](https://github.com/helloSystem/ISO/releases/). ```eval_rst important:: Images get built automatically whenever source code is committed. Not every build is tested. From 8ba9533abd2c8588fce70697a5d153e90670efae Mon Sep 17 00:00:00 2001 From: probonopd Date: Tue, 8 Dec 2020 02:54:27 +0100 Subject: [PATCH 120/592] Update menu.md --- user/components/system/menu.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/user/components/system/menu.md b/user/components/system/menu.md index d464984a..912f2860 100644 --- a/user/components/system/menu.md +++ b/user/components/system/menu.md @@ -33,7 +33,7 @@ To shut down your computer, select "Log Out" from the "System" menu, then click ## Searching in application menus -Click into the "Search in Menu" box in the menu bar, or press Alt+Space. Then enter a few characters of the menu entry you would like to execute, select one of the matches from the list, and press the Enter key. +Click on "Search" in the menu bar, or press __Alt+Space__. Then enter a few characters of the menu entry you would like to execute, select one of the matches from the list, and press the Enter key. If only one choice remains left as you are typing, the remaining entry automatically gets selected. ## Date and time From c8e72afc491fd26fc7fe3468552b434f845a1519 Mon Sep 17 00:00:00 2001 From: probonopd Date: Tue, 8 Dec 2020 18:48:06 +0100 Subject: [PATCH 121/592] Remove solved section [ci skip] --- developer/contributing.md | 1 - 1 file changed, 1 deletion(-) diff --git a/developer/contributing.md b/developer/contributing.md index 2cc66563..01ce9f59 100644 --- a/developer/contributing.md +++ b/developer/contributing.md @@ -37,7 +37,6 @@ Skills/resources we don't currently have and would highly appreciate help with |---|---|---|---|---| |FreeBSD kernel|Overhaul/bugfixing for unionfs.ko to create a read-write root filesystem|Idea|Save time and RAM by not having to copy the whole root filesystem to RAM|probonopd| |OpenZFS|A way to combine read-only (Live ISO) with read-write (ramdisk) to create a read-write root filesystem|Idea|Save time and RAM by not having to copy the whole root filesystem to RAM|probonopd| -|FreeBSD kernel, graphics|Zero-text bootsplash that shows a boot animation and hides all text unless verbosity is explicitly requested|Idea|Put together "appliance" style systems that are not frightening non-technical users|probonopd| |FreeBSD build system|Kernel-related packages built for each FreeBSD version ([details](https://github.com/furybsd/furybsd-livecd/issues/241))|idea|Xorg fails on 12.2-RELEASE|probonopd| |FreeBSD Linuxulator|Make it possible for Linux applications to use FreeBSD D-Bus|Idea|Have Linux applications to use the [global menu](https://github.com/helloSystem/Menu) that is running on FreeBSD|probonopd| |FreeBSD kernel, Golang|Enable Go-based FUSE filesystems for FreeBSD ([issue](https://github.com/jacobsa/fuse/issues/91))|Idea|Packages that are images rather than archives: Experiment with [distr1](http://distr1.org/) concepts on FreeBSD|probonopd| From e7c1c85d22a7853c0db85b0216ff936dd6c4faae Mon Sep 17 00:00:00 2001 From: probonopd Date: Tue, 8 Dec 2020 18:50:31 +0100 Subject: [PATCH 122/592] Boot Mute --- developer/boot.md | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) diff --git a/developer/boot.md b/developer/boot.md index d26091f9..ef8d1c74 100644 --- a/developer/boot.md +++ b/developer/boot.md @@ -56,3 +56,27 @@ The computer should boot into a text console rescue system in which parts of `in ## Installed system boot process The boot process is the regular FreeBSD boot process. Please refer to [The FreeBSD Booting Process](https://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/boot.html) for more information. + +## Boot Mute + +Setting `boot_mute="YES"` in `/boot/loader.conf` causes FreeBSD to show a boot splash screen instead of kernel messages during early boot. However, as soon as scripts from the ramdisk and init get executed, they tend to write output to the screen and manipulate it with `vidcontrol` and `conscontrol`, which results in the boot splash screen to disappear before the graphical desktop environment is started. + +Since helloSystem targets a broad audience including non-technical users, the following behavior is intended: +* By default, show no textual boot messages +* Upon specific request by the user, show boot messages (for debugging, development, and system administration) +* Show a graphical splash screen during the entire boot process, all the way until the graphical desktop is started + +To achieve this, helloSystem uses a combination of the following techniques: + +* Read the `boot_mute` kernel environment variable and adjust the userland boot process accordingly +* Modify `/etc/rc` to run `conscontrol delete ttyv0` and redirect all of its output to `/dev/null` if `boot_mute` is set to `YES` +* Modify `/etc/rc.shutdown` to redirect all of its output to `/dev/null` if `boot_mute` is set to `YES` +* Replace the `/sbin/vidcontrol` command by a dummy that does nothing to prevent error messages related to setting the resolution of the text-mode console from ending the boot splash early +* Replace the `/etc/ttys` file with an empty file to not spawn login shells on the text-mode console +* On the Live system, modify all scripts in the ramdisk to redirect all of their output to `/dev/null` if `boot_mute` is set to `YES` + +``` .. note:: + Please note that if any errors are displayed on the screen during the boot process, the boot splash may still end early. In this case, the reason for the error message needs to be identified, and the message needs to be silenced. +``` + +To see boot messages, set `boot_mute="NO"` in `/boot/loader.conf` or at the bootloader prompt. From 1db6a385f667de54942950d421a046a2ca68612c Mon Sep 17 00:00:00 2001 From: probonopd Date: Tue, 8 Dec 2020 20:29:39 +0100 Subject: [PATCH 123/592] /etc/syslog.conf --- developer/boot.md | 1 + 1 file changed, 1 insertion(+) diff --git a/developer/boot.md b/developer/boot.md index ef8d1c74..0ca207c3 100644 --- a/developer/boot.md +++ b/developer/boot.md @@ -73,6 +73,7 @@ To achieve this, helloSystem uses a combination of the following techniques: * Modify `/etc/rc.shutdown` to redirect all of its output to `/dev/null` if `boot_mute` is set to `YES` * Replace the `/sbin/vidcontrol` command by a dummy that does nothing to prevent error messages related to setting the resolution of the text-mode console from ending the boot splash early * Replace the `/etc/ttys` file with an empty file to not spawn login shells on the text-mode console +* Commenting out the line that ends in `/dev/console` in `/etc/syslog.conf` to prevent boot from being visually interrupted by `syslog` messages * On the Live system, modify all scripts in the ramdisk to redirect all of their output to `/dev/null` if `boot_mute` is set to `YES` ``` .. note:: From 1ca19fd76ef3a7fd129add260659f72a0c229d5f Mon Sep 17 00:00:00 2001 From: probonopd Date: Wed, 9 Dec 2020 23:08:02 +0100 Subject: [PATCH 124/592] graphics [ci skip] --- developer/graphics.md | 42 ++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 42 insertions(+) create mode 100644 developer/graphics.md diff --git a/developer/graphics.md b/developer/graphics.md new file mode 100644 index 00000000..64a637d2 --- /dev/null +++ b/developer/graphics.md @@ -0,0 +1,42 @@ +# Graphics hardware autoconfiguration + +helloSystem uses `initgfx` for the automatic configuration of the graphics hardware in your computer. + +## Theory of operation + +`initgfx` consists of the following files and directories: + +``` +/etc/rc.d/initgfx +/etc/initgfx_device.db +/etc/initgfx_xorg.cfg +/usr/local/nvidia// +``` + +`initgfx` calculates a config ID which is a MD5 checksum of the output of `sysctl +dev.vgapci | sort`. If the file `/var/initgfx_config.id` exists, check if +its content matches the config ID. If that is the case, load the modules +set via the `rc.conf` variable `initgfx_kmods`, and exit. If the file +`/var/initgfx_config.id` does not exist, or its content does not match the +config ID, try to auto-detect the accelerated graphics driver. Use `xinit` +to test if the X server starts, change `initgfx_kmods`, write a new xorg +config file, and save the new config ID if the test was successful. +Otherwise, as a fallback, write a xorg config file for the VESA or SCFB +driver depending on whether the system was booted via BIOS or EFI. + +[Source](https://github.com/nomadbsd/NomadBSD/commit/a346f134aaca1cdc164346f63808abdb4d8919e3) + +## Disabling the graphics driver menu + +If you want to disable the graphics driver menu, add + +`initgfx_menu="NO"` to `/etc/rc.conf`. + +By default, initgfx will try autodetection, but you can instead define a default driver to use by setting `initgfx_default` to `scfb` or `vesa` in `/etc/rc.conf`. + + +## Disabling the automatic graphics driver setup + +If you want to create your own graphics driver settings, you can disable initgfx by adding + +`initgfx_enable="NO"` to `/etc/rc.conf`. From 63191c65fbb559233eb075a1ab78dc937d62d612 Mon Sep 17 00:00:00 2001 From: probonopd Date: Wed, 9 Dec 2020 23:08:20 +0100 Subject: [PATCH 125/592] Add graphics --- developer/index.md | 1 + 1 file changed, 1 insertion(+) diff --git a/developer/index.md b/developer/index.md index 16620ed8..e1940711 100644 --- a/developer/index.md +++ b/developer/index.md @@ -6,6 +6,7 @@ :glob: boot + graphics applications contributing building From 3a60a088776a99d6a20ae14ce0f0426008f4fd5a Mon Sep 17 00:00:00 2001 From: probonopd Date: Wed, 9 Dec 2020 23:19:24 +0100 Subject: [PATCH 126/592] mrclksr --- developer/acknowledgements.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/developer/acknowledgements.md b/developer/acknowledgements.md index e2564892..de632600 100644 --- a/developer/acknowledgements.md +++ b/developer/acknowledgements.md @@ -65,3 +65,7 @@ __[TheAssassin](https://github.com/TheAssassin)__ ## Leodanis Pozo Ramos __[lpozo](https://github.com/lpozo)__ * Wrote tutorial and sample code that forms the basis for Calculator.app + +## Marcel Kaiser +__[mrclksr](https://github.com/mrclksr)__ +* Wrote `initgfx` graphics hardware autoconfiguration From ee2b864ecb4e73ce2f6e4546af94b09284c4bf0a Mon Sep 17 00:00:00 2001 From: probonopd Date: Thu, 10 Dec 2020 21:57:49 +0100 Subject: [PATCH 127/592] Update graphics.md --- developer/graphics.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/developer/graphics.md b/developer/graphics.md index 64a637d2..86582f50 100644 --- a/developer/graphics.md +++ b/developer/graphics.md @@ -11,6 +11,7 @@ helloSystem uses `initgfx` for the automatic configuration of the graphics hardw /etc/initgfx_device.db /etc/initgfx_xorg.cfg /usr/local/nvidia// +/usr/local/etc/X11/xorg.conf.d/ # defined by path_xorg_cfg_dir ``` `initgfx` calculates a config ID which is a MD5 checksum of the output of `sysctl @@ -40,3 +41,7 @@ By default, initgfx will try autodetection, but you can instead define a default If you want to create your own graphics driver settings, you can disable initgfx by adding `initgfx_enable="NO"` to `/etc/rc.conf`. + +## Troubleshooting + +If applications that are using OpenGL crash on Nvidia systems, then it may be that the Nvidia driver was correctly loaded but the wrong Xorg configuration has been loaded, not actually using the Nvidia driver. This can happen when initgfx writes the dynamically generated Xorg configuration to `path_xorg_cfg_dir` (which points to `/usr/local/etc/X11/xorg.conf.d/` by default) but other files have been placed by other packages or the user into, e.g., `/etc/X11/xorg.conf.d`. You can verify which Xorg configuration directory was used by Xorg with `cat /var/log/Xorg.0.log | grep Using.config`. Seemingly Xorg cannot combine configuration stored in multiple `xorg.conf.d` directories. From 64bb3b4156a42e7216a2300eb7df622a6b56ea06 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 12 Dec 2020 10:55:39 +0100 Subject: [PATCH 128/592] Update boot.md --- developer/boot.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/developer/boot.md b/developer/boot.md index 0ca207c3..16254f60 100644 --- a/developer/boot.md +++ b/developer/boot.md @@ -10,8 +10,8 @@ This is a simplified description of the boot process. There may be additional as 1. The bootloader gets loaded 1. The bootloader loads the kernel modules that are required for the Live system boot process as specified in `overlays/boot/boot/loader.conf`. Note that the bootloader apparently is not smart enough to load the dependencies of kernel modules, so one needs to manually specify those as well. For example, `zfs.ko` up to FreeBSD 12 requires `opensolaris.ko` and from 13 onward requires `cryptodev.ko` -1. The bootloader loads the ramdisk image `ramdisk.ufs` as specified in `overlays/boot/boot/loader.conf`. The contents of the ramdisk image are specified in `overlays/ramdisk` -1. `init.sh` from the ramdisk image gets executed as specified in `overlays/ramdisk/init.sh`. It constructs a r/w Live filesystem tree (e.g., by replicating the system image to swap-based memdisk) at `/livecd` +1. The bootloader loads the ramdisk image `ramdisk.ufs` as specified in `overlays/boot/boot/loader.conf` under `mfsroot_name`. The contents of the ramdisk image are specified in `overlays/ramdisk` +1. `init.sh` from the ramdisk image gets executed as requested by `overlays/boot/boot/loader.conf` under `init_script` and specified in `overlays/ramdisk/init.sh`. It constructs a r/w Live filesystem tree (e.g., by replicating the system image to swap-based memdisk) at `/livecd` 1. `/usr/local/bin/furybsd-init-helper` gets executed by `init.sh` in a chroot of the live filesystem, `/livecd`. It is defined in `overlays/uzip/furybsd-live-settings/files/usr/local/bin/furybsd-init-helper` and deals with loading Xorg configuration based on the detected devices on PCI, and with loading virtualization-related drivers 1. The `/livecd` chroot is exited 1. `init.sh` from the ramdisk image exits From 040e60dd27f85ab04f64d7808316673ceb5bfa11 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 12 Dec 2020 23:10:51 +0100 Subject: [PATCH 129/592] Update getting-started.md --- user/getting-started.md | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/user/getting-started.md b/user/getting-started.md index fbe71b05..faf34cc5 100644 --- a/user/getting-started.md +++ b/user/getting-started.md @@ -26,9 +26,15 @@ hello is known to boot to a graphical desktop on the following machines. Auxilia ![helloSystem on VirtualBox in BIOS EFI mode](https://user-images.githubusercontent.com/2480569/101068320-dc2a6880-3598-11eb-9304-28655c8f17a5.png) -* VirtualBox host (on FreeBSD), known to work in BIOS and EFI mode +* VirtualBox host (on FreeBSD and on macOS), known to work in BIOS and EFI mode * VMware host (on Windows), possibly only working in BIOS mode? +Pleaase note: + +* The VM needs to be 64-bit +* The VM needs at least 4 GB of RAM which is higher than the VirtualBox default +* The boot process takes longer than you might expect; boot `-v` to see the details + Please report back about the results on your virtualization environment. ## Downloading From aa8a142de8be9606762216715879b1784f09915e Mon Sep 17 00:00:00 2001 From: probonopd Date: Wed, 23 Dec 2020 18:54:15 +0100 Subject: [PATCH 130/592] Add Remote Assistance --- user/components/preferences/shortcuts.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/user/components/preferences/shortcuts.md b/user/components/preferences/shortcuts.md index 74da44ee..22fc1083 100644 --- a/user/components/preferences/shortcuts.md +++ b/user/components/preferences/shortcuts.md @@ -2,6 +2,11 @@ The __Shortcut Keys__ preferences application lets you view and edit system-wide keyboard shortcuts. + +``` .. note:: + The Ctrl and Alt keys are swapped in helloSystem by default to make shortcuts feel welcoming to switchers coming from the Mac. +``` + A __shortcut__ is a key or key combination you can press to invoke a defined action on your computer. Shortcuts can be defined by applications (per-application shortcuts), or can affect the whole system (system-wide shortcuts). ``` .. note:: From 80d617d024ddb49b7d86d28ca609e218bc455210 Mon Sep 17 00:00:00 2001 From: probonopd Date: Wed, 23 Dec 2020 19:01:49 +0100 Subject: [PATCH 131/592] Clarify Shortcuts --- user/components/preferences/shortcuts.md | 2 +- user/components/utilities/remote-assistance.md | 15 +++++++++++++++ 2 files changed, 16 insertions(+), 1 deletion(-) create mode 100644 user/components/utilities/remote-assistance.md diff --git a/user/components/preferences/shortcuts.md b/user/components/preferences/shortcuts.md index 22fc1083..47854f33 100644 --- a/user/components/preferences/shortcuts.md +++ b/user/components/preferences/shortcuts.md @@ -4,7 +4,7 @@ The __Shortcut Keys__ preferences application lets you view and edit system-wide ``` .. note:: - The Ctrl and Alt keys are swapped in helloSystem by default to make shortcuts feel welcoming to switchers coming from the Mac. + The left Ctrl and Alt keys are swapped in helloSystem by default to make shortcuts feel welcoming to switchers coming from the Mac. ``` A __shortcut__ is a key or key combination you can press to invoke a defined action on your computer. Shortcuts can be defined by applications (per-application shortcuts), or can affect the whole system (system-wide shortcuts). diff --git a/user/components/utilities/remote-assistance.md b/user/components/utilities/remote-assistance.md new file mode 100644 index 00000000..903c9368 --- /dev/null +++ b/user/components/utilities/remote-assistance.md @@ -0,0 +1,15 @@ +# Remote Assistance + +The __Remote Assistance__ application allows a peer on the Internet to access and control your computer using the encrypted peer-to-peer Tox protocol. + +## Receiving Remote Assistance + +To get help form a peer, open the Remote Assistance application. Once a connection has been made, a long string is shown on the screen. This string has also been copied to the clipbord. Give that string to your remote peer, e.g., by pasting it into a mail or chat window. + +## Giving Remote Assistance + +As the remote peer (the person providing help), open the Remote Assistance application, and select "Give Assistance" from the menu. Paste the long string you received into the text box and click "Connect". + +## About the Tox protocol + +The __Remote Assistance__ application uses the Tox protocol to tunnel traffic. Tox is a peer-to-peer protocol that offers end-to-end encryption. The stated goal of the project is to provide secure yet easily accessible communication for everyone. From 044aff972c5e13b54134cd01aa3ede78fd027fcd Mon Sep 17 00:00:00 2001 From: probonopd Date: Wed, 23 Dec 2020 19:57:07 +0100 Subject: [PATCH 132/592] Update remote-assistance.md --- user/components/utilities/remote-assistance.md | 14 +++++++++++--- 1 file changed, 11 insertions(+), 3 deletions(-) diff --git a/user/components/utilities/remote-assistance.md b/user/components/utilities/remote-assistance.md index 903c9368..11d2519a 100644 --- a/user/components/utilities/remote-assistance.md +++ b/user/components/utilities/remote-assistance.md @@ -1,14 +1,22 @@ # Remote Assistance -The __Remote Assistance__ application allows a peer on the Internet to access and control your computer using the encrypted peer-to-peer Tox protocol. +The __Remote Assistance__ application allows a peer on the Internet to access and control your computer using the encrypted peer-to-peer Tox protocol. This can be helpful, e.g., to receive help from a friend. + +``` .. warning:: + Running the **Remote Assistance** utility will give your peer access to the screen of your computer and to any ports that may be open on your machine. Only share the ID with people you trust. + + This operation cannot be undone. +``` ## Receiving Remote Assistance -To get help form a peer, open the Remote Assistance application. Once a connection has been made, a long string is shown on the screen. This string has also been copied to the clipbord. Give that string to your remote peer, e.g., by pasting it into a mail or chat window. +To get help form a peer, open the Remote Assistance application. Once a connection has been made, a long string (the ID) is shown on the screen. This string has also been copied to the clipbord. Give that string to your remote peer, e.g., by pasting it into a mail or chat window. + +Once your peer has successfully connected, they will be able to see and operate anything on your screen, and to connect to any ports that may be open on your machine. ## Giving Remote Assistance -As the remote peer (the person providing help), open the Remote Assistance application, and select "Give Assistance" from the menu. Paste the long string you received into the text box and click "Connect". +As the remote peer (the person providing help), open the Remote Assistance application, and select "Give Assistance" from the menu. Paste the long string (the ID) you received into the text box and click "Connect". ## About the Tox protocol From a30d6fc29e923ccaf521cadda3766b41ae9b3a08 Mon Sep 17 00:00:00 2001 From: probonopd Date: Wed, 23 Dec 2020 19:58:56 +0100 Subject: [PATCH 133/592] Update remote-assistance.md --- user/components/utilities/remote-assistance.md | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/user/components/utilities/remote-assistance.md b/user/components/utilities/remote-assistance.md index 11d2519a..bd430c23 100644 --- a/user/components/utilities/remote-assistance.md +++ b/user/components/utilities/remote-assistance.md @@ -1,6 +1,6 @@ # Remote Assistance -The __Remote Assistance__ application allows a peer on the Internet to access and control your computer using the encrypted peer-to-peer Tox protocol. This can be helpful, e.g., to receive help from a friend. +The __Remote Assistance__ utility allows a peer on the Internet to access and control your computer using the encrypted peer-to-peer Tox protocol. This can be helpful, e.g., to receive help from a friend. ``` .. warning:: Running the **Remote Assistance** utility will give your peer access to the screen of your computer and to any ports that may be open on your machine. Only share the ID with people you trust. @@ -10,13 +10,15 @@ The __Remote Assistance__ application allows a peer on the Internet to access an ## Receiving Remote Assistance -To get help form a peer, open the Remote Assistance application. Once a connection has been made, a long string (the ID) is shown on the screen. This string has also been copied to the clipbord. Give that string to your remote peer, e.g., by pasting it into a mail or chat window. +To get help form a peer, open the Remote Assistance utility. Once a connection has been made, a long string (the ID) is shown on the screen. This string has also been copied to the clipbord. Give that string to your remote peer, e.g., by pasting it into a mail or chat window. Once your peer has successfully connected, they will be able to see and operate anything on your screen, and to connect to any ports that may be open on your machine. ## Giving Remote Assistance -As the remote peer (the person providing help), open the Remote Assistance application, and select "Give Assistance" from the menu. Paste the long string (the ID) you received into the text box and click "Connect". +As the remote peer (the person providing help), open the Remote Assistance utility, and select "Give Assistance" from the File menu. Paste the long string (the ID) you received into the text box and click "Connect". + +Once the connection has been made, you will be able to see and operate the screen of the other machine. ## About the Tox protocol From 74449db4909f36fd33eca7020f49d9cf80a86d7b Mon Sep 17 00:00:00 2001 From: probonopd Date: Wed, 23 Dec 2020 20:04:04 +0100 Subject: [PATCH 134/592] Update remote-assistance.md --- user/components/utilities/remote-assistance.md | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/user/components/utilities/remote-assistance.md b/user/components/utilities/remote-assistance.md index bd430c23..8ae09b31 100644 --- a/user/components/utilities/remote-assistance.md +++ b/user/components/utilities/remote-assistance.md @@ -3,9 +3,7 @@ The __Remote Assistance__ utility allows a peer on the Internet to access and control your computer using the encrypted peer-to-peer Tox protocol. This can be helpful, e.g., to receive help from a friend. ``` .. warning:: - Running the **Remote Assistance** utility will give your peer access to the screen of your computer and to any ports that may be open on your machine. Only share the ID with people you trust. - - This operation cannot be undone. + Running the **Remote Assistance** utility will give your peer access to the screen, mouse, and keyboard of your computer, and read-write to any ports that may be open on your machine. Only share the ID with people you trust. ``` ## Receiving Remote Assistance From 1a0919fb5714957e5d4b1fdd59fad4bba1c04609 Mon Sep 17 00:00:00 2001 From: Graham Perrin Date: Thu, 24 Dec 2020 21:16:18 +0000 Subject: [PATCH 135/592] Update contributing.md (#6) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit https://github.com/helloSystem/ISO/releases/tag/continuous-hello 404 not found ∴ https://github.com/helloSystem/ISO/releases --- developer/contributing.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/developer/contributing.md b/developer/contributing.md index 01ce9f59..a105c778 100644 --- a/developer/contributing.md +++ b/developer/contributing.md @@ -8,7 +8,7 @@ This is a small, purely volunteer-driven project, so your contributions are _hig ## How to get started? -* Download the pre-alpha Live ISO from https://github.com/helloSystem/ISO/releases/tag/continuous-hello +* Download an experimental live ISO from https://github.com/helloSystem/ISO/releases * Look through the GitHub Issues sections of the projects within https://github.com/helloSystem/ * A great way to get started is to comment on some GitHub issues. Also feel free to open new ones. We use GitHub Issues as a means of discussion and keeping track of everything, so don't hesitate to use them. General topics not related to any particular component go to https://github.com/helloSystem/hello/issues * Especially have a look at issues marked with ![](https://user-images.githubusercontent.com/2480569/97901371-64b8ad80-1d3c-11eb-8282-0bfdcd3fe512.png). Here your contributions would be especially helpful, but of course your contibutions to other tickets are more than welcome, too From fdf3ecc44e80c8b9fb69cd71b1949af35a8a597e Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 26 Dec 2020 22:41:39 +0100 Subject: [PATCH 136/592] Update feedback.md --- user/feedback.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/user/feedback.md b/user/feedback.md index b03c5444..8e5ec852 100644 --- a/user/feedback.md +++ b/user/feedback.md @@ -7,3 +7,7 @@ If you would share your experience with helloSystem on twitter, use the [`#hello ## Discussing ideas and wishlist items Please check [https://github.com/helloSystem/hello](https://github.com/helloSystem/hello) fist, including the [wiki](https://github.com/helloSystem/hello/wiki). Feel free to discuss ideas and wishlist items at [https://github.com/helloSystem/hello/issues](https://github.com/helloSystem/hello/issues), but please do keep in mind that in order to achieve the intended goal of simplicity, the team needs to say "no" to most wishlist items that do not further that goal. + +# IRC + +`#helloSystem` channel on `irc.freenode.net`. Please stay in the channel for a few days and do not expect to receive answers immediately, since we are all volunteers. (More about [Internet Relay Chat](https://en.wikipedia.org/wiki/Internet_Relay_Chat)) From 3771268870cc7003a8d5786503a72acc6070507a Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 26 Dec 2020 22:42:55 +0100 Subject: [PATCH 137/592] Add #helloSystem IRC channel --- user/feedback.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/user/feedback.md b/user/feedback.md index 8e5ec852..ba9f59ec 100644 --- a/user/feedback.md +++ b/user/feedback.md @@ -8,6 +8,6 @@ If you would share your experience with helloSystem on twitter, use the [`#hello Please check [https://github.com/helloSystem/hello](https://github.com/helloSystem/hello) fist, including the [wiki](https://github.com/helloSystem/hello/wiki). Feel free to discuss ideas and wishlist items at [https://github.com/helloSystem/hello/issues](https://github.com/helloSystem/hello/issues), but please do keep in mind that in order to achieve the intended goal of simplicity, the team needs to say "no" to most wishlist items that do not further that goal. -# IRC +## IRC -`#helloSystem` channel on `irc.freenode.net`. Please stay in the channel for a few days and do not expect to receive answers immediately, since we are all volunteers. (More about [Internet Relay Chat](https://en.wikipedia.org/wiki/Internet_Relay_Chat)) +You can meet other helloSystem users and developers in the `#helloSystem` [Internet Relay Chat](https://en.wikipedia.org/wiki/Internet_Relay_Chat) channel at `irc.freenode.net`. Please stay in the channel for a few days and do not expect to receive answers immediately, since we are all volunteers. From e4d83911df2f89f9011df72eaaae3db1dfb08a25 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 27 Dec 2020 08:52:47 +0100 Subject: [PATCH 138/592] Add Graham Perrin --- developer/acknowledgements.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/developer/acknowledgements.md b/developer/acknowledgements.md index de632600..225ce04b 100644 --- a/developer/acknowledgements.md +++ b/developer/acknowledgements.md @@ -69,3 +69,7 @@ __[lpozo](https://github.com/lpozo)__ ## Marcel Kaiser __[mrclksr](https://github.com/mrclksr)__ * Wrote `initgfx` graphics hardware autoconfiguration + +## Graham Perrin +__[grahamperrin](https://github.com/grahamperrin)__ +* Provided early testing and feedback From 0d69709b13e07add6cc47cad8ec355430277228a Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 27 Dec 2020 11:29:54 +0100 Subject: [PATCH 139/592] Update feedback.md --- user/feedback.md | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/user/feedback.md b/user/feedback.md index ba9f59ec..f77d77c1 100644 --- a/user/feedback.md +++ b/user/feedback.md @@ -8,6 +8,10 @@ If you would share your experience with helloSystem on twitter, use the [`#hello Please check [https://github.com/helloSystem/hello](https://github.com/helloSystem/hello) fist, including the [wiki](https://github.com/helloSystem/hello/wiki). Feel free to discuss ideas and wishlist items at [https://github.com/helloSystem/hello/issues](https://github.com/helloSystem/hello/issues), but please do keep in mind that in order to achieve the intended goal of simplicity, the team needs to say "no" to most wishlist items that do not further that goal. -## IRC +## IRC and Matrix -You can meet other helloSystem users and developers in the `#helloSystem` [Internet Relay Chat](https://en.wikipedia.org/wiki/Internet_Relay_Chat) channel at `irc.freenode.net`. Please stay in the channel for a few days and do not expect to receive answers immediately, since we are all volunteers. +You can meet other helloSystem users and developers in the `#helloSystem` [Internet Relay Chat](https://en.wikipedia.org/wiki/Internet_Relay_Chat) channel at `irc.freenode.net`. + +If you prefer using Matrix, then you can `/join #freenode_#helloSystem:matrix.org` from a typical Matrix client. This Matrix channel is [bridged](https://matrix.org/blog/2015/06/22/the-matrix-org-irc-bridge-now-bridges-all-of-freenode) to the IRC channel. + +In any case, please stay in the channel for a few days and do not expect to receive answers immediately, since we are all volunteers. From f02ceb3f0a4e9fd64859c6e6cd81a4990fdd3d26 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 28 Dec 2020 10:20:10 +0100 Subject: [PATCH 140/592] Update feedback.md --- user/feedback.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/user/feedback.md b/user/feedback.md index f77d77c1..5d69405b 100644 --- a/user/feedback.md +++ b/user/feedback.md @@ -12,6 +12,6 @@ Please check [https://github.com/helloSystem/hello](https://github.com/helloSyst You can meet other helloSystem users and developers in the `#helloSystem` [Internet Relay Chat](https://en.wikipedia.org/wiki/Internet_Relay_Chat) channel at `irc.freenode.net`. -If you prefer using Matrix, then you can `/join #freenode_#helloSystem:matrix.org` from a typical Matrix client. This Matrix channel is [bridged](https://matrix.org/blog/2015/06/22/the-matrix-org-irc-bridge-now-bridges-all-of-freenode) to the IRC channel. +If you prefer using Matrix, then you can `#helloSystem:matrix.org` from a Matrix client. This Matrix channel is [bridged](https://matrix.org/blog/2015/06/22/the-matrix-org-irc-bridge-now-bridges-all-of-freenode) to the IRC channel. Joining via Matrix has the advantage that you will see responses that you may have received while you were offline. So after asking a question, you can come back in a day or so to see if there were any responses. In any case, please stay in the channel for a few days and do not expect to receive answers immediately, since we are all volunteers. From 27b812d8d10f608d052ac467e5dbf53a34224810 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 28 Dec 2020 10:21:29 +0100 Subject: [PATCH 141/592] Update feedback.md --- user/feedback.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/user/feedback.md b/user/feedback.md index 5d69405b..d50726d9 100644 --- a/user/feedback.md +++ b/user/feedback.md @@ -12,6 +12,6 @@ Please check [https://github.com/helloSystem/hello](https://github.com/helloSyst You can meet other helloSystem users and developers in the `#helloSystem` [Internet Relay Chat](https://en.wikipedia.org/wiki/Internet_Relay_Chat) channel at `irc.freenode.net`. -If you prefer using Matrix, then you can `#helloSystem:matrix.org` from a Matrix client. This Matrix channel is [bridged](https://matrix.org/blog/2015/06/22/the-matrix-org-irc-bridge-now-bridges-all-of-freenode) to the IRC channel. Joining via Matrix has the advantage that you will see responses that you may have received while you were offline. So after asking a question, you can come back in a day or so to see if there were any responses. +If you prefer using Matrix, then you can [`#helloSystem:matrix.org`](https://matrix.to/#/#helloSystem:matrix.org) from any Matrix client (such as the Element web-based Matrix client). This Matrix channel is [bridged](https://matrix.org/blog/2015/06/22/the-matrix-org-irc-bridge-now-bridges-all-of-freenode) to the IRC channel. Joining via Matrix has the advantage that you will see responses that you may have received while you were offline. So after asking a question, you can come back in a day or so to see if there were any responses. In any case, please stay in the channel for a few days and do not expect to receive answers immediately, since we are all volunteers. From 59f5839277528671393e551ea0822fda6b511141 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 28 Dec 2020 10:22:06 +0100 Subject: [PATCH 142/592] Update feedback.md --- user/feedback.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/user/feedback.md b/user/feedback.md index d50726d9..ee578d1f 100644 --- a/user/feedback.md +++ b/user/feedback.md @@ -8,7 +8,7 @@ If you would share your experience with helloSystem on twitter, use the [`#hello Please check [https://github.com/helloSystem/hello](https://github.com/helloSystem/hello) fist, including the [wiki](https://github.com/helloSystem/hello/wiki). Feel free to discuss ideas and wishlist items at [https://github.com/helloSystem/hello/issues](https://github.com/helloSystem/hello/issues), but please do keep in mind that in order to achieve the intended goal of simplicity, the team needs to say "no" to most wishlist items that do not further that goal. -## IRC and Matrix +## Chat You can meet other helloSystem users and developers in the `#helloSystem` [Internet Relay Chat](https://en.wikipedia.org/wiki/Internet_Relay_Chat) channel at `irc.freenode.net`. From 3eb9efe6678f7136a5fcb929555f6b4d9e9b94f3 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 28 Dec 2020 11:27:55 +0100 Subject: [PATCH 143/592] Minor edit [ci skip] --- user/feedback.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/user/feedback.md b/user/feedback.md index ee578d1f..8b7fb0e6 100644 --- a/user/feedback.md +++ b/user/feedback.md @@ -12,6 +12,6 @@ Please check [https://github.com/helloSystem/hello](https://github.com/helloSyst You can meet other helloSystem users and developers in the `#helloSystem` [Internet Relay Chat](https://en.wikipedia.org/wiki/Internet_Relay_Chat) channel at `irc.freenode.net`. -If you prefer using Matrix, then you can [`#helloSystem:matrix.org`](https://matrix.to/#/#helloSystem:matrix.org) from any Matrix client (such as the Element web-based Matrix client). This Matrix channel is [bridged](https://matrix.org/blog/2015/06/22/the-matrix-org-irc-bridge-now-bridges-all-of-freenode) to the IRC channel. Joining via Matrix has the advantage that you will see responses that you may have received while you were offline. So after asking a question, you can come back in a day or so to see if there were any responses. +Alternatively, you can [`#helloSystem:matrix.org`](https://matrix.to/#/#helloSystem:matrix.org) from any Matrix client (such as the Element web-based Matrix client). This Matrix channel is [bridged](https://matrix.org/blog/2015/06/22/the-matrix-org-irc-bridge-now-bridges-all-of-freenode) to the IRC channel. Joining via Matrix has the advantage that you will see responses that you may have received while you were offline. So after asking a question, you can come back in a day or so to see if there were any responses. In any case, please stay in the channel for a few days and do not expect to receive answers immediately, since we are all volunteers. From 019ed6a71b064270fff703e0f7ddb4edcf4607cc Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 28 Dec 2020 11:28:04 +0100 Subject: [PATCH 144/592] Update information --- developer/contact.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/developer/contact.md b/developer/contact.md index fe335b7a..bf656ad1 100644 --- a/developer/contact.md +++ b/developer/contact.md @@ -1,3 +1,7 @@ # Contact -Developers chat at `#FuryBSD` on `irc.freenode.net`. Since we are working in different timezones, do not expect immediate answers. It is best to stay connected for at least a couple of days or so. +You can meet other helloSystem users and developers in the `#helloSystem` [Internet Relay Chat](https://en.wikipedia.org/wiki/Internet_Relay_Chat) channel at `irc.freenode.net`. + +Alternatively, you can [`#helloSystem:matrix.org`](https://matrix.to/#/#helloSystem:matrix.org) from any Matrix client (such as the Element web-based Matrix client). This Matrix channel is [bridged](https://matrix.org/blog/2015/06/22/the-matrix-org-irc-bridge-now-bridges-all-of-freenode) to the IRC channel. Joining via Matrix has the advantage that you will see responses that you may have received while you were offline. So after asking a question, you can come back in a day or so to see if there were any responses. + +In any case, please stay in the channel for a few days and do not expect to receive answers immediately, since we are all volunteers. From b1c7aa81a4fef3a8f7acdf41374d8b9a26c5af3e Mon Sep 17 00:00:00 2001 From: probonopd Date: Tue, 29 Dec 2020 11:06:58 +0100 Subject: [PATCH 145/592] Switch pre-alpha to experimental --- conf.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/conf.py b/conf.py index 4675339f..9212a08b 100644 --- a/conf.py +++ b/conf.py @@ -27,7 +27,7 @@ author = 'probono' # The full version, including alpha/beta/rc tags -release = 'pre-alpha' +release = 'experimental' # -- General configuration --------------------------------------------------- From a521e64132296d92fcbf8e24ceb85ce5b082b607 Mon Sep 17 00:00:00 2001 From: probonopd Date: Wed, 30 Dec 2020 00:57:33 +0100 Subject: [PATCH 146/592] Update index.md --- index.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/index.md b/index.md index 7f02cec1..13491b0b 100644 --- a/index.md +++ b/index.md @@ -18,5 +18,12 @@ __hello__ (also known as __helloSystem__) is a desktop system for creators with :maxdepth: 2 user/index +``` + +```eval_rst +.. toctree:: + :hidden: + :maxdepth: 2 + developer/index ``` From b9ee895c826e761f5d05f15f8590edc2c0f6c937 Mon Sep 17 00:00:00 2001 From: probonopd Date: Wed, 30 Dec 2020 01:02:56 +0100 Subject: [PATCH 147/592] Update index.md --- index.md | 20 ++++++++++++++++---- 1 file changed, 16 insertions(+), 4 deletions(-) diff --git a/index.md b/index.md index 13491b0b..0f03604d 100644 --- a/index.md +++ b/index.md @@ -14,16 +14,28 @@ __hello__ (also known as __helloSystem__) is a desktop system for creators with ```eval_rst .. toctree:: - :hidden: :maxdepth: 2 + :caption: User Guide + :glob: - user/index + user/getting-started + user/components + user/troubleshooting + user/feedback ``` ```eval_rst .. toctree:: - :hidden: + :caption: Developer Guide :maxdepth: 2 + :glob: - developer/index + developer/boot + developer/graphics + developer/applications + developer/contributing + developer/building + developer/distributions + developer/acknowledgements + developer/contact ``` From 0e065c2c4327ea399cc5e6460e41b98b51c69748 Mon Sep 17 00:00:00 2001 From: probonopd Date: Wed, 30 Dec 2020 01:07:06 +0100 Subject: [PATCH 148/592] :hidden: --- index.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/index.md b/index.md index 0f03604d..cf215e46 100644 --- a/index.md +++ b/index.md @@ -16,6 +16,7 @@ __hello__ (also known as __helloSystem__) is a desktop system for creators with .. toctree:: :maxdepth: 2 :caption: User Guide + :hidden: :glob: user/getting-started @@ -27,6 +28,7 @@ __hello__ (also known as __helloSystem__) is a desktop system for creators with ```eval_rst .. toctree:: :caption: Developer Guide + :hidden: :maxdepth: 2 :glob: From 0bb4e4a9e1236e251e34288c01b5aa3538f74d11 Mon Sep 17 00:00:00 2001 From: probonopd Date: Thu, 31 Dec 2020 11:04:43 +0100 Subject: [PATCH 149/592] Add menu []ci skip --- developer/index.md | 1 + 1 file changed, 1 insertion(+) diff --git a/developer/index.md b/developer/index.md index e1940711..5532dc36 100644 --- a/developer/index.md +++ b/developer/index.md @@ -8,6 +8,7 @@ boot graphics applications + menu contributing building distributions From 93013c86636368a977cddd95b9448e2dcc726592 Mon Sep 17 00:00:00 2001 From: probonopd Date: Thu, 31 Dec 2020 11:31:13 +0100 Subject: [PATCH 150/592] Create menu.md --- developer/menu.md | 57 +++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 57 insertions(+) create mode 100644 developer/menu.md diff --git a/developer/menu.md b/developer/menu.md new file mode 100644 index 00000000..ad263ee3 --- /dev/null +++ b/developer/menu.md @@ -0,0 +1,57 @@ +# Global Menu + +helloSystem intends to provide a unified user experience for all applications regardless of toolkit being used by application developers. + +To provide this unified user experience, it is crucial that all applications can show their commands in the system-wide global menu. + +## Terminology + +``` .. note:: +Consistent, up-to-date documentation reagarding the subject of global menus is hard to find. + +Please consider submitting issues and pull requests if you can contribute to this subject. +``` + +### Concepts + +* __Global menubar__: A concept in user interface design where a system-wide widget on the screen displays the menu items (also known as "actions" in Qt) for all applications +* __Menu__: The application in helloSystem that shows the global menubar +* [__Status Menu__](https://wiki.ubuntu.com/CustomStatusMenuDesignGuidelines): The term used by Canonical to describe the icons in the upper-right corner of the screen that are usually used for long-running background processes +* [__System Tray__ = __Notification Area__](https://en.wikipedia.org/wiki/Notification_area): The term that describes the icons on the bottom-right corner of the screen on Windows +* [__Application (Panel) Indicators__](https://wiki.ubuntu.com/DesktopExperienceTeam/ApplicationIndicators): Another term used by Canonical to describe __Status Menus__? +* [__Application Menu or appmenu__]: ? + +### Implementations + +Those may or may not be used in helloSystem, they are mentioned here to give an overview over the field so that technical discussions can be had. + +* __Panel__: Ubuntu calls the widget at the top of the screen the "panel". In helloSystem, the rough equivalent is __Menu__. +* [__Aytana__](https://wiki.ubuntu.com/Ayatana): The Buddhist term for a "sense base" or "sense sphere". A project by Canonical to improve user experience in Ubuntu. Abandoned? +* [__Application Menu or appmenu__](https://wiki.ubuntu.com/DesktopExperienceTeam/ApplicationMenu): As part of Aytana, Canonical has produced an implementation called `indicator-appmenu` which re-routes Gtk and Qt menus over `dbusmenu` so that they appear in the panel +* [__dbusmenu__](https://wiki.ubuntu.com/DesktopExperienceTeam/ApplicationIndicators#Software_Architecture): Library by Canonical implementing the transport protocol between the applications and the panel +* [__libappindicator__](https://wiki.ubuntu.com/DesktopExperienceTeam/ApplicationIndicators#Software_Architecture): Library by Canonical to register icons and menus and internally uses dbusmenu to publish context menus over dbus + +## Libraries involved + +The following libraries are involved in allowing applications to show their menu items in the global menu: + +``` +/usr/local/lib/gtk-2.0/modules/libappmenu-gtk-module.so +/usr/local/lib/gtk-3.0/modules/libappmenu-gtk-module.so +/usr/local/lib/libappmenu-gtk2-parser.so +/usr/local/lib/libappmenu-gtk2-parser.so.0 +/usr/local/lib/libappmenu-gtk3-parser.so +/usr/local/lib/libappmenu-gtk3-parser.so.0 +/usr/local/lib/libdbusmenu-glib.so +/usr/local/lib/libdbusmenu-glib.so.4 +/usr/local/lib/libdbusmenu-glib.so.4.0.12 +/usr/local/lib/libdbusmenu-gtk3.so +/usr/local/lib/libdbusmenu-gtk3.so.4 +/usr/local/lib/libdbusmenu-gtk3.so.4.0.12 +/usr/local/lib/libdbusmenu-qt5.so +/usr/local/lib/libdbusmenu-qt5.so.2 +/usr/local/lib/libdbusmenu-qt5.so.2.6.0 +/usr/local/lib/qt5/plugins/kf5/kded/appmenu.so +/usr/local/lib/qt5/plugins/plasma/applets/plasma_applet_appmenu.so +/usr/local/lib/qt5/qml/org/kde/plasma/private/appmenu/libappmenuplugin.so +``` From 15d8af60d900eba9c5cf0176bab1250d316d20e2 Mon Sep 17 00:00:00 2001 From: probonopd Date: Thu, 31 Dec 2020 11:39:41 +0100 Subject: [PATCH 151/592] Update menu.md --- developer/menu.md | 104 ++++++++++++++++++++++++++++++++++++++++++++-- 1 file changed, 101 insertions(+), 3 deletions(-) diff --git a/developer/menu.md b/developer/menu.md index ad263ee3..0f841ffb 100644 --- a/developer/menu.md +++ b/developer/menu.md @@ -19,7 +19,6 @@ Please consider submitting issues and pull requests if you can contribute to thi * [__Status Menu__](https://wiki.ubuntu.com/CustomStatusMenuDesignGuidelines): The term used by Canonical to describe the icons in the upper-right corner of the screen that are usually used for long-running background processes * [__System Tray__ = __Notification Area__](https://en.wikipedia.org/wiki/Notification_area): The term that describes the icons on the bottom-right corner of the screen on Windows * [__Application (Panel) Indicators__](https://wiki.ubuntu.com/DesktopExperienceTeam/ApplicationIndicators): Another term used by Canonical to describe __Status Menus__? -* [__Application Menu or appmenu__]: ? ### Implementations @@ -29,29 +28,128 @@ Those may or may not be used in helloSystem, they are mentioned here to give an * [__Aytana__](https://wiki.ubuntu.com/Ayatana): The Buddhist term for a "sense base" or "sense sphere". A project by Canonical to improve user experience in Ubuntu. Abandoned? * [__Application Menu or appmenu__](https://wiki.ubuntu.com/DesktopExperienceTeam/ApplicationMenu): As part of Aytana, Canonical has produced an implementation called `indicator-appmenu` which re-routes Gtk and Qt menus over `dbusmenu` so that they appear in the panel * [__dbusmenu__](https://wiki.ubuntu.com/DesktopExperienceTeam/ApplicationIndicators#Software_Architecture): Library by Canonical implementing the transport protocol between the applications and the panel -* [__libappindicator__](https://wiki.ubuntu.com/DesktopExperienceTeam/ApplicationIndicators#Software_Architecture): Library by Canonical to register icons and menus and internally uses dbusmenu to publish context menus over dbus +* [__libappindicator__](https://wiki.ubuntu.com/DesktopExperienceTeam/ApplicationIndicators#Software_Architecture): Library by Canonical to register icons and menus and internally uses dbusmenu to publish context menus over dbus. The same as [`indicator-application`](https://launchpad.net/indicator-application)? ## Libraries involved -The following libraries are involved in allowing applications to show their menu items in the global menu: +The following libraries are involved in allowing applications to show their menu items in the global menu. + +``` .. note:: +This list is probably incomplete. + +Please consider submitting issues and pull requests if you can contribute to this subject. +``` + +### libappmenu-gtk-module ``` /usr/local/lib/gtk-2.0/modules/libappmenu-gtk-module.so /usr/local/lib/gtk-3.0/modules/libappmenu-gtk-module.so +``` + +* Author: +* Description: +* Bugtracker: +* Purpose: +* Theory of operation: +* Status: + +### libappmenu-gtk2-parser and libappmenu-gtk3-parser + +``` /usr/local/lib/libappmenu-gtk2-parser.so /usr/local/lib/libappmenu-gtk2-parser.so.0 /usr/local/lib/libappmenu-gtk3-parser.so /usr/local/lib/libappmenu-gtk3-parser.so.0 +``` + +* Author: +* Description: +* Bugtracker: +* Purpose: +* Theory of operation: +* Status: + +### libdbusmenu-glib + +``` /usr/local/lib/libdbusmenu-glib.so /usr/local/lib/libdbusmenu-glib.so.4 /usr/local/lib/libdbusmenu-glib.so.4.0.12 +``` + +* Author: +* Description: +* Bugtracker: +* Purpose: +* Theory of operation: +* Status: + +### libdbusmenu-gtk3 + +``` /usr/local/lib/libdbusmenu-gtk3.so /usr/local/lib/libdbusmenu-gtk3.so.4 /usr/local/lib/libdbusmenu-gtk3.so.4.0.12 +``` + +* Author: +* Description: +* Bugtracker: +* Purpose: +* Theory of operation: +* Status: + +### libdbusmenu-qt5 + +``` /usr/local/lib/libdbusmenu-qt5.so /usr/local/lib/libdbusmenu-qt5.so.2 /usr/local/lib/libdbusmenu-qt5.so.2.6.0 +``` + +* Author: +* Description: +* Bugtracker: +* Purpose: +* Theory of operation: +* Status: + +### Kf5 Appmenu Plugin + +``` /usr/local/lib/qt5/plugins/kf5/kded/appmenu.so +``` + +* Author: +* Description: +* Bugtracker: +* Purpose: +* Theory of operation: +* Status: + +### Kf5 Plasma Applet Appmenu Plugin + +``` /usr/local/lib/qt5/plugins/plasma/applets/plasma_applet_appmenu.so +``` + +* Author: +* Description: +* Bugtracker: +* Purpose: +* Theory of operation: +* Status: + +### Kf5 Plasma Private libappmenuplugin + +``` /usr/local/lib/qt5/qml/org/kde/plasma/private/appmenu/libappmenuplugin.so ``` + +* Author: +* Description: +* Bugtracker: +* Purpose: +* Theory of operation: +* Status: From 76915f24b63abc7c028d6b641be1c2a15fd966d3 Mon Sep 17 00:00:00 2001 From: probonopd Date: Thu, 31 Dec 2020 11:40:47 +0100 Subject: [PATCH 152/592] Add menu --- index.md | 1 + 1 file changed, 1 insertion(+) diff --git a/index.md b/index.md index cf215e46..e7fa4b0a 100644 --- a/index.md +++ b/index.md @@ -35,6 +35,7 @@ __hello__ (also known as __helloSystem__) is a desktop system for creators with developer/boot developer/graphics developer/applications + developer/menu developer/contributing developer/building developer/distributions From 9f5231adcf0dc18c8e024c03aa8085fb99a080ec Mon Sep 17 00:00:00 2001 From: probonopd Date: Thu, 31 Dec 2020 11:41:28 +0100 Subject: [PATCH 153/592] Remove duplicate index [ci skip] --- developer/index.md | 17 ----------------- 1 file changed, 17 deletions(-) delete mode 100644 developer/index.md diff --git a/developer/index.md b/developer/index.md deleted file mode 100644 index 5532dc36..00000000 --- a/developer/index.md +++ /dev/null @@ -1,17 +0,0 @@ -# Developer Guide - -```eval_rst -.. toctree:: - :maxdepth: 2 - :glob: - - boot - graphics - applications - menu - contributing - building - distributions - acknowledgements - contact -``` From d45fa9f8c7899f82908b0859253194e5aa9d1687 Mon Sep 17 00:00:00 2001 From: probonopd Date: Thu, 31 Dec 2020 11:41:42 +0100 Subject: [PATCH 154/592] Remove duplicate index --- user/index.md | 12 ------------ 1 file changed, 12 deletions(-) delete mode 100644 user/index.md diff --git a/user/index.md b/user/index.md deleted file mode 100644 index 73c8bae8..00000000 --- a/user/index.md +++ /dev/null @@ -1,12 +0,0 @@ -# User Guide - -```eval_rst -.. toctree:: - :maxdepth: 2 - :glob: - - getting-started - components - troubleshooting - feedback -``` From 826ee159764755ae8fc56871da3ca1a9397f2eaa Mon Sep 17 00:00:00 2001 From: probonopd Date: Thu, 31 Dec 2020 11:50:10 +0100 Subject: [PATCH 155/592] Create hardware-probe.md --- user/components/utilities/hardware-probe.md | 27 +++++++++++++++++++++ 1 file changed, 27 insertions(+) create mode 100644 user/components/utilities/hardware-probe.md diff --git a/user/components/utilities/hardware-probe.md b/user/components/utilities/hardware-probe.md new file mode 100644 index 00000000..00cae0d2 --- /dev/null +++ b/user/components/utilities/hardware-probe.md @@ -0,0 +1,27 @@ +# Hardware Probe + +The __Hardware Probe__ utility collects hardware details of your computer and can anonymously upload them to the public database at [http://bsd-hardware.info/](http://bsd-hardware.info/). + +This can help users and operating system developers to collaboratively debug hardware related issues, check for operating system compatibility and find drivers. + +You will get a permanent probe URL to view and share collected information. + +## Data Privacy + +The Hardware Probe utility can upload the hardware probe to the hardware database. The probe will be published publicly under a permanent URL to view the probe. + +Private information (including the username, machine's hostname, IP addresses, MAC addresses, UUIDs and serial numbers) is NOT uploaded to the database. + +The tool uploads 32-byte prefix of salted SHA512 hash of MAC addresses/UUIDs and serial numbers to properly identify unique computers and hard drives. All the data is uploaded securely via HTTPS. + +``` .. note:: +By using this utility to upload your hardware probe, you agree that +information about your hardware will be uploaded +to a publicly visible database. + +Do not use this utility if you do not agree with this. +``` + +By uploading your hardware probe you confirm uploading of 32-byte prefix of salted SHA512 hash of MAC addresses and serial numbers to prevent duplication of computers in the database. + +The web service and the database are operated by https://linux-hardware.org. The authors of the graphical Hardware Probe utility are not associated with the operator of the web service. Please contact https://linux-hardware.org/index.php?view=contacts in case of questions and in case you wish accidentally submitted probes to be removed from the database. From 4188a65b6c095dade45d5e5ccbd553eb805a9f3a Mon Sep 17 00:00:00 2001 From: probonopd Date: Thu, 31 Dec 2020 11:52:38 +0100 Subject: [PATCH 156/592] Update menu.md --- developer/menu.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/developer/menu.md b/developer/menu.md index 0f841ffb..17f2b7fa 100644 --- a/developer/menu.md +++ b/developer/menu.md @@ -15,7 +15,7 @@ Please consider submitting issues and pull requests if you can contribute to thi ### Concepts * __Global menubar__: A concept in user interface design where a system-wide widget on the screen displays the menu items (also known as "actions" in Qt) for all applications -* __Menu__: The application in helloSystem that shows the global menubar +* [__Menu__](https://github.com/helloSystem/Menu/): The application in helloSystem that shows the global menubar * [__Status Menu__](https://wiki.ubuntu.com/CustomStatusMenuDesignGuidelines): The term used by Canonical to describe the icons in the upper-right corner of the screen that are usually used for long-running background processes * [__System Tray__ = __Notification Area__](https://en.wikipedia.org/wiki/Notification_area): The term that describes the icons on the bottom-right corner of the screen on Windows * [__Application (Panel) Indicators__](https://wiki.ubuntu.com/DesktopExperienceTeam/ApplicationIndicators): Another term used by Canonical to describe __Status Menus__? From bbc793ef9c76bf21a3a991c9f87b9ffa8e31d1da Mon Sep 17 00:00:00 2001 From: probonopd Date: Thu, 31 Dec 2020 11:54:25 +0100 Subject: [PATCH 157/592] Fix rst [ci skip] --- developer/menu.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/developer/menu.md b/developer/menu.md index 17f2b7fa..520ac49a 100644 --- a/developer/menu.md +++ b/developer/menu.md @@ -7,9 +7,9 @@ To provide this unified user experience, it is crucial that all applications can ## Terminology ``` .. note:: -Consistent, up-to-date documentation reagarding the subject of global menus is hard to find. + Consistent, up-to-date documentation reagarding the subject of global menus is hard to find. -Please consider submitting issues and pull requests if you can contribute to this subject. + Please consider submitting issues and pull requests if you can contribute to this subject. ``` ### Concepts @@ -35,9 +35,9 @@ Those may or may not be used in helloSystem, they are mentioned here to give an The following libraries are involved in allowing applications to show their menu items in the global menu. ``` .. note:: -This list is probably incomplete. + This list is probably incomplete. -Please consider submitting issues and pull requests if you can contribute to this subject. + Please consider submitting issues and pull requests if you can contribute to this subject. ``` ### libappmenu-gtk-module From 0000beae4916e950385460d5623b09492b3301fa Mon Sep 17 00:00:00 2001 From: probonopd Date: Thu, 31 Dec 2020 11:55:04 +0100 Subject: [PATCH 158/592] Fix rst --- user/components/utilities/hardware-probe.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/user/components/utilities/hardware-probe.md b/user/components/utilities/hardware-probe.md index 00cae0d2..6f62d6d0 100644 --- a/user/components/utilities/hardware-probe.md +++ b/user/components/utilities/hardware-probe.md @@ -15,11 +15,11 @@ Private information (including the username, machine's hostname, IP addresses, M The tool uploads 32-byte prefix of salted SHA512 hash of MAC addresses/UUIDs and serial numbers to properly identify unique computers and hard drives. All the data is uploaded securely via HTTPS. ``` .. note:: -By using this utility to upload your hardware probe, you agree that + By using this utility to upload your hardware probe, you agree that information about your hardware will be uploaded to a publicly visible database. -Do not use this utility if you do not agree with this. + Do not use this utility if you do not agree with this. ``` By uploading your hardware probe you confirm uploading of 32-byte prefix of salted SHA512 hash of MAC addresses and serial numbers to prevent duplication of computers in the database. From c635f3fe693f68db653f292b9364cb2d6eb9b93d Mon Sep 17 00:00:00 2001 From: probonopd Date: Thu, 31 Dec 2020 12:12:05 +0100 Subject: [PATCH 159/592] Update menu.md --- developer/menu.md | 45 +++++++++++++++++++++++++++++++++++++++++---- 1 file changed, 41 insertions(+), 4 deletions(-) diff --git a/developer/menu.md b/developer/menu.md index 520ac49a..37e1e7a8 100644 --- a/developer/menu.md +++ b/developer/menu.md @@ -14,7 +14,7 @@ To provide this unified user experience, it is crucial that all applications can ### Concepts -* __Global menubar__: A concept in user interface design where a system-wide widget on the screen displays the menu items (also known as "actions" in Qt) for all applications +* __Global menu bar__: A concept in user interface design where a system-wide widget on the screen displays the menu items (also known as "actions" in Qt) for all applications * [__Menu__](https://github.com/helloSystem/Menu/): The application in helloSystem that shows the global menubar * [__Status Menu__](https://wiki.ubuntu.com/CustomStatusMenuDesignGuidelines): The term used by Canonical to describe the icons in the upper-right corner of the screen that are usually used for long-running background processes * [__System Tray__ = __Notification Area__](https://en.wikipedia.org/wiki/Notification_area): The term that describes the icons on the bottom-right corner of the screen on Windows @@ -29,6 +29,7 @@ Those may or may not be used in helloSystem, they are mentioned here to give an * [__Application Menu or appmenu__](https://wiki.ubuntu.com/DesktopExperienceTeam/ApplicationMenu): As part of Aytana, Canonical has produced an implementation called `indicator-appmenu` which re-routes Gtk and Qt menus over `dbusmenu` so that they appear in the panel * [__dbusmenu__](https://wiki.ubuntu.com/DesktopExperienceTeam/ApplicationIndicators#Software_Architecture): Library by Canonical implementing the transport protocol between the applications and the panel * [__libappindicator__](https://wiki.ubuntu.com/DesktopExperienceTeam/ApplicationIndicators#Software_Architecture): Library by Canonical to register icons and menus and internally uses dbusmenu to publish context menus over dbus. The same as [`indicator-application`](https://launchpad.net/indicator-application)? +* [__MenuModel__](): Used by Gtk ## Libraries involved @@ -40,20 +41,42 @@ The following libraries are involved in allowing applications to show their menu Please consider submitting issues and pull requests if you can contribute to this subject. ``` -### libappmenu-gtk-module +### libappmenu-gtk-module library from vala-panel-appmenu repository ``` /usr/local/lib/gtk-2.0/modules/libappmenu-gtk-module.so /usr/local/lib/gtk-3.0/modules/libappmenu-gtk-module.so ``` +* Author: [__@rilian-la-te__](https://github.com/rilian-la-te). This module was originally used in Ubuntu's Unity +Desktop Environment, but it lives on as part of the Vala project. +* Description: +* Bugtracker: https://github.com/rilian-la-te (upstream), https://github.com/NorwegianRockCat/FreeBSD-my-ports (FreeBSD Port) +* Purpose: Make Gtk applications export their menus to a global menu bar +* Theory of operation: Gtk module that strips menus from all Gtk +programs, converts to them MenuModel and send to them AppMenu +(sometimes called a global menu bar). `unity-gtk-module` is used as a backend, and thus must also be installed +* Status: +* Issues: Supposedly used by Firefox and Chrome but those applications are not functional with Menu in helloSystem yet +* Installed by package: `appmenu-gtk-module` + +### unity-gtk-module + +Currently __not__ used in helloSystem. Do we need it? + +``` +tbd +``` + * Author: * Description: * Bugtracker: * Purpose: * Theory of operation: * Status: - +* Issues: +* Installed by package: In Ubuntu, `sudo apt-get install unity-gtk-module-common unity-gtk2-module unity-gtk3-module` + ### libappmenu-gtk2-parser and libappmenu-gtk3-parser ``` @@ -69,6 +92,8 @@ The following libraries are involved in allowing applications to show their menu * Purpose: * Theory of operation: * Status: +* Issues: +* Installed by package: `` ### libdbusmenu-glib @@ -84,6 +109,8 @@ The following libraries are involved in allowing applications to show their menu * Purpose: * Theory of operation: * Status: +* Issues: +* Installed by package: `` ### libdbusmenu-gtk3 @@ -99,7 +126,9 @@ The following libraries are involved in allowing applications to show their menu * Purpose: * Theory of operation: * Status: - +* Issues: +* Installed by package: `` + ### libdbusmenu-qt5 ``` @@ -114,6 +143,8 @@ The following libraries are involved in allowing applications to show their menu * Purpose: * Theory of operation: * Status: +* Issues: +* Installed by package: `` ### Kf5 Appmenu Plugin @@ -127,6 +158,8 @@ The following libraries are involved in allowing applications to show their menu * Purpose: * Theory of operation: * Status: +* Issues: +* Installed by package: `` ### Kf5 Plasma Applet Appmenu Plugin @@ -140,6 +173,8 @@ The following libraries are involved in allowing applications to show their menu * Purpose: * Theory of operation: * Status: +* Issues: +* Installed by package: `` ### Kf5 Plasma Private libappmenuplugin @@ -153,3 +188,5 @@ The following libraries are involved in allowing applications to show their menu * Purpose: * Theory of operation: * Status: +* Issues: +* Installed by package: `` From f948d4fda864097883560f65543f8db6c84f8391 Mon Sep 17 00:00:00 2001 From: probonopd Date: Thu, 31 Dec 2020 12:24:16 +0100 Subject: [PATCH 160/592] Update menu.md --- developer/menu.md | 18 ++++++++++-------- 1 file changed, 10 insertions(+), 8 deletions(-) diff --git a/developer/menu.md b/developer/menu.md index 37e1e7a8..e98ab0fd 100644 --- a/developer/menu.md +++ b/developer/menu.md @@ -28,8 +28,10 @@ Those may or may not be used in helloSystem, they are mentioned here to give an * [__Aytana__](https://wiki.ubuntu.com/Ayatana): The Buddhist term for a "sense base" or "sense sphere". A project by Canonical to improve user experience in Ubuntu. Abandoned? * [__Application Menu or appmenu__](https://wiki.ubuntu.com/DesktopExperienceTeam/ApplicationMenu): As part of Aytana, Canonical has produced an implementation called `indicator-appmenu` which re-routes Gtk and Qt menus over `dbusmenu` so that they appear in the panel * [__dbusmenu__](https://wiki.ubuntu.com/DesktopExperienceTeam/ApplicationIndicators#Software_Architecture): Library by Canonical implementing the transport protocol between the applications and the panel +* [__DBusMenu protocol__](): Protocol for which implementations exist for Glib, Gtk, Qt (starting with Qt 2). Applications can export their menus (question: only indicators or all menus?) using this protocol. The specification used to be at https://people.canonical.com/~agateau/dbusmenu/spec/index.html but the link is dead as of 2020. On https://agateau.com/2009/statusnotifieritem-and-dbusmenu/ it is described as: "The goal of DBusMenu is to make it possible for applications using the StatusNotifierItem spec to send their menus over DBus, so that the workspace can display them in a consistent way, regardless of whether the application is written using Qt, GTK or another toolkit." * [__libappindicator__](https://wiki.ubuntu.com/DesktopExperienceTeam/ApplicationIndicators#Software_Architecture): Library by Canonical to register icons and menus and internally uses dbusmenu to publish context menus over dbus. The same as [`indicator-application`](https://launchpad.net/indicator-application)? * [__MenuModel__](): Used by Gtk +* [__JAyatana__](): Supposedly allows for displaying global menus in Java Swing applications (such as Netbeans and the JetBrains suite of IDEs) ## Libraries involved @@ -56,8 +58,8 @@ Desktop Environment, but it lives on as part of the Vala project. * Theory of operation: Gtk module that strips menus from all Gtk programs, converts to them MenuModel and send to them AppMenu (sometimes called a global menu bar). `unity-gtk-module` is used as a backend, and thus must also be installed -* Status: -* Issues: Supposedly used by Firefox and Chrome but those applications are not functional with Menu in helloSystem yet +* Status: active +* Issues: Supposedly used by Firefox and Chrome but those applications are not functional with Menu in helloSystem yet. Upstream documentation [advises](https://github.com/rilian-la-te/vala-panel-appmenu#post-build-instructions) "Install `libdbusmenu-glib libdbusmenu-gtk3 libdbusmenu-gtk2` to get Chromium/Google Chrome to work" * Installed by package: `appmenu-gtk-module` ### unity-gtk-module @@ -74,8 +76,8 @@ tbd * Purpose: * Theory of operation: * Status: -* Issues: -* Installed by package: In Ubuntu, `sudo apt-get install unity-gtk-module-common unity-gtk2-module unity-gtk3-module` +* Issues: Not in ports? Is this an issue, preventing us from some applications to work properly? +* Installed by package: Not in ports? (In Ubuntu, `sudo apt-get install unity-gtk-module-common unity-gtk2-module unity-gtk3-module`) ### libappmenu-gtk2-parser and libappmenu-gtk3-parser @@ -104,13 +106,13 @@ tbd ``` * Author: -* Description: +* Description: GLib implementation of the DBusMenu protocol * Bugtracker: * Purpose: * Theory of operation: * Status: * Issues: -* Installed by package: `` +* Installed by package: `libdbusmenu` ### libdbusmenu-gtk3 @@ -121,13 +123,13 @@ tbd ``` * Author: -* Description: +* Description: Gtk implementation of the DBusMenu protocol * Bugtracker: * Purpose: * Theory of operation: * Status: * Issues: -* Installed by package: `` +* Installed by package: `libdbusmenu` ### libdbusmenu-qt5 From d7efcdfa3cbbd93d5d992d2ea720e7bafb7b2482 Mon Sep 17 00:00:00 2001 From: probonopd Date: Thu, 31 Dec 2020 12:28:17 +0100 Subject: [PATCH 161/592] Update menu.md --- developer/menu.md | 13 ++++++++----- 1 file changed, 8 insertions(+), 5 deletions(-) diff --git a/developer/menu.md b/developer/menu.md index e98ab0fd..f5ba1bf2 100644 --- a/developer/menu.md +++ b/developer/menu.md @@ -20,6 +20,10 @@ To provide this unified user experience, it is crucial that all applications can * [__System Tray__ = __Notification Area__](https://en.wikipedia.org/wiki/Notification_area): The term that describes the icons on the bottom-right corner of the screen on Windows * [__Application (Panel) Indicators__](https://wiki.ubuntu.com/DesktopExperienceTeam/ApplicationIndicators): Another term used by Canonical to describe __Status Menus__? +### Specifications + +* [__DBusMenu protocol__](): Protocol for which implementations exist for Glib, Gtk, Qt (starting with Qt 2). Applications can export and import their menus (question: only indicators or all menus?) using this protocol. The specification used to be at https://people.canonical.com/~agateau/dbusmenu/spec/index.html but the link is dead as of 2020. On https://agateau.com/2009/statusnotifieritem-and-dbusmenu/ it is described as: "The goal of DBusMenu is to make it possible for applications using the StatusNotifierItem spec to send their menus over DBus, so that the workspace can display them in a consistent way, regardless of whether the application is written using Qt, GTK or another toolkit." Possibly it has significantly evolved since then? + ### Implementations Those may or may not be used in helloSystem, they are mentioned here to give an overview over the field so that technical discussions can be had. @@ -28,7 +32,6 @@ Those may or may not be used in helloSystem, they are mentioned here to give an * [__Aytana__](https://wiki.ubuntu.com/Ayatana): The Buddhist term for a "sense base" or "sense sphere". A project by Canonical to improve user experience in Ubuntu. Abandoned? * [__Application Menu or appmenu__](https://wiki.ubuntu.com/DesktopExperienceTeam/ApplicationMenu): As part of Aytana, Canonical has produced an implementation called `indicator-appmenu` which re-routes Gtk and Qt menus over `dbusmenu` so that they appear in the panel * [__dbusmenu__](https://wiki.ubuntu.com/DesktopExperienceTeam/ApplicationIndicators#Software_Architecture): Library by Canonical implementing the transport protocol between the applications and the panel -* [__DBusMenu protocol__](): Protocol for which implementations exist for Glib, Gtk, Qt (starting with Qt 2). Applications can export their menus (question: only indicators or all menus?) using this protocol. The specification used to be at https://people.canonical.com/~agateau/dbusmenu/spec/index.html but the link is dead as of 2020. On https://agateau.com/2009/statusnotifieritem-and-dbusmenu/ it is described as: "The goal of DBusMenu is to make it possible for applications using the StatusNotifierItem spec to send their menus over DBus, so that the workspace can display them in a consistent way, regardless of whether the application is written using Qt, GTK or another toolkit." * [__libappindicator__](https://wiki.ubuntu.com/DesktopExperienceTeam/ApplicationIndicators#Software_Architecture): Library by Canonical to register icons and menus and internally uses dbusmenu to publish context menus over dbus. The same as [`indicator-application`](https://launchpad.net/indicator-application)? * [__MenuModel__](): Used by Gtk * [__JAyatana__](): Supposedly allows for displaying global menus in Java Swing applications (such as Netbeans and the JetBrains suite of IDEs) @@ -140,13 +143,13 @@ tbd ``` * Author: -* Description: -* Bugtracker: +* Description: Qt5 implementation of the DBusMenu protocol +* Bugtracker: https://launchpad.net/libdbusmenu-qt * Purpose: * Theory of operation: -* Status: +* Status: active * Issues: -* Installed by package: `` +* Installed by package: `libdbusmenu-qt` ### Kf5 Appmenu Plugin From 4916d511a35ae8fb6fe3add8950cdab301cc7d31 Mon Sep 17 00:00:00 2001 From: probonopd Date: Thu, 31 Dec 2020 12:41:44 +0100 Subject: [PATCH 162/592] Update menu.md --- developer/menu.md | 22 +++++++++++++++++++++- 1 file changed, 21 insertions(+), 1 deletion(-) diff --git a/developer/menu.md b/developer/menu.md index f5ba1bf2..328edccf 100644 --- a/developer/menu.md +++ b/developer/menu.md @@ -20,9 +20,12 @@ To provide this unified user experience, it is crucial that all applications can * [__System Tray__ = __Notification Area__](https://en.wikipedia.org/wiki/Notification_area): The term that describes the icons on the bottom-right corner of the screen on Windows * [__Application (Panel) Indicators__](https://wiki.ubuntu.com/DesktopExperienceTeam/ApplicationIndicators): Another term used by Canonical to describe __Status Menus__? -### Specifications +### APIs + +APIs can be described in specifications, protocols, and interfaces. * [__DBusMenu protocol__](): Protocol for which implementations exist for Glib, Gtk, Qt (starting with Qt 2). Applications can export and import their menus (question: only indicators or all menus?) using this protocol. The specification used to be at https://people.canonical.com/~agateau/dbusmenu/spec/index.html but the link is dead as of 2020. On https://agateau.com/2009/statusnotifieritem-and-dbusmenu/ it is described as: "The goal of DBusMenu is to make it possible for applications using the StatusNotifierItem spec to send their menus over DBus, so that the workspace can display them in a consistent way, regardless of whether the application is written using Qt, GTK or another toolkit." Possibly it has significantly evolved since then? +* [__org.gtk.Menus interface__](https://wiki.gnome.org/Projects/GLib/GApplication/DBusAPI#org.gtk.Menus): An interface defined by Gnome that "is primarily concerned with three things: communicating menus to the client, establishing links between menus and other menus, and notifying clients of changes". Note that "To do so, it employs a number of D-Bus interfaces. These interfaces are currently considered private implementation details of GApplication and subject to change - therefore they are not documented in the GIO documentation." ([Source](https://wiki.gnome.org/Projects/GLib/GApplication/DBusAPI#org.gtk.Menus)). __How does it relate to the DBusMenu protocol, does it have an overlapping scope or is it a complement?__ ### Implementations @@ -195,3 +198,20 @@ tbd * Status: * Issues: * Installed by package: `` + +## Executables involved + +### GMenu-DBusMenu-Proxy + +``` +/usr/local/bin/gmenudbusmenuproxy +``` + +* Author: Kai Uwe Broulik (KDE) +* Description: +* Bugtracker: https://phabricator.kde.org/D10461 +* Purpose: . Translate between the org.gtk.Menus interface used by Gtk applications and what is needed to satisfy the KDE global menu bar? (Why does KDE need something special?) +* Theory of operation: This application finds windows using GTK GMenu DBus interfaces and forwards them through DBusMenu. (...) LibreOffice with appmenu-gtk-module (...) Works with Gimp or Inkscape if you have appmenu-gtk-module (there's GTK2 and GTK3 variants) installed and GTK_MODULES=appmenu-gtk-module environment variable set. ([Source](https://phabricator.kde.org/transactions/detail/PHID-XACT-DREV-jz6tqizldlvwmv6/)) +* Status: +* Issues: Can we get it "standalone", without KDE Plasma? +* Installed by package: `plasma5-plasma-workspace` From 6da1beb8afc204d19ad133f33c887634634f8242 Mon Sep 17 00:00:00 2001 From: probonopd Date: Thu, 31 Dec 2020 12:47:39 +0100 Subject: [PATCH 163/592] Update menu.md --- developer/menu.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/developer/menu.md b/developer/menu.md index 328edccf..09bdbddb 100644 --- a/developer/menu.md +++ b/developer/menu.md @@ -210,8 +210,8 @@ tbd * Author: Kai Uwe Broulik (KDE) * Description: * Bugtracker: https://phabricator.kde.org/D10461 -* Purpose: . Translate between the org.gtk.Menus interface used by Gtk applications and what is needed to satisfy the KDE global menu bar? (Why does KDE need something special?) -* Theory of operation: This application finds windows using GTK GMenu DBus interfaces and forwards them through DBusMenu. (...) LibreOffice with appmenu-gtk-module (...) Works with Gimp or Inkscape if you have appmenu-gtk-module (there's GTK2 and GTK3 variants) installed and GTK_MODULES=appmenu-gtk-module environment variable set. ([Source](https://phabricator.kde.org/transactions/detail/PHID-XACT-DREV-jz6tqizldlvwmv6/)) +* Purpose: . Translate between the org.gtk.Menus interface used by Gtk applications and what is needed to satisfy the KDE global menu bar (and helloSystem Menu which is derived from it)? (Why does KDE need something special?) +* Theory of operation: This application finds windows using GTK GMenu DBus interfaces and forwards them through DBusMenu. (...) LibreOffice with appmenu-gtk-module (...) Works with Gimp or Inkscape if you have appmenu-gtk-module (there's GTK2 and GTK3 variants) installed and GTK_MODULES=appmenu-gtk-module environment variable set. ([Source](https://phabricator.kde.org/transactions/detail/PHID-XACT-DREV-jz6tqizldlvwmv6/), [more information](https://blog.broulik.de/2018/03/gtk-global-menu/)) * Status: * Issues: Can we get it "standalone", without KDE Plasma? * Installed by package: `plasma5-plasma-workspace` From f2404de8c72aebc0f142230bd34eb7aea6fafa20 Mon Sep 17 00:00:00 2001 From: probonopd Date: Thu, 31 Dec 2020 12:50:13 +0100 Subject: [PATCH 164/592] Update menu.md --- developer/menu.md | 1 + 1 file changed, 1 insertion(+) diff --git a/developer/menu.md b/developer/menu.md index 09bdbddb..3312c164 100644 --- a/developer/menu.md +++ b/developer/menu.md @@ -26,6 +26,7 @@ APIs can be described in specifications, protocols, and interfaces. * [__DBusMenu protocol__](): Protocol for which implementations exist for Glib, Gtk, Qt (starting with Qt 2). Applications can export and import their menus (question: only indicators or all menus?) using this protocol. The specification used to be at https://people.canonical.com/~agateau/dbusmenu/spec/index.html but the link is dead as of 2020. On https://agateau.com/2009/statusnotifieritem-and-dbusmenu/ it is described as: "The goal of DBusMenu is to make it possible for applications using the StatusNotifierItem spec to send their menus over DBus, so that the workspace can display them in a consistent way, regardless of whether the application is written using Qt, GTK or another toolkit." Possibly it has significantly evolved since then? * [__org.gtk.Menus interface__](https://wiki.gnome.org/Projects/GLib/GApplication/DBusAPI#org.gtk.Menus): An interface defined by Gnome that "is primarily concerned with three things: communicating menus to the client, establishing links between menus and other menus, and notifying clients of changes". Note that "To do so, it employs a number of D-Bus interfaces. These interfaces are currently considered private implementation details of GApplication and subject to change - therefore they are not documented in the GIO documentation." ([Source](https://wiki.gnome.org/Projects/GLib/GApplication/DBusAPI#org.gtk.Menus)). __How does it relate to the DBusMenu protocol, does it have an overlapping scope or is it a complement?__ +* [__com.canonical.AppMenu.Registrar D-Bus Service__](): An interface to register a menu from an application's window to be displayed in another window. This manages that association between XWindow Window IDs and the dbus address and object that provides the menu using the dbusmenu dbus interface. ([Source](https://github.com/KDE/plasma-workspace/blob/master/appmenu/com.canonical.AppMenu.Registrar.xml)) __How does it relate to the DBusMenu protocol, does it have an overlapping scope or is it a complement?__ ### Implementations From b8f9cdd336e119fcd00856ef8a2beb71c27e32d6 Mon Sep 17 00:00:00 2001 From: probonopd Date: Thu, 31 Dec 2020 12:57:39 +0100 Subject: [PATCH 165/592] Update menu.md --- developer/menu.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/developer/menu.md b/developer/menu.md index 3312c164..7fee8c48 100644 --- a/developer/menu.md +++ b/developer/menu.md @@ -26,7 +26,8 @@ APIs can be described in specifications, protocols, and interfaces. * [__DBusMenu protocol__](): Protocol for which implementations exist for Glib, Gtk, Qt (starting with Qt 2). Applications can export and import their menus (question: only indicators or all menus?) using this protocol. The specification used to be at https://people.canonical.com/~agateau/dbusmenu/spec/index.html but the link is dead as of 2020. On https://agateau.com/2009/statusnotifieritem-and-dbusmenu/ it is described as: "The goal of DBusMenu is to make it possible for applications using the StatusNotifierItem spec to send their menus over DBus, so that the workspace can display them in a consistent way, regardless of whether the application is written using Qt, GTK or another toolkit." Possibly it has significantly evolved since then? * [__org.gtk.Menus interface__](https://wiki.gnome.org/Projects/GLib/GApplication/DBusAPI#org.gtk.Menus): An interface defined by Gnome that "is primarily concerned with three things: communicating menus to the client, establishing links between menus and other menus, and notifying clients of changes". Note that "To do so, it employs a number of D-Bus interfaces. These interfaces are currently considered private implementation details of GApplication and subject to change - therefore they are not documented in the GIO documentation." ([Source](https://wiki.gnome.org/Projects/GLib/GApplication/DBusAPI#org.gtk.Menus)). __How does it relate to the DBusMenu protocol, does it have an overlapping scope or is it a complement?__ -* [__com.canonical.AppMenu.Registrar D-Bus Service__](): An interface to register a menu from an application's window to be displayed in another window. This manages that association between XWindow Window IDs and the dbus address and object that provides the menu using the dbusmenu dbus interface. ([Source](https://github.com/KDE/plasma-workspace/blob/master/appmenu/com.canonical.AppMenu.Registrar.xml)) __How does it relate to the DBusMenu protocol, does it have an overlapping scope or is it a complement?__ +* [__com.canonical.AppMenu.Registrar D-Bus Service__](): An interface to register a menu from an application's window to be displayed in another window. This manages that association between XWindow Window IDs and the dbus address and object that provides the menu using the dbusmenu dbus interface. ([Source](https://github.com/KDE/plasma-workspace/blob/master/appmenu/com.canonical.AppMenu.Registrar.xml)). "Appmenu registrar allows other applications to access any active window's application menu tree. Such a registrar is extremely useful for, e.g. implementing global menus (application menus appear in the top panel bar of the desktop environment, and for adding an application menu browser or search engine to HUDs" ([Source](https://packages.debian.org/buster/appmenu-registrar)). __How does it relate to the DBusMenu protocol, does it have an overlapping scope or is it a complement?__ +* [__org/appmenu D-Bus Methods__](): ### Implementations From 596648d654cd56eb6300ecf899ce1e3cc5e75279 Mon Sep 17 00:00:00 2001 From: probonopd Date: Thu, 31 Dec 2020 12:59:50 +0100 Subject: [PATCH 166/592] Update menu.md --- developer/menu.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/developer/menu.md b/developer/menu.md index 7fee8c48..c386b3d4 100644 --- a/developer/menu.md +++ b/developer/menu.md @@ -83,7 +83,7 @@ tbd * Bugtracker: * Purpose: * Theory of operation: -* Status: +* Status: . "Unity" = Deprecated? * Issues: Not in ports? Is this an issue, preventing us from some applications to work properly? * Installed by package: Not in ports? (In Ubuntu, `sudo apt-get install unity-gtk-module-common unity-gtk2-module unity-gtk3-module`) @@ -134,7 +134,7 @@ tbd * Description: Gtk implementation of the DBusMenu protocol * Bugtracker: * Purpose: -* Theory of operation: +* Theory of operation: . Why does Gtk need an extra implementation when it is already implemented in GLib (via `libdbusmenu-glib.so`) with Gtk uses? * Status: * Issues: * Installed by package: `libdbusmenu` @@ -213,7 +213,7 @@ tbd * Description: * Bugtracker: https://phabricator.kde.org/D10461 * Purpose: . Translate between the org.gtk.Menus interface used by Gtk applications and what is needed to satisfy the KDE global menu bar (and helloSystem Menu which is derived from it)? (Why does KDE need something special?) -* Theory of operation: This application finds windows using GTK GMenu DBus interfaces and forwards them through DBusMenu. (...) LibreOffice with appmenu-gtk-module (...) Works with Gimp or Inkscape if you have appmenu-gtk-module (there's GTK2 and GTK3 variants) installed and GTK_MODULES=appmenu-gtk-module environment variable set. ([Source](https://phabricator.kde.org/transactions/detail/PHID-XACT-DREV-jz6tqizldlvwmv6/), [more information](https://blog.broulik.de/2018/03/gtk-global-menu/)) +* Theory of operation: "This application finds windows using GTK GMenu DBus interfaces and forwards them through DBusMenu. (...) LibreOffice with appmenu-gtk-module (...) Works with Gimp or Inkscape if you have appmenu-gtk-module (there's GTK2 and GTK3 variants) installed and GTK_MODULES=appmenu-gtk-module environment variable set." ([Source](https://phabricator.kde.org/transactions/detail/PHID-XACT-DREV-jz6tqizldlvwmv6/), [more information](https://blog.broulik.de/2018/03/gtk-global-menu/)) * Status: * Issues: Can we get it "standalone", without KDE Plasma? * Installed by package: `plasma5-plasma-workspace` From 81eb04b6c53b885df6d3a8670ea0d3289db8df6f Mon Sep 17 00:00:00 2001 From: probonopd Date: Thu, 31 Dec 2020 13:59:12 +0100 Subject: [PATCH 167/592] Update menu.md --- developer/menu.md | 31 +++++++++++++++++++++++++++++++ 1 file changed, 31 insertions(+) diff --git a/developer/menu.md b/developer/menu.md index c386b3d4..5fc9a1e4 100644 --- a/developer/menu.md +++ b/developer/menu.md @@ -217,3 +217,34 @@ tbd * Status: * Issues: Can we get it "standalone", without KDE Plasma? * Installed by package: `plasma5-plasma-workspace` + +## Debugging with Qt 5 D-Bus Viewer + +The __Qt 5 D-Bus Viewer__ utility may be useful in debugging global menus. + + +``` .. note:: + Please consider submitting issues and pull requests if you can contribute to this subject. +``` + +### Getting the menus for a Qt application knowing the Xorg window ID + +* Open Terminal +* Enter `xprop` +* Click on the Terminal window +* We see `_KDE_NET_WM_APPMENU_OBJECT_PATH(STRING) = "/MenuBar/1"` and `_KDE_NET_WM_APPMENU_SERVICE_NAME(STRING) = ":1.59"` (actual numbers might be different from this example) +* Open Qt 5 D-Bus Viewer +* Under "Services", click on ":1:59", under "Methods", click on "MenuBar/", "1/" +* __Then what? How can one get the actual menus?__ +* Which standards/specifications is this following? Is this documented somewhere? + +### Getting the menus for a Gtk application + +* Open GIMP +* Open Qt 5 D-Bus Viewer +* Under "Services", click on "org.gimp.GIMP.UI", under "Methods", click on "org/", "appmenu/", "gtk/", "window/", "0/", "org.gtk.Actions/", "Method: List" +* The names of the actions in the GIMP menus appear at the bottom of the window +* Under "Services", click on "org.gimp.GIMP.UI", under "Methods", click on "org/", "appmenu/", "gtk/", "window/", "0/", "org.gtk.Actions/", "Method: DescribeAll" +* __Qt 5 D-Bus Viewer crashes__ +* __Then what? How can one get the actual menus?__ +* Which standards/specifications is this following? Is this documented somewhere? From b85b36f5b2634e4b921d852d4b04e082bcf33eaa Mon Sep 17 00:00:00 2001 From: probonopd Date: Thu, 31 Dec 2020 14:39:16 +0100 Subject: [PATCH 168/592] Clarifications by @ximion --- developer/menu.md | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/developer/menu.md b/developer/menu.md index 5fc9a1e4..3f471d3e 100644 --- a/developer/menu.md +++ b/developer/menu.md @@ -19,15 +19,16 @@ To provide this unified user experience, it is crucial that all applications can * [__Status Menu__](https://wiki.ubuntu.com/CustomStatusMenuDesignGuidelines): The term used by Canonical to describe the icons in the upper-right corner of the screen that are usually used for long-running background processes * [__System Tray__ = __Notification Area__](https://en.wikipedia.org/wiki/Notification_area): The term that describes the icons on the bottom-right corner of the screen on Windows * [__Application (Panel) Indicators__](https://wiki.ubuntu.com/DesktopExperienceTeam/ApplicationIndicators): Another term used by Canonical to describe __Status Menus__? +* [__Status Notifiers__](): ### APIs APIs can be described in specifications, protocols, and interfaces. -* [__DBusMenu protocol__](): Protocol for which implementations exist for Glib, Gtk, Qt (starting with Qt 2). Applications can export and import their menus (question: only indicators or all menus?) using this protocol. The specification used to be at https://people.canonical.com/~agateau/dbusmenu/spec/index.html but the link is dead as of 2020. On https://agateau.com/2009/statusnotifieritem-and-dbusmenu/ it is described as: "The goal of DBusMenu is to make it possible for applications using the StatusNotifierItem spec to send their menus over DBus, so that the workspace can display them in a consistent way, regardless of whether the application is written using Qt, GTK or another toolkit." Possibly it has significantly evolved since then? -* [__org.gtk.Menus interface__](https://wiki.gnome.org/Projects/GLib/GApplication/DBusAPI#org.gtk.Menus): An interface defined by Gnome that "is primarily concerned with three things: communicating menus to the client, establishing links between menus and other menus, and notifying clients of changes". Note that "To do so, it employs a number of D-Bus interfaces. These interfaces are currently considered private implementation details of GApplication and subject to change - therefore they are not documented in the GIO documentation." ([Source](https://wiki.gnome.org/Projects/GLib/GApplication/DBusAPI#org.gtk.Menus)). __How does it relate to the DBusMenu protocol, does it have an overlapping scope or is it a complement?__ -* [__com.canonical.AppMenu.Registrar D-Bus Service__](): An interface to register a menu from an application's window to be displayed in another window. This manages that association between XWindow Window IDs and the dbus address and object that provides the menu using the dbusmenu dbus interface. ([Source](https://github.com/KDE/plasma-workspace/blob/master/appmenu/com.canonical.AppMenu.Registrar.xml)). "Appmenu registrar allows other applications to access any active window's application menu tree. Such a registrar is extremely useful for, e.g. implementing global menus (application menus appear in the top panel bar of the desktop environment, and for adding an application menu browser or search engine to HUDs" ([Source](https://packages.debian.org/buster/appmenu-registrar)). __How does it relate to the DBusMenu protocol, does it have an overlapping scope or is it a complement?__ -* [__org/appmenu D-Bus Methods__](): +* [__DBusMenu protocol__](): Protocol for which implementations exist for Glib, Gtk, Qt (starting with Qt 2). Applications can export and import their menus (question: only indicators or all menus?) using this protocol. The specification used to be at https://people.canonical.com/~agateau/dbusmenu/spec/index.html but the link is dead as of 2020. On https://agateau.com/2009/statusnotifieritem-and-dbusmenu/ it is described as: "The goal of DBusMenu is to make it possible for applications using the StatusNotifierItem spec to send their menus over DBus, so that the workspace can display them in a consistent way, regardless of whether the application is written using Qt, GTK or another toolkit." Possibly it has significantly evolved since then? According to [__@ximion__](https://github.com/ximion), DBusMenu is a spec that transfers menus to status notifiers, and in combination with `com.canonical.AppMenu.Registrar` can be used for global menus. +* [__org.gtk.Menus interface__](https://wiki.gnome.org/Projects/GLib/GApplication/DBusAPI#org.gtk.Menus): An interface defined by Gnome that "is primarily concerned with three things: communicating menus to the client, establishing links between menus and other menus, and notifying clients of changes". Note that "To do so, it employs a number of D-Bus interfaces. These interfaces are currently considered private implementation details of GApplication and subject to change - therefore they are not documented in the GIO documentation." ([Source](https://wiki.gnome.org/Projects/GLib/GApplication/DBusAPI#org.gtk.Menus)). __How does it relate to the DBusMenu protocol, does it have an overlapping scope or is it a complement?__ According to [__@ximion__](https://github.com/ximion), the `org.gtk.Menus` interface has nothing to do with DBusMenu and was only for the Gnome Shell global menu (deprecated in Gnome). __Why was it deprecated in Gnome Shell and what is the replacement?__ +* [__com.canonical.AppMenu.Registrar D-Bus Service__](): `com.canonical.AppMenu.Registrar`, an interface to register a menu from an application's window to be displayed in another window. This manages that association between XWindow Window IDs and the dbus address and object that provides the menu using the dbusmenu dbus interface. ([Source](https://github.com/KDE/plasma-workspace/blob/master/appmenu/com.canonical.AppMenu.Registrar.xml)). "Appmenu registrar allows other applications to access any active window's application menu tree. Such a registrar is extremely useful for, e.g. implementing global menus (application menus appear in the top panel bar of the desktop environment, and for adding an application menu browser or search engine to HUDs" ([Source](https://packages.debian.org/buster/appmenu-registrar)). __How does it relate to the DBusMenu protocol, does it have an overlapping scope or is it a complement?__ +* [__org/appmenu D-Bus Methods__](): ### Implementations @@ -35,6 +36,7 @@ Those may or may not be used in helloSystem, they are mentioned here to give an * __Panel__: Ubuntu calls the widget at the top of the screen the "panel". In helloSystem, the rough equivalent is __Menu__. * [__Aytana__](https://wiki.ubuntu.com/Ayatana): The Buddhist term for a "sense base" or "sense sphere". A project by Canonical to improve user experience in Ubuntu. Abandoned? +* [__AyatanaIndicators__](https://github.com/AyatanaIndicators): . A project that as of 2020 seems to be still pretty active on https://github.com/AyatanaIndicators. __With Ubuntu now using Gnome rather than Unity, what is this AytanaIndicators project doing?__ * [__Application Menu or appmenu__](https://wiki.ubuntu.com/DesktopExperienceTeam/ApplicationMenu): As part of Aytana, Canonical has produced an implementation called `indicator-appmenu` which re-routes Gtk and Qt menus over `dbusmenu` so that they appear in the panel * [__dbusmenu__](https://wiki.ubuntu.com/DesktopExperienceTeam/ApplicationIndicators#Software_Architecture): Library by Canonical implementing the transport protocol between the applications and the panel * [__libappindicator__](https://wiki.ubuntu.com/DesktopExperienceTeam/ApplicationIndicators#Software_Architecture): Library by Canonical to register icons and menus and internally uses dbusmenu to publish context menus over dbus. The same as [`indicator-application`](https://launchpad.net/indicator-application)? From fdf9c61e832e565fd5cbc3ea857bd8939521090d Mon Sep 17 00:00:00 2001 From: probonopd Date: Thu, 31 Dec 2020 14:43:39 +0100 Subject: [PATCH 169/592] AyatanaIndicators/libdbusmenu --- developer/menu.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/developer/menu.md b/developer/menu.md index 3f471d3e..5d395af6 100644 --- a/developer/menu.md +++ b/developer/menu.md @@ -116,9 +116,10 @@ tbd ``` * Author: -* Description: GLib implementation of the DBusMenu protocol -* Bugtracker: -* Purpose: +* Description: GLib implementation of the DBusMenu protocol. +* Bugtracker: https://github.com/AyatanaIndicators/libdbusmenu/ +* Purpose: "A library to allow applications to provide simple indications of +information to be displayed to users of the application through the interface shell" ([Source](https://github.com/AyatanaIndicators/libdbusmenu/blob/master/libdbusmenu-glib/dbus-menu.xml)) * Theory of operation: * Status: * Issues: From d3244292e202cfa61bd287aa86736502a7c9f676 Mon Sep 17 00:00:00 2001 From: probonopd Date: Fri, 1 Jan 2021 02:55:28 +0100 Subject: [PATCH 170/592] filesystems.md [ci skip] --- user/components/filesystems.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) create mode 100644 user/components/filesystems.md diff --git a/user/components/filesystems.md b/user/components/filesystems.md new file mode 100644 index 00000000..bad8d2fd --- /dev/null +++ b/user/components/filesystems.md @@ -0,0 +1,16 @@ +# Filesystems + +helloSystem uses the OpenZFS for the boot disk. + +Additionally, the following filesystems are supported in helloSystem, but it cannot be started from those: + +* exFAT (Windows) +* NTFS (Windows; read-write support) +* EXT4 (Linux) +* HFS+ (Macintosh) +* XFS (SGI) +* MTP (Android) + +Supported filesystems are automatically mounted by [automount](https://github.com/vermaden/automount). + +To see how they are mounted, open the Logs utility and attach a disk. From b023965482e1f528e1cc2bf1503a41614af53ade Mon Sep 17 00:00:00 2001 From: probonopd Date: Fri, 1 Jan 2021 13:59:50 +0100 Subject: [PATCH 171/592] Update menu.md --- developer/menu.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/developer/menu.md b/developer/menu.md index 5d395af6..50a15484 100644 --- a/developer/menu.md +++ b/developer/menu.md @@ -251,3 +251,13 @@ The __Qt 5 D-Bus Viewer__ utility may be useful in debugging global menus. * __Qt 5 D-Bus Viewer crashes__ * __Then what? How can one get the actual menus?__ * Which standards/specifications is this following? Is this documented somewhere? + +## Limitations + +Applications running as root currently cannot show global menus due to the D-Bus architecture. + +``` .. note:: + Possibly some sort of proxy would be needed to allow applications that were invoked via `sudo -E` to display their menus in the global menu of the user running the desktop session. + + Please consider contributing ideas and code if you are interested in this topic. +``` From 54147195c7c96095fc2e3a656be3acfbd829d147 Mon Sep 17 00:00:00 2001 From: probonopd Date: Fri, 1 Jan 2021 15:50:41 +0100 Subject: [PATCH 172/592] "once available in quarterly packages" --- user/components/filesystems.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/user/components/filesystems.md b/user/components/filesystems.md index bad8d2fd..8fbbe018 100644 --- a/user/components/filesystems.md +++ b/user/components/filesystems.md @@ -4,9 +4,9 @@ helloSystem uses the OpenZFS for the boot disk. Additionally, the following filesystems are supported in helloSystem, but it cannot be started from those: -* exFAT (Windows) +* exFAT (Windows) _once available in quarterly packages_ * NTFS (Windows; read-write support) -* EXT4 (Linux) +* EXT4 (Linux) _once available in quarterly packages_ * HFS+ (Macintosh) * XFS (SGI) * MTP (Android) From e0a4485ceeaf1e3a8e163cb2f52daaff75ccb195 Mon Sep 17 00:00:00 2001 From: probonopd Date: Fri, 1 Jan 2021 18:17:16 +0100 Subject: [PATCH 173/592] Update applications.md --- developer/applications.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/developer/applications.md b/developer/applications.md index ad3ccff8..fc0fe201 100644 --- a/developer/applications.md +++ b/developer/applications.md @@ -7,4 +7,6 @@ Applications specifically written for helloSystem, especially Preferences and Ut * Ideally written in PyQt * Come as simplified `.app` bundles with no external dependencies apart from what comes with helloSystem by default on the Live ISO +Some of the example applications and utilities are written in Python with PyQt. This is designed to invite (power) users to have a look at the code, start to experiment, and possibly eventually contribute. Especially when used in conjunction with the simplified `.app` bundle format and with an IDE with autocompletion, this makes for a _very_ accessible development environment with _very_ low barriers to entry. No source code to search and download, no compilers, just open the `.app` bundle and start hacking away. Tiny example applications like `Log.app` and `Calendar.app` are included that anyone should be able to understand in no time. + Please see [https://github.com/learnpyqt/15-minute-apps](https://github.com/learnpyqt/15-minute-apps) for what we mean by "Simple to use" and "Easy to hack on". From 54da5641168a2ece81dc67a21932d80c759668af Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 2 Jan 2021 06:23:01 +0100 Subject: [PATCH 174/592] org.kde.plasma.gmenu_dbusmenu_proxy D-Bus service --- developer/menu.md | 101 +++++++++++++++++++++++----------------------- 1 file changed, 51 insertions(+), 50 deletions(-) diff --git a/developer/menu.md b/developer/menu.md index 50a15484..f198d374 100644 --- a/developer/menu.md +++ b/developer/menu.md @@ -19,7 +19,7 @@ To provide this unified user experience, it is crucial that all applications can * [__Status Menu__](https://wiki.ubuntu.com/CustomStatusMenuDesignGuidelines): The term used by Canonical to describe the icons in the upper-right corner of the screen that are usually used for long-running background processes * [__System Tray__ = __Notification Area__](https://en.wikipedia.org/wiki/Notification_area): The term that describes the icons on the bottom-right corner of the screen on Windows * [__Application (Panel) Indicators__](https://wiki.ubuntu.com/DesktopExperienceTeam/ApplicationIndicators): Another term used by Canonical to describe __Status Menus__? -* [__Status Notifiers__](): +* [__Status Notifiers__](): tbd ### APIs @@ -28,7 +28,8 @@ APIs can be described in specifications, protocols, and interfaces. * [__DBusMenu protocol__](): Protocol for which implementations exist for Glib, Gtk, Qt (starting with Qt 2). Applications can export and import their menus (question: only indicators or all menus?) using this protocol. The specification used to be at https://people.canonical.com/~agateau/dbusmenu/spec/index.html but the link is dead as of 2020. On https://agateau.com/2009/statusnotifieritem-and-dbusmenu/ it is described as: "The goal of DBusMenu is to make it possible for applications using the StatusNotifierItem spec to send their menus over DBus, so that the workspace can display them in a consistent way, regardless of whether the application is written using Qt, GTK or another toolkit." Possibly it has significantly evolved since then? According to [__@ximion__](https://github.com/ximion), DBusMenu is a spec that transfers menus to status notifiers, and in combination with `com.canonical.AppMenu.Registrar` can be used for global menus. * [__org.gtk.Menus interface__](https://wiki.gnome.org/Projects/GLib/GApplication/DBusAPI#org.gtk.Menus): An interface defined by Gnome that "is primarily concerned with three things: communicating menus to the client, establishing links between menus and other menus, and notifying clients of changes". Note that "To do so, it employs a number of D-Bus interfaces. These interfaces are currently considered private implementation details of GApplication and subject to change - therefore they are not documented in the GIO documentation." ([Source](https://wiki.gnome.org/Projects/GLib/GApplication/DBusAPI#org.gtk.Menus)). __How does it relate to the DBusMenu protocol, does it have an overlapping scope or is it a complement?__ According to [__@ximion__](https://github.com/ximion), the `org.gtk.Menus` interface has nothing to do with DBusMenu and was only for the Gnome Shell global menu (deprecated in Gnome). __Why was it deprecated in Gnome Shell and what is the replacement?__ * [__com.canonical.AppMenu.Registrar D-Bus Service__](): `com.canonical.AppMenu.Registrar`, an interface to register a menu from an application's window to be displayed in another window. This manages that association between XWindow Window IDs and the dbus address and object that provides the menu using the dbusmenu dbus interface. ([Source](https://github.com/KDE/plasma-workspace/blob/master/appmenu/com.canonical.AppMenu.Registrar.xml)). "Appmenu registrar allows other applications to access any active window's application menu tree. Such a registrar is extremely useful for, e.g. implementing global menus (application menus appear in the top panel bar of the desktop environment, and for adding an application menu browser or search engine to HUDs" ([Source](https://packages.debian.org/buster/appmenu-registrar)). __How does it relate to the DBusMenu protocol, does it have an overlapping scope or is it a complement?__ -* [__org/appmenu D-Bus Methods__](): +* [__org/appmenu D-Bus Methods__](): tbd +* [__org.kde.plasma.gmenu_dbusmenu_proxy D-Bus service__](): tbd. Translates Gtk menus to KDE-style menus? ### Implementations @@ -36,7 +37,7 @@ Those may or may not be used in helloSystem, they are mentioned here to give an * __Panel__: Ubuntu calls the widget at the top of the screen the "panel". In helloSystem, the rough equivalent is __Menu__. * [__Aytana__](https://wiki.ubuntu.com/Ayatana): The Buddhist term for a "sense base" or "sense sphere". A project by Canonical to improve user experience in Ubuntu. Abandoned? -* [__AyatanaIndicators__](https://github.com/AyatanaIndicators): . A project that as of 2020 seems to be still pretty active on https://github.com/AyatanaIndicators. __With Ubuntu now using Gnome rather than Unity, what is this AytanaIndicators project doing?__ +* [__AyatanaIndicators__](https://github.com/AyatanaIndicators): tbd. A project that as of 2020 seems to be still pretty active on https://github.com/AyatanaIndicators. __With Ubuntu now using Gnome rather than Unity, what is this AytanaIndicators project doing?__ * [__Application Menu or appmenu__](https://wiki.ubuntu.com/DesktopExperienceTeam/ApplicationMenu): As part of Aytana, Canonical has produced an implementation called `indicator-appmenu` which re-routes Gtk and Qt menus over `dbusmenu` so that they appear in the panel * [__dbusmenu__](https://wiki.ubuntu.com/DesktopExperienceTeam/ApplicationIndicators#Software_Architecture): Library by Canonical implementing the transport protocol between the applications and the panel * [__libappindicator__](https://wiki.ubuntu.com/DesktopExperienceTeam/ApplicationIndicators#Software_Architecture): Library by Canonical to register icons and menus and internally uses dbusmenu to publish context menus over dbus. The same as [`indicator-application`](https://launchpad.net/indicator-application)? @@ -80,11 +81,11 @@ Currently __not__ used in helloSystem. Do we need it? tbd ``` -* Author: -* Description: -* Bugtracker: -* Purpose: -* Theory of operation: +* Author: tbd +* Description: tbd +* Bugtracker: tbd +* Purpose: tbd +* Theory of operation: tbd * Status: . "Unity" = Deprecated? * Issues: Not in ports? Is this an issue, preventing us from some applications to work properly? * Installed by package: Not in ports? (In Ubuntu, `sudo apt-get install unity-gtk-module-common unity-gtk2-module unity-gtk3-module`) @@ -98,14 +99,14 @@ tbd /usr/local/lib/libappmenu-gtk3-parser.so.0 ``` -* Author: -* Description: -* Bugtracker: -* Purpose: -* Theory of operation: +* Author: tbd +* Description: tbd +* Bugtracker: tbd +* Purpose: tbd +* Theory of operation: tbd * Status: -* Issues: -* Installed by package: `` +* Issues: tbd +* Installed by package: `tbd` ### libdbusmenu-glib @@ -115,14 +116,14 @@ tbd /usr/local/lib/libdbusmenu-glib.so.4.0.12 ``` -* Author: +* Author: tbd * Description: GLib implementation of the DBusMenu protocol. * Bugtracker: https://github.com/AyatanaIndicators/libdbusmenu/ * Purpose: "A library to allow applications to provide simple indications of information to be displayed to users of the application through the interface shell" ([Source](https://github.com/AyatanaIndicators/libdbusmenu/blob/master/libdbusmenu-glib/dbus-menu.xml)) -* Theory of operation: +* Theory of operation: tbd * Status: -* Issues: +* Issues: tbd * Installed by package: `libdbusmenu` ### libdbusmenu-gtk3 @@ -133,13 +134,13 @@ information to be displayed to users of the application through the interface sh /usr/local/lib/libdbusmenu-gtk3.so.4.0.12 ``` -* Author: +* Author: tbd * Description: Gtk implementation of the DBusMenu protocol -* Bugtracker: -* Purpose: -* Theory of operation: . Why does Gtk need an extra implementation when it is already implemented in GLib (via `libdbusmenu-glib.so`) with Gtk uses? +* Bugtracker: tbd +* Purpose: tbd +* Theory of operation: tbd. Why does Gtk need an extra implementation when it is already implemented in GLib (via `libdbusmenu-glib.so`) with Gtk uses? * Status: -* Issues: +* Issues: tbd * Installed by package: `libdbusmenu` ### libdbusmenu-qt5 @@ -150,13 +151,13 @@ information to be displayed to users of the application through the interface sh /usr/local/lib/libdbusmenu-qt5.so.2.6.0 ``` -* Author: +* Author: tbd * Description: Qt5 implementation of the DBusMenu protocol * Bugtracker: https://launchpad.net/libdbusmenu-qt -* Purpose: -* Theory of operation: +* Purpose: tbd +* Theory of operation: tbd * Status: active -* Issues: +* Issues: tbd * Installed by package: `libdbusmenu-qt` ### Kf5 Appmenu Plugin @@ -165,14 +166,14 @@ information to be displayed to users of the application through the interface sh /usr/local/lib/qt5/plugins/kf5/kded/appmenu.so ``` -* Author: -* Description: -* Bugtracker: -* Purpose: -* Theory of operation: +* Author: tbd +* Description: tbd +* Bugtracker: tbd +* Purpose: tbd +* Theory of operation: tbd * Status: -* Issues: -* Installed by package: `` +* Issues: tbd +* Installed by package: `tbd` ### Kf5 Plasma Applet Appmenu Plugin @@ -180,14 +181,14 @@ information to be displayed to users of the application through the interface sh /usr/local/lib/qt5/plugins/plasma/applets/plasma_applet_appmenu.so ``` -* Author: -* Description: -* Bugtracker: -* Purpose: -* Theory of operation: +* Author: tbd +* Description: tbd +* Bugtracker: tbd +* Purpose: tbd +* Theory of operation: tbd * Status: -* Issues: -* Installed by package: `` +* Issues: tbd +* Installed by package: `tbd` ### Kf5 Plasma Private libappmenuplugin @@ -195,14 +196,14 @@ information to be displayed to users of the application through the interface sh /usr/local/lib/qt5/qml/org/kde/plasma/private/appmenu/libappmenuplugin.so ``` -* Author: -* Description: -* Bugtracker: -* Purpose: -* Theory of operation: +* Author: tbd +* Description: tbd +* Bugtracker: tbd +* Purpose: tbd +* Theory of operation: tbd * Status: -* Issues: -* Installed by package: `` +* Issues: tbd +* Installed by package: `tbd` ## Executables involved @@ -213,9 +214,9 @@ information to be displayed to users of the application through the interface sh ``` * Author: Kai Uwe Broulik (KDE) -* Description: +* Description: tbd * Bugtracker: https://phabricator.kde.org/D10461 -* Purpose: . Translate between the org.gtk.Menus interface used by Gtk applications and what is needed to satisfy the KDE global menu bar (and helloSystem Menu which is derived from it)? (Why does KDE need something special?) +* Purpose: tbd. Translate between the org.gtk.Menus interface used by Gtk applications and what is needed to satisfy the KDE global menu bar (and helloSystem Menu which is derived from it)? (Why does KDE need something special?) * Theory of operation: "This application finds windows using GTK GMenu DBus interfaces and forwards them through DBusMenu. (...) LibreOffice with appmenu-gtk-module (...) Works with Gimp or Inkscape if you have appmenu-gtk-module (there's GTK2 and GTK3 variants) installed and GTK_MODULES=appmenu-gtk-module environment variable set." ([Source](https://phabricator.kde.org/transactions/detail/PHID-XACT-DREV-jz6tqizldlvwmv6/), [more information](https://blog.broulik.de/2018/03/gtk-global-menu/)) * Status: * Issues: Can we get it "standalone", without KDE Plasma? From 47fce7bb199e576aa77dbf58f11781f630829c4e Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 2 Jan 2021 07:14:59 +0100 Subject: [PATCH 175/592] Create calendar.md --- user/components/utilities/calendar.md | 6 ++++++ 1 file changed, 6 insertions(+) create mode 100644 user/components/utilities/calendar.md diff --git a/user/components/utilities/calendar.md b/user/components/utilities/calendar.md new file mode 100644 index 00000000..49f1f950 --- /dev/null +++ b/user/components/utilities/calendar.md @@ -0,0 +1,6 @@ +# Calendar + +The __Calendar__ application is a simple calendar. + +This application serves as an example how easily Qt widgets can be used from Python. +Users are invited to look at and play with the source code. From 23a1d0483764016f161ce28755d7525c7ec6644e Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 2 Jan 2021 07:15:11 +0100 Subject: [PATCH 176/592] Update calendar.md --- user/components/utilities/calendar.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/user/components/utilities/calendar.md b/user/components/utilities/calendar.md index 49f1f950..ddd7ebe9 100644 --- a/user/components/utilities/calendar.md +++ b/user/components/utilities/calendar.md @@ -1,6 +1,6 @@ # Calendar -The __Calendar__ application is a simple calendar. +The __Calendar__ utility is a simple calendar. This application serves as an example how easily Qt widgets can be used from Python. Users are invited to look at and play with the source code. From 192bf7e0e5999194a80dfe729875dd2d9865fedf Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 2 Jan 2021 22:29:52 +0100 Subject: [PATCH 177/592] Fix typo --- developer/boot.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/developer/boot.md b/developer/boot.md index 16254f60..dbd548f2 100644 --- a/developer/boot.md +++ b/developer/boot.md @@ -16,7 +16,7 @@ This is a simplified description of the boot process. There may be additional as 1. The `/livecd` chroot is exited 1. `init.sh` from the ramdisk image exits 1. `etc/rc` from the ramdisk image gets executed as specified in `overlays/ramdisk/etc/rc` (by what?). It tells the kernel to "reroot" (not "chroot") into the live filesystem, `/livecd` using `reboot -r` -1 From here on, the boot process is the regular FreeBSD boot process +1. From here on, the boot process is the regular FreeBSD boot process ### Troubleshooting the Live system early boot process From c2e5139957eb98eb0ad7e4e363f7a6a9a1ae3031 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 3 Jan 2021 18:44:50 +0100 Subject: [PATCH 178/592] Increase maxdepth for User Guide --- index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.md b/index.md index e7fa4b0a..d443545e 100644 --- a/index.md +++ b/index.md @@ -14,7 +14,7 @@ __hello__ (also known as __helloSystem__) is a desktop system for creators with ```eval_rst .. toctree:: - :maxdepth: 2 + :maxdepth: 3 :caption: User Guide :hidden: :glob: From 713ee4fdbbeb79e2612bd4e0501dfdcdbedacf19 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 3 Jan 2021 19:56:35 +0100 Subject: [PATCH 179/592] Update keyboard.md --- user/components/preferences/keyboard.md | 20 +++++++++++++++++++- 1 file changed, 19 insertions(+), 1 deletion(-) diff --git a/user/components/preferences/keyboard.md b/user/components/preferences/keyboard.md index f873e107..f6e04547 100644 --- a/user/components/preferences/keyboard.md +++ b/user/components/preferences/keyboard.md @@ -1,7 +1,25 @@ # Keyboard -The __Keyboard__ preferences application lets you change the keyboard layout (language) of your attached keyboard. +The __Keyboard__ preferences application lets you change the keyboard layout (language) of your attached keyboard, and allows you to set which physical key should act as your ⌘ (command) key. it also lets you disable the Caps Lock key. ``` .. note:: The keyboard layout (language) gets set automatically during system startup if an official Raspberry Pi keyboard is attached or the system is running on Macintosh hardware, which has the prev-lang:kbd EFI key set. ``` + +## Setting the keyboard layout + +Simply click on a language (keyboard layout). The change is effective immediately. + +## Selecting a physical key to act as ⌘ (command) + +Swapping the keys will result in the key left from the spacebar to act as the ⌘ (command) key (like switchers from the Mac would expect) and therfore is the default. + +__If a PC keyboard is attached__, you can select the "Use the Alt key as ⌘" checkbox. This will swap the __Ctrl__ and __Alt__ keys. + +__If an Apple keyboard is attached__, you can select the "Use the ⌘ key for menu shortcuts" checkbox. This will swap the __alt ⌥__ and __cmd ⌘__ keys. + +If you prefer the keys not be swapped, simply uncheck the respective checkbox. The change is effective immediately. + +## Disabling the Caps Lock key + +You can select the "Disable the Caps Lock key" checkbox. This will disable the Caps Lock key. The change is effective immediately. From 38ab8affb3c4707bb7a2ba9e3f93ad83b67fdcfd Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 3 Jan 2021 22:51:37 +0100 Subject: [PATCH 180/592] Update hardware-probe.md --- user/components/utilities/hardware-probe.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/user/components/utilities/hardware-probe.md b/user/components/utilities/hardware-probe.md index 6f62d6d0..f0712a93 100644 --- a/user/components/utilities/hardware-probe.md +++ b/user/components/utilities/hardware-probe.md @@ -1,6 +1,6 @@ # Hardware Probe -The __Hardware Probe__ utility collects hardware details of your computer and can anonymously upload them to the public database at [http://bsd-hardware.info/](http://bsd-hardware.info/). +The __Hardware Probe__ utility collects hardware details of your computer and can anonymously upload them to the public database at [bsd-hardware.info](https://bsd-hardware.info/?d=helloSystem). This can help users and operating system developers to collaboratively debug hardware related issues, check for operating system compatibility and find drivers. @@ -24,4 +24,4 @@ to a publicly visible database. By uploading your hardware probe you confirm uploading of 32-byte prefix of salted SHA512 hash of MAC addresses and serial numbers to prevent duplication of computers in the database. -The web service and the database are operated by https://linux-hardware.org. The authors of the graphical Hardware Probe utility are not associated with the operator of the web service. Please contact https://linux-hardware.org/index.php?view=contacts in case of questions and in case you wish accidentally submitted probes to be removed from the database. +The web service and the database are operated by linux-hardware.org. The authors of the graphical Hardware Probe utility are not associated with the operator of the web service. Please contact https://linux-hardware.org/index.php?view=contacts in case of questions and in case you wish accidentally submitted probes to be removed from the database. From 951aa927f17aff44eaf9e7eb5d57016a984363ee Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 4 Jan 2021 06:29:07 +0100 Subject: [PATCH 181/592] Create wireless-networks.md --- user/components/preferences/wireless-networks.md | 9 +++++++++ 1 file changed, 9 insertions(+) create mode 100644 user/components/preferences/wireless-networks.md diff --git a/user/components/preferences/wireless-networks.md b/user/components/preferences/wireless-networks.md new file mode 100644 index 00000000..7cf4a7ea --- /dev/null +++ b/user/components/preferences/wireless-networks.md @@ -0,0 +1,9 @@ +# Wireless Networks + +The __Wireless Networks__ preferences application lets you connect to wireless local area networks (WLANs). + +It is possible to use more than one wireless network card. + +``` .. note:: + Please consider using the Hardware Probe utility in case your network card is not detected by the Wireless Networks preferences application. +``` From 4a46b1711e944fbe88d588be22c159894ce1ee74 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 4 Jan 2021 06:55:56 +0100 Subject: [PATCH 182/592] Create falkon.md --- user/components/applications/falkon.md | 26 ++++++++++++++++++++++++++ 1 file changed, 26 insertions(+) create mode 100644 user/components/applications/falkon.md diff --git a/user/components/applications/falkon.md b/user/components/applications/falkon.md new file mode 100644 index 00000000..65523063 --- /dev/null +++ b/user/components/applications/falkon.md @@ -0,0 +1,26 @@ +# Falkon + +__Falkon__ is the web browser that comes with helloSystem by default. + +## Search shortcuts + +The following search shortcuts have been predefined: + +### Search Engines + +* __`g`: Search Google.__ Example: `g Frankfurt` +* __`d`: Search DuckDuckGo.__ Example: `g München` +* __`sp`: Search StartPage.__ Example: `g Hamburg` + +### Encyclopedia + +* __`w`: Search Wikipedia.__ Example: `g Stuttgart` + +### Computer related + +* __`man`: Search FreeBSD Man Pages.__ Example: `man ls` +* __`bug`: Search FreeBSD Bugzilla.__ Example: `bug Falkon` +* __`gh`: Search GitHub.__ Example: `gh PyQt5` +* __`h`: Search helloSystem on GitHub.__ Example: `h keyboard` + +Of course you can customize these and add your own search shortcuts in Falkon. From 2661a09a6c2da9704bd8d560605d3ba5bb41f235 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 4 Jan 2021 06:56:28 +0100 Subject: [PATCH 183/592] Update chromium.md --- user/components/applications/chromium.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/user/components/applications/chromium.md b/user/components/applications/chromium.md index b80ec34b..cc54b61c 100644 --- a/user/components/applications/chromium.md +++ b/user/components/applications/chromium.md @@ -1,6 +1,6 @@ # Chromium -Chromium is the web browser that comes with helloSystem by default. +Chromium is an optional web browser that can be used on helloSystem. Upon first start of the Chromium browser, the following extensions are automatically installed from [https://chrome.google.com/webstore/](https://chrome.google.com/webstore/) to increase privacy and convenience: From 8155eef69614fe79352ff9465035b1559b6c66d2 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 4 Jan 2021 06:56:48 +0100 Subject: [PATCH 184/592] [ci skip] --- user/components/applications/chromium.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/user/components/applications/chromium.md b/user/components/applications/chromium.md index cc54b61c..f4f0e5f3 100644 --- a/user/components/applications/chromium.md +++ b/user/components/applications/chromium.md @@ -1,6 +1,6 @@ # Chromium -Chromium is an optional web browser that can be used on helloSystem. +__Chromium__ is an optional web browser that can be used on helloSystem. Upon first start of the Chromium browser, the following extensions are automatically installed from [https://chrome.google.com/webstore/](https://chrome.google.com/webstore/) to increase privacy and convenience: From 403b9d7677516cec8e75e55602e825fa258a6332 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 4 Jan 2021 06:59:41 +0100 Subject: [PATCH 185/592] Update falkon.md --- user/components/applications/falkon.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/user/components/applications/falkon.md b/user/components/applications/falkon.md index 65523063..910380ae 100644 --- a/user/components/applications/falkon.md +++ b/user/components/applications/falkon.md @@ -9,12 +9,12 @@ The following search shortcuts have been predefined: ### Search Engines * __`g`: Search Google.__ Example: `g Frankfurt` -* __`d`: Search DuckDuckGo.__ Example: `g München` -* __`sp`: Search StartPage.__ Example: `g Hamburg` +* __`d`: Search DuckDuckGo.__ Example: `d München` +* __`sp`: Search StartPage.__ Example: `sp Hamburg` ### Encyclopedia -* __`w`: Search Wikipedia.__ Example: `g Stuttgart` +* __`w`: Search Wikipedia.__ Example: `w Stuttgart` ### Computer related From 7e276192f69bf16a2796edf8d734a4509cddd7d2 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 4 Jan 2021 07:31:43 +0100 Subject: [PATCH 186/592] Update falkon.md --- user/components/applications/falkon.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/user/components/applications/falkon.md b/user/components/applications/falkon.md index 910380ae..70c8e89a 100644 --- a/user/components/applications/falkon.md +++ b/user/components/applications/falkon.md @@ -24,3 +24,8 @@ The following search shortcuts have been predefined: * __`h`: Search helloSystem on GitHub.__ Example: `h keyboard` Of course you can customize these and add your own search shortcuts in Falkon. + +## Automatic reloading of local pages + +Falkon automatically refreshes the page when a local HTML document is changed. +This makes it ideal for dynamically previewing locally edited HTML pages. From 77b9159959b5a31f6d471ab2208d5f334468d8c4 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 4 Jan 2021 07:41:48 +0100 Subject: [PATCH 187/592] Add cover file [ci skip] --- _static/epub-cover.html | 32 ++++++++++++++++++++++++++++++++ 1 file changed, 32 insertions(+) create mode 100644 _static/epub-cover.html diff --git a/_static/epub-cover.html b/_static/epub-cover.html new file mode 100644 index 00000000..eb85ff46 --- /dev/null +++ b/_static/epub-cover.html @@ -0,0 +1,32 @@ + + + + + +

+ helloSystem
+ Documentation +

+ + From ae67bcb8c57d6d0ed0f361f2ef59a38d402fc4f4 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 4 Jan 2021 07:53:52 +0100 Subject: [PATCH 188/592] Update conf.py --- conf.py | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/conf.py b/conf.py index 9212a08b..3dfc1d45 100644 --- a/conf.py +++ b/conf.py @@ -23,7 +23,7 @@ # -- Project information ----------------------------------------------------- project = 'helloSystem' -copyright = '2020, probono' +copyright = '2020-2021, probono' author = 'probono' # The full version, including alpha/beta/rc tags @@ -76,6 +76,12 @@ 'github_version': 'main/', } +html_show_copyright = False +html_show_sphinx = False +html_logo = "_static/hello_logo.png" + +epub_cover = ('_static/hello_logo.png', '_static/epub-cover.html') + # Add any paths that contain custom static files (such as style sheets) here, # relative to this directory. They are copied after the builtin static files, # so a file named "default.css" will overwrite the builtin "default.css". From e82f586409cacb6d0b1471a5255bc5194744c1e4 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 4 Jan 2021 07:54:22 +0100 Subject: [PATCH 189/592] Add files via upload --- _static/hello_logo.png | Bin 0 -> 2543 bytes 1 file changed, 0 insertions(+), 0 deletions(-) create mode 100644 _static/hello_logo.png diff --git a/_static/hello_logo.png b/_static/hello_logo.png new file mode 100644 index 0000000000000000000000000000000000000000..8922f99adb146a7f9c02311af87d001519a5d4ae GIT binary patch literal 2543 zcmV#B;rtJqCW2nQ28muj}P_@>f5{=f19iS*sR6v|S5m3M~&*OXV*AI7{ve@i< z-+SrfrS|TBLO5rywTFAoT4(Py?ER#SjEszojEszojEszo{}})s@>9sjI9f3RFc~-m z+yR7-z?e@4egrH6mIAi}J@VVkI2OWo8nBZRRstPcvG3!68-cmNUx4oe?Hj3c8L)+; zu>m+EztN1A6wq2=ffKT4fi|tw_XuEZLeLijCzYu)1lZ$v_X6A9{mVex{AM$nyM!7E zdjp3xkE>;kMd z0Xk$~-WkCDXle7iRvOP}*XMko*3s^Cv;nTXjZ^XiK+mYnv98`_`K@O(S12z5>L`x} zV0a zb&}?^!cb0;R4Bzhp286gnkAf7NKaU0F9*XLgx(7dmg)@%im${I`M{fagu9b^xcfQomcR&-W6v zZsw*1Sm4UXIR%-NsCS&Rujc2sn{AMmK&_;qcD>&I9c$${T~ZN;c`?BZgfs386&I%#mW|m|1ta`fluslH@W_D3Sq(FsTvMV;gZLHsL z_Q&k}YO|5v61cXIF-fz4ev)pMbb+J*ERl3u2w`P&mTjg0B#duKI@t_vB&|)*3qh}! z^pdsNPEs!`->k!4w*p-y4YKRE%!pS)iO!HTQBogC|C02Kq=g}bgIN?ZVu9%dylZRr zHNgGA!9;9iFEF8rZC(vL3j7`T6L52!69r5(hd_Po6adb3{r=vScL3hD^4H=-M&K$} z@AkyFYJuODi2Zq&@_H0|usy|12%lsUTM+gk+0Ft8475 zd$*%qTBe=uzNKK_@d27Lx3lN-Hv|1^0{iQ?r)5KNtT%EQ;>%u<=6pyD&pzs=+nxy<6|02fc`*d z;1j8=T-)GOD9E|4{07JW#@?Up0YCg?ulaD@-fMS;C(uKaqZAVU)huodVQ_0z@e8JS-w2r$5< z>A#b(ckXjSKdHj=7+)bjtqvGoEwYgfu@d^~uzOdM=Bd1El+?2`JKz?(-7jfO2w}Tp zIp19`bJqv#|KPleqb2pW>nC({9u+FNeG5-yVbk1b<7$v}QwX6xvK=Pc?OyX(mBVc3 zQ6r)~B+2BP_IEEzM6+-whF^)qvOG%|9$684< zT>q0p2tIGCouq4`8KNvg2o1n$yX_=tbqL`f)hHNwiB-Y~cU@_Nl;5`cMnoHD|L;pI zU#^i<*dvd6<&m_-mN7xng_3Ty>)n#>EhE77I-H_^f=bc$V#nYs2?gk^!+}FddbJ79 zWWQVbg)Ab~y~Nt?mN`Qz@OjVDAXi@NT(Yl4agN?@m*UQZ!QCejho}dxZDh>1MIN`K zHdHy@2~qoJHsP5(;M~-`vy@b?a`f|p)(G!(=W#kQ@=z69U!RW@8)>_}a{{btOj)xH^8XDV41BTzUyZXP zw(H0Q!2>EK6G~DyXPE!O*6#--jrNAK6UOc;B?}h#rKES8Fzya2xoc&8PYNMyOz@p2 zDNYahbR%u|(Ba*P%R>lzvw~FT>=7h=+-?t=hpCc+6f?jM^CT76V@9cq>aTa zifySqEAVy&*1PnMI8by!SfVJHXe0FGrrV{lGa{Lb8IK?Sx`V6Zoe_ z!MPPC@C{KG@7^frcPQGu*8sedIyJ?19o8jm6Q4q#s&@|Xh6_42*eq~%;-j!Qq0Bh@ z1rzt^VK&ahEQ(`RS0gUnud5O^Lx&6GD|MNLxuiRq1HYTbpuNf&Im%$&#*A z$?dyB(jO!}9YR Date: Mon, 4 Jan 2021 08:05:42 +0100 Subject: [PATCH 190/592] Update epub-cover.html --- _static/epub-cover.html | 36 ++++++++++++++++++++++++------------ 1 file changed, 24 insertions(+), 12 deletions(-) diff --git a/_static/epub-cover.html b/_static/epub-cover.html index eb85ff46..0662e9ab 100644 --- a/_static/epub-cover.html +++ b/_static/epub-cover.html @@ -1,7 +1,7 @@ - - +{%- extends "layout.html" %} +{%- block header %} - - -

- helloSystem
- Documentation -

- - +{% endblock %} +{%- block rootrellink %}{% endblock %} +{%- block relbaritems %}{% endblock %} +{%- block sidebarlogo %}{% endblock %} +{%- block linktags %}{% endblock %} +{%- block relbar1 %}{% endblock %} +{%- block sidebar1 %}{% endblock %} +{%- block sidebar2 %}{% endblock %} +{%- block footer %}{% endblock %} + +{% block content %} +
+ Cover image +

{{ title }}

+

Documentation

+
+{% endblock %} From af038b1871d032fab350c68718fcef2adf0adca0 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 4 Jan 2021 08:09:37 +0100 Subject: [PATCH 191/592] Rename _static/epub-cover.html to _templates/epub-cover.html --- {_static => _templates}/epub-cover.html | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename {_static => _templates}/epub-cover.html (100%) diff --git a/_static/epub-cover.html b/_templates/epub-cover.html similarity index 100% rename from _static/epub-cover.html rename to _templates/epub-cover.html From a418f9b7195e7956e696a9be2219bd8f434fd686 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 4 Jan 2021 08:10:08 +0100 Subject: [PATCH 192/592] Update conf.py --- conf.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/conf.py b/conf.py index 3dfc1d45..6071267c 100644 --- a/conf.py +++ b/conf.py @@ -80,7 +80,7 @@ html_show_sphinx = False html_logo = "_static/hello_logo.png" -epub_cover = ('_static/hello_logo.png', '_static/epub-cover.html') +epub_cover = ('_static/hello_logo.png', 'epub-cover.html') # Add any paths that contain custom static files (such as style sheets) here, # relative to this directory. They are copied after the builtin static files, From a15bab19c9fa9cc4f2c9472c0bd88eade9ab6f3c Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 4 Jan 2021 22:21:42 +0100 Subject: [PATCH 193/592] Create developer-tools.md --- developer/developer-tools.md | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) create mode 100644 developer/developer-tools.md diff --git a/developer/developer-tools.md b/developer/developer-tools.md new file mode 100644 index 00000000..08983e25 --- /dev/null +++ b/developer/developer-tools.md @@ -0,0 +1,19 @@ +# Developer Tools + +The __Developer__ folder in the __Applications__ folder contains useful development tools for use with helloSystem. + +* __PyCharm CE__: A powerful integrated development environment (IDE) for the Python languge which is used for +many of the utilities and preferences applications in helloSystem +* __Qt Creator__: The integrated development environment (IDE) for Qt-based applications, such as Menu, Dock, and Filer. +Includes graphical user interface editors for QtWidgets-based user interfaces (such as Menu and Filer) using `.ui` files +and for Qml-based user interfaces (such as Dock) using `.qml` files. +The user interfaces generated in Qt Creator can be used in Qt application written in C++ or Python +* __LiteIDE__: An integrated development environment (IDE) for the Go language. Go is recommended +for long-running processes such as servers and for processes with parallelism +* __Zeal__: A browser for documentation sets, also known as "docsets". Docsets can be downloaded from within the application +and are available for many languages and environments, including Python, Qt, and Go. + +To minimize the initial download size of the helloSystem image, the applications in the Developer folder +need to be downloaded prior to first use. You will be guided through this automatic process when you launch these +applications for the first time. After the applciations have been downloaded, you can use them without an active +network connection. From 84fd386c583836ec03a55f3c304a8a6036ceedeb Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 4 Jan 2021 22:24:51 +0100 Subject: [PATCH 194/592] Add Developer Tools --- index.md | 1 + 1 file changed, 1 insertion(+) diff --git a/index.md b/index.md index d443545e..e8b34206 100644 --- a/index.md +++ b/index.md @@ -36,6 +36,7 @@ __hello__ (also known as __helloSystem__) is a desktop system for creators with developer/graphics developer/applications developer/menu + developer/developer-tools developer/contributing developer/building developer/distributions From f91ecfaf7b60a2bb23a34303d5199a76874dc21d Mon Sep 17 00:00:00 2001 From: probonopd Date: Tue, 5 Jan 2021 23:56:24 +0100 Subject: [PATCH 195/592] Create specifications.md --- developer/specifications.md | 34 ++++++++++++++++++++++++++++++++++ 1 file changed, 34 insertions(+) create mode 100644 developer/specifications.md diff --git a/developer/specifications.md b/developer/specifications.md new file mode 100644 index 00000000..3d45b2c4 --- /dev/null +++ b/developer/specifications.md @@ -0,0 +1,34 @@ +# Specifications + +helloSystem is designed to be friendly and welcoming. The desired user experience informs the specifications embraced for use in helloSystem and applications running on it. + +## Specifications embraced for use in helloSystem + +These specifications cover technologies that are enthusiastically embraced in helloSystem and/or are recommended to be used in applications running on it. + +* __mDNS__: Allows hostnames of devices to be published to the network, so that devices can be accessed using their names rather than using IP numbers. +* __DNS-SD/Zeroconf__: Allows for the discovery of services on the network, such as websites, SSH servers, SFTP shares, etc. If an application can handle certain types of network services, it should discover such services using DNS-SD/Zeroconf. For example, a Terminal application might offer to connect to SSH servers on the network discovered with DNS-SD/Zeroconf. +* __IPP Everywhere__: Allows printers to "just work" without configuring printer drivers. +* __AppImage__: Allows applications to be shipped and used as single files. helloSystem may predominantly use this format for Linux applications in the future. +* __Markdown__: The standard format for all documentation and other written text. +* __UTF-8__: The default encoding for text. + +This list is not exhaustive. + +## Conventions devloped for use in helloSystem + +These conventions cover technologies that are embraced for being used in helloSystem and applications running on it. + +* __Simplified application bundles:__ The format helloSystem predominantly uses for native applications. Derived from the GNUstep `.app` bundle format, but further simplified. Not formally specified yet. + +This list is not exhaustive. + +## Specifications with relevance for helloSystem + +These specifications cover technologies that may have relevance for helloSystem and are mostly considered for compatibility reasons. Their use within helloSystem may decline over time as more native replacements become available. + +* __ICCCM/EWMH__: Allows windows to be managed on Xorg. [This page in the picom wiki](https://github.com/yshui/picom/wiki/Window-states-management) gives an overview +* __D-Bus__: Allows processes on the system to interact with each other (inter-process communication, IPC) +* __XDG Desktop specification__: Although helloSystem uses simplified application bundles to provide the desired user experience, some existing applications in FreeBSD ports and packages may come with `.desktop` files. To maintain compatibility with the vast body of existing applications, helloSystem needs to provide a basic implementation of this specification, although its use should be minimized in helloSystem to allow for the desired user experience. For example, all handling of `.desktop` files could be left to one command line tool such as `desktop2app` that would convert `.desktop` files into the format used natively in helloSystem. Other uses of the XDG Desktop specification may be phased out in the future + +This list is not exhaustive. From 1c51f6cd299afb2559d01c7cc3f3935ece2a9386 Mon Sep 17 00:00:00 2001 From: probonopd Date: Tue, 5 Jan 2021 23:57:38 +0100 Subject: [PATCH 196/592] Update index.md --- index.md | 1 + 1 file changed, 1 insertion(+) diff --git a/index.md b/index.md index e8b34206..947e0adc 100644 --- a/index.md +++ b/index.md @@ -37,6 +37,7 @@ __hello__ (also known as __helloSystem__) is a desktop system for creators with developer/applications developer/menu developer/developer-tools + developer/specifications developer/contributing developer/building developer/distributions From 220e7b35bc42b378843d28702e5ded2f92b2a4ba Mon Sep 17 00:00:00 2001 From: probonopd Date: Wed, 6 Jan 2021 23:52:09 +0100 Subject: [PATCH 197/592] Update menu.md --- developer/menu.md | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/developer/menu.md b/developer/menu.md index f198d374..07d19059 100644 --- a/developer/menu.md +++ b/developer/menu.md @@ -207,6 +207,17 @@ information to be displayed to users of the application through the interface sh ## Executables involved +_To be written._ + +## Patches needed for Firefox and Thunderbird + +It seems that one would need to apply these two patches from [firefox-appmenu in AUR](https://aur.archlinux.org/packages/firefox-appmenu/,https://aur.archlinux.org/cgit/aur.git/tree/unity-menubar.patch?h=firefox-appmenu): + +* https://aur.archlinux.org/cgit/aur.git/tree/unity-menubar.patch?h=firefox-appmenu +* https://aur.archlinux.org/cgit/aur.git/tree/0001-Use-remoting-name-for-GDK-application-names.patch?h=firefox-appmenu + +_To be verified._ + ### GMenu-DBusMenu-Proxy ``` From 069304cc1d47a082a07ea7d84c089abc577580a8 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 10 Jan 2021 08:56:57 +0100 Subject: [PATCH 198/592] Try tag --- user/components/preferences/shortcuts.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/user/components/preferences/shortcuts.md b/user/components/preferences/shortcuts.md index 47854f33..a6530a3a 100644 --- a/user/components/preferences/shortcuts.md +++ b/user/components/preferences/shortcuts.md @@ -19,7 +19,7 @@ Open the __Shortcut Keys__ preferences application to view the default system-wi Notable default shortcuts include: -* Press __Alt+Space__ to __search in the Menu__ (e.g., to launch applications or to execute commands in the frontmost application) +* Press __Alt+Space__ to __search in the Menu__ (e.g., to launch applications or to execute commands in the frontmost application) * Press __Ctrl+Alt+Esc__ and click on an application window to __forcefully quit an application__ that is malfunctioning * Press __Alt+Shift+3__ or the __PrtScn__ key on your keyboard to __take a screenshot__ From 24a57adfa14517bb97da9096db5dc3edde6a7d77 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 10 Jan 2021 09:18:14 +0100 Subject: [PATCH 199/592] does not work in Sphinx --- user/components/preferences/shortcuts.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/user/components/preferences/shortcuts.md b/user/components/preferences/shortcuts.md index a6530a3a..47854f33 100644 --- a/user/components/preferences/shortcuts.md +++ b/user/components/preferences/shortcuts.md @@ -19,7 +19,7 @@ Open the __Shortcut Keys__ preferences application to view the default system-wi Notable default shortcuts include: -* Press __Alt+Space__ to __search in the Menu__ (e.g., to launch applications or to execute commands in the frontmost application) +* Press __Alt+Space__ to __search in the Menu__ (e.g., to launch applications or to execute commands in the frontmost application) * Press __Ctrl+Alt+Esc__ and click on an application window to __forcefully quit an application__ that is malfunctioning * Press __Alt+Shift+3__ or the __PrtScn__ key on your keyboard to __take a screenshot__ From 0d6a79348824b868eda333ea7e61920d1ab09304 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 11 Jan 2021 20:52:43 +0100 Subject: [PATCH 200/592] No font installed for displaying this --- index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.md b/index.md index 947e0adc..d2aaef01 100644 --- a/index.md +++ b/index.md @@ -5,7 +5,7 @@ ``` ```eval_rst -.. centered:: Willkommen • Welcome • 欢迎 • Bienvenue • Benvenuto • Bienvenido • ようこそ • Mabuhay • Välkommen • أهلا وسهلا • Добро пожаловать • Merhaba • Bonvenon • 歡迎光臨 +.. centered:: Willkommen • Welcome • 欢迎 • Bienvenue • Benvenuto • Bienvenido • ようこそ • Mabuhay • Välkommen • Добро пожаловать • Merhaba • Bonvenon • 歡迎光臨 ``` # hello From 8bf90e466c71ee27454e4aa6e13aa74969490f1c Mon Sep 17 00:00:00 2001 From: probonopd Date: Tue, 12 Jan 2021 22:09:51 +0100 Subject: [PATCH 201/592] Clarify what libappindicator is needed for Needed for some applications (e.g., screenkey) to show icons in the upper right hand corner of the menu (system tray/notification area) https://github.com/helloSystem/ISO/issues/96 --- developer/menu.md | 20 +++++++++++++++++++- 1 file changed, 19 insertions(+), 1 deletion(-) diff --git a/developer/menu.md b/developer/menu.md index 07d19059..be14cc7e 100644 --- a/developer/menu.md +++ b/developer/menu.md @@ -40,7 +40,7 @@ Those may or may not be used in helloSystem, they are mentioned here to give an * [__AyatanaIndicators__](https://github.com/AyatanaIndicators): tbd. A project that as of 2020 seems to be still pretty active on https://github.com/AyatanaIndicators. __With Ubuntu now using Gnome rather than Unity, what is this AytanaIndicators project doing?__ * [__Application Menu or appmenu__](https://wiki.ubuntu.com/DesktopExperienceTeam/ApplicationMenu): As part of Aytana, Canonical has produced an implementation called `indicator-appmenu` which re-routes Gtk and Qt menus over `dbusmenu` so that they appear in the panel * [__dbusmenu__](https://wiki.ubuntu.com/DesktopExperienceTeam/ApplicationIndicators#Software_Architecture): Library by Canonical implementing the transport protocol between the applications and the panel -* [__libappindicator__](https://wiki.ubuntu.com/DesktopExperienceTeam/ApplicationIndicators#Software_Architecture): Library by Canonical to register icons and menus and internally uses dbusmenu to publish context menus over dbus. The same as [`indicator-application`](https://launchpad.net/indicator-application)? +* [__libappindicator__](https://wiki.ubuntu.com/DesktopExperienceTeam/ApplicationIndicators#Software_Architecture): Library by Canonical to register icons and menus and internally uses dbusmenu to publish context menus over dbus. Needed for some applications (e.g., screenkey) to show icons in the upper right hand corner of the menu (system tray/notification area). The same as [`indicator-application`](https://launchpad.net/indicator-application)? * [__MenuModel__](): Used by Gtk * [__JAyatana__](): Supposedly allows for displaying global menus in Java Swing applications (such as Netbeans and the JetBrains suite of IDEs) @@ -54,6 +54,24 @@ The following libraries are involved in allowing applications to show their menu Please consider submitting issues and pull requests if you can contribute to this subject. ``` +### libappindicator + +``` +/usr/local/lib/libappindicator3.so.1 +/usr/local/lib/libappindicator3.so.1.0.0 +/usr/local/lib/libappindicator3.so +/usr/local/lib/libappindicator3.a +``` + +* Author: Ted Gould, Canonical +* Description: A library to allow applications to export a menu into the Unity Menu bar. Based on KSNI it also works in KDE and will fallback to generic Systray support if none of those are available. +* Bugtracker: https://launchpad.net/libappindicator +* Purpose: Needed for some applications (e.g., `screenkey`) to show icons in the upper right hand corner of the menu (system tray/notification area) +* Theory of operation: tbd +* Status: active +* Issues: tbd +* Installed by package: `libappindicator` + ### libappmenu-gtk-module library from vala-panel-appmenu repository ``` From 89b34b22f3b33c3f31d207cf7712dca8719f17c1 Mon Sep 17 00:00:00 2001 From: probonopd Date: Tue, 12 Jan 2021 22:22:25 +0100 Subject: [PATCH 202/592] Seeing what the system is doing while the graphical boot screen is shown Thanks @bsdlme for this hint --- developer/boot.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/developer/boot.md b/developer/boot.md index dbd548f2..72433077 100644 --- a/developer/boot.md +++ b/developer/boot.md @@ -23,6 +23,10 @@ This is a simplified description of the boot process. There may be additional as * __Hangs or reboots during replicating the system image to swap-based memdisk.__ The ISO is damaged. About one out of 10 builds of the ISO have this issue. Simply build a new ISO or wait for the next ISO to be available for download * __"Cannot mount tmpfs on /dev/reroot: Operation not supported by device".__ Reason unkown. Are needed kernel modules missing? +### Seeing what the system is doing while the graphical boot screen is shown + +When you see the graphical boot screen your can press __Esc__ and then press __Ctrl+T_ to see what it is doing at that moment in time. You can press __Ctrl+T__ repeatedly to see what is going on over time. + ### Boot in verbose mode If you would like to observe the details of the boot process, you can start your computer in __verbose mode__. This allows you to inspect the Live system early boot process and to enter commands manually that would otherwise be executed automatically. From 448b30993bb0f2dd16af0583aa8f3e301e753c61 Mon Sep 17 00:00:00 2001 From: probonopd Date: Wed, 13 Jan 2021 03:24:50 +0100 Subject: [PATCH 203/592] No need to press esc --- developer/boot.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/developer/boot.md b/developer/boot.md index 72433077..3c71f735 100644 --- a/developer/boot.md +++ b/developer/boot.md @@ -25,7 +25,7 @@ This is a simplified description of the boot process. There may be additional as ### Seeing what the system is doing while the graphical boot screen is shown -When you see the graphical boot screen your can press __Esc__ and then press __Ctrl+T_ to see what it is doing at that moment in time. You can press __Ctrl+T__ repeatedly to see what is going on over time. +While the graphical boot screen is being displayed you can press __Ctrl+T__ to see what it is doing at that moment in time. Press __Ctrl+T__ repeatedly to see what is going on over time. ### Boot in verbose mode From 22461d578c03de2c6d374acd36812bfe33584fbf Mon Sep 17 00:00:00 2001 From: probonopd Date: Wed, 13 Jan 2021 03:46:00 +0100 Subject: [PATCH 204/592] Create mountarchive.md --- user/components/utilities/mountarchive.md | 5 +++++ 1 file changed, 5 insertions(+) create mode 100644 user/components/utilities/mountarchive.md diff --git a/user/components/utilities/mountarchive.md b/user/components/utilities/mountarchive.md new file mode 100644 index 00000000..721f8fce --- /dev/null +++ b/user/components/utilities/mountarchive.md @@ -0,0 +1,5 @@ +# mountarchive + +The __`mountarchive`__ tool makes archives (like `.zip`, `.tar.gz`, and `.tar.bz2` accesible in the Filer without having to extract them. + +For example, if you double-click a zip file called `plugin.video.invidious-0.5.3.zip` on your desktop, it will be mounted and a Filer window will be opened at its mountpoint, e.g., `/var/run/user/1001/_home_user_Desktop_plugin.video.invidious-0.5.3.zip`. From 37e0165373de3e3beffd7e40d4535cd77be86c29 Mon Sep 17 00:00:00 2001 From: probonopd Date: Fri, 15 Jan 2021 20:05:12 +0100 Subject: [PATCH 205/592] Add files via upload --- _static/book-cover-pyqt5.png | Bin 0 -> 88155 bytes 1 file changed, 0 insertions(+), 0 deletions(-) create mode 100644 _static/book-cover-pyqt5.png diff --git a/_static/book-cover-pyqt5.png b/_static/book-cover-pyqt5.png new file mode 100644 index 0000000000000000000000000000000000000000..9a26c3d3c4cd87c09a4c1f4001192aadd96ea3c3 GIT binary patch literal 88155 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⪙Niu>T0)&fCE4O< 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 MYGi3xhPod2ABhoorvLx| literal 0 HcmV?d00001 From 90402f26058b5b859bc6f0c1c7d1ddc643d8260b Mon Sep 17 00:00:00 2001 From: probonopd Date: Fri, 15 Jan 2021 20:12:54 +0100 Subject: [PATCH 206/592] Book by Martin Fitzpatrick --- developer/applications.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/developer/applications.md b/developer/applications.md index fc0fe201..36b7dc31 100644 --- a/developer/applications.md +++ b/developer/applications.md @@ -10,3 +10,7 @@ Applications specifically written for helloSystem, especially Preferences and Ut Some of the example applications and utilities are written in Python with PyQt. This is designed to invite (power) users to have a look at the code, start to experiment, and possibly eventually contribute. Especially when used in conjunction with the simplified `.app` bundle format and with an IDE with autocompletion, this makes for a _very_ accessible development environment with _very_ low barriers to entry. No source code to search and download, no compilers, just open the `.app` bundle and start hacking away. Tiny example applications like `Log.app` and `Calendar.app` are included that anyone should be able to understand in no time. Please see [https://github.com/learnpyqt/15-minute-apps](https://github.com/learnpyqt/15-minute-apps) for what we mean by "Simple to use" and "Easy to hack on". + +For an introduction to [Creating GUI applications with Python & Qt5](https://www.learnpyqt.com/pyqt5-book/) you may be interested in the book with the same name by Martin Fitzpatrick. There is also a forum at [forum.learnpyqt.com](https://forum.learnpyqt.com/). + +![](/book-pyqt5.png) From eb80b957402942e2fe6b5a6b054965c8596e1f4f Mon Sep 17 00:00:00 2001 From: probonopd Date: Fri, 15 Jan 2021 20:16:35 +0100 Subject: [PATCH 207/592] Update applications.md --- developer/applications.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/developer/applications.md b/developer/applications.md index 36b7dc31..1811f27e 100644 --- a/developer/applications.md +++ b/developer/applications.md @@ -13,4 +13,4 @@ Please see [https://github.com/learnpyqt/15-minute-apps](https://github.com/lear For an introduction to [Creating GUI applications with Python & Qt5](https://www.learnpyqt.com/pyqt5-book/) you may be interested in the book with the same name by Martin Fitzpatrick. There is also a forum at [forum.learnpyqt.com](https://forum.learnpyqt.com/). -![](/book-pyqt5.png) +![](../_static/book-pyqt5.png) From 96fa7804177a2f3563603802214874eb89592f9c Mon Sep 17 00:00:00 2001 From: probonopd Date: Fri, 15 Jan 2021 20:45:57 +0100 Subject: [PATCH 208/592] Delete book-cover-pyqt5.png --- _static/book-cover-pyqt5.png | Bin 88155 -> 0 bytes 1 file changed, 0 insertions(+), 0 deletions(-) delete mode 100644 _static/book-cover-pyqt5.png diff --git a/_static/book-cover-pyqt5.png b/_static/book-cover-pyqt5.png deleted file mode 100644 index 9a26c3d3c4cd87c09a4c1f4001192aadd96ea3c3..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 88155 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⪙Niu>T0)&fCE4O< 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 MYGi3xhPod2ABhoorvLx| From 9c13b13ce56864ad17f3d074c17439159743eaa6 Mon Sep 17 00:00:00 2001 From: probonopd Date: Fri, 15 Jan 2021 20:46:20 +0100 Subject: [PATCH 209/592] Add files via upload --- _static/book-pyqt5.png | Bin 0 -> 15577 bytes 1 file changed, 0 insertions(+), 0 deletions(-) create mode 100644 _static/book-pyqt5.png diff --git a/_static/book-pyqt5.png b/_static/book-pyqt5.png new file mode 100644 index 0000000000000000000000000000000000000000..676adef2938b4e79d0eaf0560951845412394152 GIT binary patch literal 15577 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 literal 0 HcmV?d00001 From 18f98d886e802f2e8fd3844b69a4fe1191253a7a Mon Sep 17 00:00:00 2001 From: probonopd Date: Fri, 15 Jan 2021 20:51:08 +0100 Subject: [PATCH 210/592] Book cover --- developer/applications.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/developer/applications.md b/developer/applications.md index 1811f27e..8d117987 100644 --- a/developer/applications.md +++ b/developer/applications.md @@ -13,4 +13,4 @@ Please see [https://github.com/learnpyqt/15-minute-apps](https://github.com/lear For an introduction to [Creating GUI applications with Python & Qt5](https://www.learnpyqt.com/pyqt5-book/) you may be interested in the book with the same name by Martin Fitzpatrick. There is also a forum at [forum.learnpyqt.com](https://forum.learnpyqt.com/). -![](../_static/book-pyqt5.png) +[![](../../_images//book-pyqt5.png)](https://www.learnpyqt.com/pyqt5-book/) From fae2cc8d393d7e61d3531c34e3aaba3de3d3c13e Mon Sep 17 00:00:00 2001 From: probonopd Date: Fri, 15 Jan 2021 20:54:57 +0100 Subject: [PATCH 211/592] Absolute URL (FIXME: Make relative) --- developer/applications.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/developer/applications.md b/developer/applications.md index 8d117987..a60f11e9 100644 --- a/developer/applications.md +++ b/developer/applications.md @@ -13,4 +13,4 @@ Please see [https://github.com/learnpyqt/15-minute-apps](https://github.com/lear For an introduction to [Creating GUI applications with Python & Qt5](https://www.learnpyqt.com/pyqt5-book/) you may be interested in the book with the same name by Martin Fitzpatrick. There is also a forum at [forum.learnpyqt.com](https://forum.learnpyqt.com/). -[![](../../_images//book-pyqt5.png)](https://www.learnpyqt.com/pyqt5-book/) +[![](https://hellosystem.github.io/docs/_static/book-pyqt5.png)](https://www.learnpyqt.com/pyqt5-book/) From 1770efc6e005c86a4c22df319e597fe0f9549042 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 16 Jan 2021 15:09:38 +0100 Subject: [PATCH 212/592] Clarify Live single-user mode Closes https://github.com/helloSystem/docs/issues/10 --- developer/boot.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/developer/boot.md b/developer/boot.md index 3c71f735..547cc173 100644 --- a/developer/boot.md +++ b/developer/boot.md @@ -47,6 +47,12 @@ If your computer hangs during booting, you can boot into __verbose single-user m The computer should boot into a text console rescue system in which parts of `init.sh` from the ramdisk image have run. +``` .. note:: + Single-user mode on the Live system currently is for developers of the Live system only. + + If you boot the Live system into single-user mode, then you will be dropped into a shell in the ramdisk, and you are expected to manually enter the commands required for the Live system to continue booting which would otherwise be executed by the ramdisk automatically. Specifically, you need to enter everything below the line "Running in single-user mode" in the file overlays/ramdisk/init.sh (or variants thereof). If you just exit the shell without doing this, then the system will be unable to continue booting. +``` + ## Graphical desktop start process 1. The system is configured in `/etc/rc.conf` to start the `slim` login manager. This also results in Xorg being started From d5137056a61de148a794bd4eca736d6f2836b593 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 17 Jan 2021 11:59:57 +0100 Subject: [PATCH 213/592] Create application-bundles.md --- developer/application-bundles.md | 54 ++++++++++++++++++++++++++++++++ 1 file changed, 54 insertions(+) create mode 100644 developer/application-bundles.md diff --git a/developer/application-bundles.md b/developer/application-bundles.md new file mode 100644 index 00000000..d8e09cdf --- /dev/null +++ b/developer/application-bundles.md @@ -0,0 +1,54 @@ +# Application Bundles + +helloSystem uses __application bundles__ to manage native applications. Whenever possible, simplified GNUstep-style `.app` bundles are used, but ROX/AppImage-style `.AppDir` bundles are also supported. XDG-style `.desktop` files are considered legacy and should be avoided. + +## Application bundle formats + +### `.app` bundles + +helloSystem supports simplified GNUstep-style `.app` bundles. + +Minimal requirements: + +``` +./Application.app +./Application.app/Application <-- (link to) the executable to be launched when Application.app is double clicked +./Application.app/Resources/Application.png <-- the application icon (png format) +``` + +In order to realize the full intended functionality, additional metadata may be required (such as localized application name, version, supported file formats, etc.). Possibly the GNUstep metadata format is sufficient for this. + +### `.AppDir` bundles + +helloSystem supports simplified ROX-style `.AppDir` bundles. + +Minimal requirements: + +``` +./Application.AppDir +./Application.AppDir/AppRun <-- (link to) the executable to be launched when Application.app is double clicked +./Application.AppDir/.DirIcon <-- the application icon (png format) +``` + +In order to realize the full intended functionality, additional metadata may be required (such as localized application name, version, supported file formats, etc.). Possibly the ROX AppDir specification is not sufficient for this and may need to be amended (to be determined). + +### Wrappers for legacy packages + +helloSystem supports applications that are not shipped in bundle formats yet. These can be bridged by __wrapper bundles__, application bundles that merely launch (but do not contain) the payload application (which may be installed in traditional ways). + +A __desktop2app__ tool ships with helloSystem that automates the creation of such wrappers. + +Please note that the use of wrapper bundles is discouraged and is only available as a bridge technology for backward compatibility with existing application packages. + +## Getting application metadata for running applications + +Many desktop environments use XDG-style `.desktop` files to figure out which application a given window belongs to but since helloSystem is using `.app` bundles and `.AppDir` application directories this approach is not sufficient since such applications normally do not install XDG-style `.desktop` files in central locations. + +Docks (and other similar applciations) can find the icon that belongs to a window on the screen by the following procedure: + +1. Get the Window IDs of the windows on the screen from Xorg (to simulate this, you can use the `xprop` tool) +1. Get the process ID (PID) that has launched the window with this ID from the `` property of the Xorg window +1. Get the path of the executable and its arguments that launched this PID from the operating system, e.g., using `/proc/$PID/cmdline` (Linux) or the `procstat` command (FreeBSD) +1. From the path and the arguments figure out which element might be the relevant `.app` bundle or `.AppDir`. For example, a process might have been invoked with `sudo -E launch python3 /Applications/Some.app/Some --arguments 123`. In this case the relevant information is in a "random" location within the long list of arguments. Also consider the case `python3 /Applications/Some.app/Resources/some-executable`. In this case `some-executable` is in a subdirectory of the application bundle + +A rudimentary implementation of this logic is in place in Dock in the `Utils::readInfoFromPid(quint32 pid)` and `Utils::examinePotentialBundlePath(QString path)` methods, but improvements are highly welcome. From 389bace9dce7ab60cece8b3e909a9c2cf180f40e Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 17 Jan 2021 12:04:25 +0100 Subject: [PATCH 214/592] Update application-bundles.md --- developer/application-bundles.md | 14 +++++++++++++- 1 file changed, 13 insertions(+), 1 deletion(-) diff --git a/developer/application-bundles.md b/developer/application-bundles.md index d8e09cdf..9aebee8a 100644 --- a/developer/application-bundles.md +++ b/developer/application-bundles.md @@ -1,6 +1,18 @@ # Application Bundles -helloSystem uses __application bundles__ to manage native applications. Whenever possible, simplified GNUstep-style `.app` bundles are used, but ROX/AppImage-style `.AppDir` bundles are also supported. XDG-style `.desktop` files are considered legacy and should be avoided. +helloSystem uses __application bundles__ to manage native applications. Whenever possible, application bundles are used. XDG-style `.desktop` files are considered legacy and should be avoided. + +## Benefits + +Applications stipped as application bundles can + +* Easily be moved around in the filesystem (relocation) +* Easily be copied to e.g., another machine or a network share +* Easily be copied on the local machine to get a second instance of the same application (e.g., to make changes to it while keeping the original around) +* Easily be deleted by moving to the Trash +* Easily be managed without the need for a package manager +* Easily be distributed (e.g., in archives like zip files or in disk images) without the need for packaging +* Easily be understood by switchers coming from other operating systems with similar application distribution formats ## Application bundle formats From 61192299a75cdb680a7cea66a39754ea632c9b29 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 17 Jan 2021 12:05:08 +0100 Subject: [PATCH 215/592] Update application-bundles.md --- developer/application-bundles.md | 1 + 1 file changed, 1 insertion(+) diff --git a/developer/application-bundles.md b/developer/application-bundles.md index 9aebee8a..59dcabb5 100644 --- a/developer/application-bundles.md +++ b/developer/application-bundles.md @@ -11,6 +11,7 @@ Applications stipped as application bundles can * Easily be copied on the local machine to get a second instance of the same application (e.g., to make changes to it while keeping the original around) * Easily be deleted by moving to the Trash * Easily be managed without the need for a package manager +* Easily be modified (e.g., changing the icon) without any side effects to other parts of the system * Easily be distributed (e.g., in archives like zip files or in disk images) without the need for packaging * Easily be understood by switchers coming from other operating systems with similar application distribution formats From e6490ade15c66ab7fc1b474b36beed37b38f0e3a Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 17 Jan 2021 12:07:03 +0100 Subject: [PATCH 216/592] Add Credits --- developer/application-bundles.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/developer/application-bundles.md b/developer/application-bundles.md index 59dcabb5..fdf6377d 100644 --- a/developer/application-bundles.md +++ b/developer/application-bundles.md @@ -65,3 +65,7 @@ Docks (and other similar applciations) can find the icon that belongs to a windo 1. From the path and the arguments figure out which element might be the relevant `.app` bundle or `.AppDir`. For example, a process might have been invoked with `sudo -E launch python3 /Applications/Some.app/Some --arguments 123`. In this case the relevant information is in a "random" location within the long list of arguments. Also consider the case `python3 /Applications/Some.app/Resources/some-executable`. In this case `some-executable` is in a subdirectory of the application bundle A rudimentary implementation of this logic is in place in Dock in the `Utils::readInfoFromPid(quint32 pid)` and `Utils::examinePotentialBundlePath(QString path)` methods, but improvements are highly welcome. + +## Credits + +* https://en.wikipedia.org/wiki/Application_directory From d66879e1f260ac356355503eff670c6762c71be9 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 17 Jan 2021 12:08:58 +0100 Subject: [PATCH 217/592] Add Architecture and Application Bundles --- index.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/index.md b/index.md index d2aaef01..3c2af1ed 100644 --- a/index.md +++ b/index.md @@ -32,9 +32,11 @@ __hello__ (also known as __helloSystem__) is a desktop system for creators with :maxdepth: 2 :glob: + developer/architecture developer/boot developer/graphics developer/applications + developer/application-bundles developer/menu developer/developer-tools developer/specifications From 27cb90edfeeec2a4f86d53a4820929039b0f4772 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 17 Jan 2021 12:10:16 +0100 Subject: [PATCH 218/592] Create architecture.md --- developer/architecture.md | 60 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 60 insertions(+) create mode 100644 developer/architecture.md diff --git a/developer/architecture.md b/developer/architecture.md new file mode 100644 index 00000000..b0df888a --- /dev/null +++ b/developer/architecture.md @@ -0,0 +1,60 @@ +# Archietcture + +helloSystem is designed with simplicity in mind. Less, but better. This page describes key elements of the hello desktop. As a general rule, everything should be welcoming for Mac users but 10x as simple. + +## Frameworks + +In order of preference: +* PyQt +* Qml +* Qt +* Kf5 components where absolutely needed +* Everything else +* Gtk + +Rationale: Most cross real-world productivity applications are written cross-platform and this often means Qt. Hence, to provide the best possible environment for those applications, we choose Qt for now. Philosophically, we would prefer to use something BSD licensed (or similar), such as FyneDesk, but in its current state it cannot yet provide the same truly native experience for existing Qt applications. (Maybe it helps to think of Qt as the "Carbon of hello", whereas something else will eventually become the "Cocoa of hello".) + +## Desktop components + +The minimum number of components viable to produce an efficient desktop should be used. Each component should be as simple as possible, and have as few dependencies as possible (besides the ones that are central to the hello Desktop, such as Qt and PyQt). Outside dependencies that are closely tied to other outside components should be avoided. XDG specifications are considered overly complex but insufficient and should be avoided, but may be acceptable as legacy technology for compatibility reasons. + +### Filer + +File manager that can handle (simplified) `.app` and `.AppDir` bundles + +### Menu + +Global menu bar that displays the System menu for system-wide commands (such as 'About this Computer'), and the active application's menus. It also contains a search box to search in the menus. + +### Dock + +A Dock that shows icons for running and pinned applications. (In the future it should als get an animated icon as a launching indicator for applications that are being launched but are not yet showing a window.) + +### `launch` command + +The `launch` command is used to launch applications without specifying a path to them. + +The `launch` command is expceted to determine the preferred instance of an application with the given name. (The `launch` command is supposed to find the _preferred_ instance, e.g., the one with the highest version, the one last put onto the system, etc.) Eventually the `launch` command should also get knowledge which application to open a file with. + +Filer is supposed to launch all applications through the `launch` command. Shell scripts, `.desktop` files, etc. should be written to use the `launch` command rather than hardcoding paths to applications, where appropriate. + +If an application cannot be launched, the `launch` command shall give a localized, understandable clear-text error message and offer a solution if possible; fall back to the console output of the application that could not be launched. +When beginning to launch an application, the `launch` command shall notify the Dock via some IPC mechanism (ideally something _much_ simpler than the convoluted D-Bus) about the icon and name of the application about to be launched, so that the Dock can start a launch animation until the application is showing its first window). + +### IPC mechanism for the desktop + +A very simple IPC mechanism should be introduced for the desktop components to talk to each other. A lightweight, standard publish/subscribe mechanism should be identified; _possibly_ something like MQTT (which would have the added benefit of allowing for network-wide communication). In the meantime, the use of D-Bus as a legacy technology may be acceptable (even though it is considered obscure, convoluted, and closely linked with various other Red Hat technologies.) + +### Applications + +Applications must not need to be installed. Simply downloading them, attaching an external drive containing them, or connecting to a network share containing them must be sufficient. Mutliple versions of the same application must be able to co-exist. The `launch` command is resposible to determine which one to use in cases where the user did not explicitly launch a specific instance by double-clicking it. + +Custom-written applications should come as Appplication bundles whenever possible. It is accaptable for pre-existing applications to come with legacy XDG desktop files instead. + +### Utilities + +The system should come with some commonly used utilities, such as a Terminal application, a Process Monitor application, etc. These are just regular applications inside a 'Utilities' subdirectory. It is accaptable for pre-existing applications, preferably written in Qt. + +### Preferences + +The system should come with some commonly used preference panels, such as for configuring the system language, OpenZFS Boot Environments, etc. These are just regular applications inside a 'Preferences' subdirectory. These should be super simple, "minimal viable" applications. It is expected that many will need to be written from scratch, but it is accaptable to re-use pre-existing applications, preferably written in Qt. From c95a1b410c222cc70d249a38b676e32b8afeb5e6 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 17 Jan 2021 12:12:50 +0100 Subject: [PATCH 219/592] _NET_WM_PID --- developer/application-bundles.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/developer/application-bundles.md b/developer/application-bundles.md index fdf6377d..cc9b6c55 100644 --- a/developer/application-bundles.md +++ b/developer/application-bundles.md @@ -60,7 +60,7 @@ Many desktop environments use XDG-style `.desktop` files to figure out which app Docks (and other similar applciations) can find the icon that belongs to a window on the screen by the following procedure: 1. Get the Window IDs of the windows on the screen from Xorg (to simulate this, you can use the `xprop` tool) -1. Get the process ID (PID) that has launched the window with this ID from the `` property of the Xorg window +1. Get the process ID (PID) that has launched the window with this ID from the `_NET_WM_PID` property of the Xorg window 1. Get the path of the executable and its arguments that launched this PID from the operating system, e.g., using `/proc/$PID/cmdline` (Linux) or the `procstat` command (FreeBSD) 1. From the path and the arguments figure out which element might be the relevant `.app` bundle or `.AppDir`. For example, a process might have been invoked with `sudo -E launch python3 /Applications/Some.app/Some --arguments 123`. In this case the relevant information is in a "random" location within the long list of arguments. Also consider the case `python3 /Applications/Some.app/Resources/some-executable`. In this case `some-executable` is in a subdirectory of the application bundle From 6de01b406b9da796f69cec5e33e98bbd3956bb3a Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 17 Jan 2021 12:27:03 +0100 Subject: [PATCH 220/592] Update application-bundles.md --- developer/application-bundles.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/developer/application-bundles.md b/developer/application-bundles.md index cc9b6c55..0ff0bc39 100644 --- a/developer/application-bundles.md +++ b/developer/application-bundles.md @@ -68,4 +68,8 @@ A rudimentary implementation of this logic is in place in Dock in the `Utils::re ## Credits +Application directories and applciation bundles have been used by many desktop-oriented operating systems, including RISC OS, NeXTStep/OPENSTEP, Mac OS X, and various other systems. Classic Macintosh System used single-file applications that kept resources in the Resource Fork. + * https://en.wikipedia.org/wiki/Application_directory +* http://rox.sourceforge.net/desktop/AppDirs.html +* https://en.wikipedia.org/wiki/Resource_fork From ce60f6784c12057e48e053e0d6fd49fc8708f6c2 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 17 Jan 2021 13:03:06 +0100 Subject: [PATCH 221/592] Note on sysctl.conf --- developer/application-bundles.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/developer/application-bundles.md b/developer/application-bundles.md index 0ff0bc39..fbf79312 100644 --- a/developer/application-bundles.md +++ b/developer/application-bundles.md @@ -66,6 +66,11 @@ Docks (and other similar applciations) can find the icon that belongs to a windo A rudimentary implementation of this logic is in place in Dock in the `Utils::readInfoFromPid(quint32 pid)` and `Utils::examinePotentialBundlePath(QString path)` methods, but improvements are highly welcome. + +``` .. note:: + To display the correct icons in Dock for processes running as root, users must be able to see information on processes running as root. Hence security.bsd.see_other_uids=0 must not be set in sysctl.conf for this to work. +``` + ## Credits Application directories and applciation bundles have been used by many desktop-oriented operating systems, including RISC OS, NeXTStep/OPENSTEP, Mac OS X, and various other systems. Classic Macintosh System used single-file applications that kept resources in the Resource Fork. From 6306748255895fad7021e3f2725a9d63c4be40e7 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 17 Jan 2021 20:30:39 +0100 Subject: [PATCH 222/592] Update application-bundles.md --- developer/application-bundles.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/developer/application-bundles.md b/developer/application-bundles.md index fbf79312..c1f590b0 100644 --- a/developer/application-bundles.md +++ b/developer/application-bundles.md @@ -4,7 +4,7 @@ helloSystem uses __application bundles__ to manage native applications. Whenever ## Benefits -Applications stipped as application bundles can +Applications shipped as application bundles can * Easily be moved around in the filesystem (relocation) * Easily be copied to e.g., another machine or a network share From 05b864b7123ba47b8e581daa20db7d5785c48469 Mon Sep 17 00:00:00 2001 From: Roman Zaynetdinov <627197+zaynetro@users.noreply.github.com> Date: Tue, 19 Jan 2021 00:46:21 +0200 Subject: [PATCH 223/592] Fix architecture title spelling (#11) --- developer/architecture.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/developer/architecture.md b/developer/architecture.md index b0df888a..e358e8ad 100644 --- a/developer/architecture.md +++ b/developer/architecture.md @@ -1,4 +1,4 @@ -# Archietcture +# Architecture helloSystem is designed with simplicity in mind. Less, but better. This page describes key elements of the hello desktop. As a general rule, everything should be welcoming for Mac users but 10x as simple. From 183367dbda993e644287137fc2be28afd8379997 Mon Sep 17 00:00:00 2001 From: probonopd Date: Thu, 21 Jan 2021 19:02:55 +0100 Subject: [PATCH 224/592] GTK_MODULES=appmenu-gtk-module Only if `GTK_MODULES=appmenu-gtk-module` is exported the menus in e.g. Audacity get shown in the global menu bar --- developer/menu.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/developer/menu.md b/developer/menu.md index be14cc7e..6f6c8d98 100644 --- a/developer/menu.md +++ b/developer/menu.md @@ -88,7 +88,7 @@ Desktop Environment, but it lives on as part of the Vala project. programs, converts to them MenuModel and send to them AppMenu (sometimes called a global menu bar). `unity-gtk-module` is used as a backend, and thus must also be installed * Status: active -* Issues: Supposedly used by Firefox and Chrome but those applications are not functional with Menu in helloSystem yet. Upstream documentation [advises](https://github.com/rilian-la-te/vala-panel-appmenu#post-build-instructions) "Install `libdbusmenu-glib libdbusmenu-gtk3 libdbusmenu-gtk2` to get Chromium/Google Chrome to work" +* Issues: Only if `GTK_MODULES=appmenu-gtk-module` is exported the menus in e.g. Audacity get shown in the global menu bar. Supposedly used by Firefox and Chrome but those applications are not functional with Menu in helloSystem yet. Upstream documentation [advises](https://github.com/rilian-la-te/vala-panel-appmenu#post-build-instructions) "Install `libdbusmenu-glib libdbusmenu-gtk3 libdbusmenu-gtk2` to get Chromium/Google Chrome to work" * Installed by package: `appmenu-gtk-module` ### unity-gtk-module From 572c8808632bac0ebb4030ead2bd7b24a23be47c Mon Sep 17 00:00:00 2001 From: probonopd Date: Thu, 21 Jan 2021 19:24:07 +0100 Subject: [PATCH 225/592] Update sharing.md --- user/components/preferences/sharing.md | 17 +++++++---------- 1 file changed, 7 insertions(+), 10 deletions(-) diff --git a/user/components/preferences/sharing.md b/user/components/preferences/sharing.md index d38ba407..1fabaa77 100644 --- a/user/components/preferences/sharing.md +++ b/user/components/preferences/sharing.md @@ -20,16 +20,13 @@ Check the __Screen Sharing__ checkbox to make the screen of your computer access ## Accessing the screen of a remote computer that has Screen Sharing enabled -If Screen Sharing is active on the remote computer, then you can connect over the local area network as follows: - -* Install the `ssvnc` package -* On the command line, type `ssvnc-gui` and press Enter -* Click "Find" -* Select the computer you want to connect to from the list -* Add `user@` before the hostname. Replace `user` with your username on the remote computer -* Click "Use SSH" -* Click "Connect" -* When promted, enter the password of your computer account on the remote computer +If Screen Sharing is active on the remote computer, then you can use [SSVNC](http://www.karlrunge.com/x11vnc/ssvnc.html) (available for Windows, Mac OS X, and various Unix-like systems) to access the machine over the local area network. + +In SSVNC please do: +* Under "VNC Host_Display" please enter: :0 +* Options... -> Check the "Use SSH" box and the "Unix Username & Password" box +* Under "Unix Username" enter the username you have set when you installed helloSystem +* Under "Unix Password" enter the password you have set when you installed helloSystem ## Accessing the screen of a remote computer that has Remote Login enabled From e19a4c30835099453173a8f6dcab3f8adea8aa72 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 24 Jan 2021 00:02:00 +0100 Subject: [PATCH 226/592] Update shortcuts.md --- user/components/preferences/shortcuts.md | 19 ++++++++++++++++--- 1 file changed, 16 insertions(+), 3 deletions(-) diff --git a/user/components/preferences/shortcuts.md b/user/components/preferences/shortcuts.md index 47854f33..96f9a003 100644 --- a/user/components/preferences/shortcuts.md +++ b/user/components/preferences/shortcuts.md @@ -13,15 +13,28 @@ A __shortcut__ is a key or key combination you can press to invoke a defined act The Shortcut Keys preferences application lets you view and edit system-wide keyboard shortcuts only, not per-application shortcuts. Some applications contain similar functionality inside the respective application to view and edit per-application keyboard shortcuts. ``` +## The ⌘ key + +The ⌘ key, also known as Command, is the key left to the spacebar on helloSystem, unless you have configured your system differently. + +``` .. note:: + The software may refer to the Comand key as "Ctrl". This is a known cosmetic issue. +``` + ## Default shortcuts Open the __Shortcut Keys__ preferences application to view the default system-wide shortcuts. Notable default shortcuts include: -* Press __Alt+Space__ to __search in the Menu__ (e.g., to launch applications or to execute commands in the frontmost application) -* Press __Ctrl+Alt+Esc__ and click on an application window to __forcefully quit an application__ that is malfunctioning -* Press __Alt+Shift+3__ or the __PrtScn__ key on your keyboard to __take a screenshot__ +* Press __⌘+Space__ to __search in the Menu__ (e.g., to launch applications or to execute commands in the frontmost application) +* Press __Ctrl+⌘+Esc__ and click on an application window to __forcefully quit an application__ that is malfunctioning +* Press __⌘+Shift+3__ or the __PrtScn__ key on your keyboard to __take a screenshot__ +* Press __Ctrl-⌘-H__ to go to the Home folder +* Press __Ctrl-⌘-A__ to go to the Applications folder +* Press __Ctrl-⌘-A__ to go to the Utilities folder +* Press __Ctrl-⌘-T__ to go open a terminal +* Press __Ctrl-⌘-I__ to open the internet browser This list is not exhaustive. From 14288c38f3b4e5854fa4538af1233b63af2096ff Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 24 Jan 2021 00:14:29 +0100 Subject: [PATCH 227/592] Update acknowledgements.md --- developer/acknowledgements.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/developer/acknowledgements.md b/developer/acknowledgements.md index 225ce04b..c52dc243 100644 --- a/developer/acknowledgements.md +++ b/developer/acknowledgements.md @@ -23,6 +23,10 @@ __[pkgdemon](https://github.com/pkgdemon)__ malco2001 on irc.freenode.net (#FuryBSD) * Originally wrote the tools to create Live ISOs for FuryBSD +## Cirrus CI +[https://cirrus-ci.com/](https://cirrus-ci.com/) +* Providing continuous build infrastructure + ## FreeBSD Foundation [https://www.freebsdfoundation.org/](https://www.freebsdfoundation.org/) * Gave permission to use the trademarks in the 'Install FreeBSD' utility From f9ca735bf4b422be6edb3dcbbaea56c237f5475b Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 24 Jan 2021 12:12:46 +0100 Subject: [PATCH 228/592] Add note on capitalization --- user/components/system/launch.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/user/components/system/launch.md b/user/components/system/launch.md index 48f808b1..2a667d18 100644 --- a/user/components/system/launch.md +++ b/user/components/system/launch.md @@ -37,3 +37,8 @@ * `launch /Applications/Filer.app` * `launch Filer.app` * `launch Filer` + +Note that capitalization can have subtle effects: + +* `launch audacity` launches `audacity` from the `$PATH` if it exists anywhere on the `$PATH` +* `launch Audacity` launches e.g., `/Applications/Audio/Audacity.app/Audacity` if it exists there or in other well-known application locations (because no `Audacity` exists anywhere on the `$PATH`) From d38877be0c9c29423341f07b7d0c7acb6eb9b4f2 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 24 Jan 2021 12:54:19 +0100 Subject: [PATCH 229/592] UBUNTU_MENUPROXY --- developer/menu.md | 27 +++++++++++++++++++++++++++ 1 file changed, 27 insertions(+) diff --git a/developer/menu.md b/developer/menu.md index 6f6c8d98..11644b73 100644 --- a/developer/menu.md +++ b/developer/menu.md @@ -223,6 +223,33 @@ information to be displayed to users of the application through the interface sh * Issues: tbd * Installed by package: `tbd` +## Environment variables involved + +### GTK_MODULES=appmenu-gtk-module + +Only if `GTK_MODULES=appmenu-gtk-module` is exported the menus in e.g. Audacity get shown in the global menu bar. + +### UBUNTU_MENUPROXY + +As of 2021, the (undocumented?) `UBUNTU_MENUPROXY` environment variable is referenced in + +``` +/usr/local/lib/libwx_gtk3u_core-3.1.so.4.0.0 +/usr/local/lib/gtk-3.0/modules/libappmenu-gtk-module.so +/usr/local/lib/gtk-2.0/modules/libappmenu-gtk-module.so +``` + +Audacity is an example for an application that uses `libwx_gtk3u_core-3.1.so.4`. + +* Apparently `UBUNTU_MENUPROXY` __must not__ be set to `0` or `` e.g., for Audacity to work +* Apparently unsetting it still makes the global menu work for Audacity +* Apparently setting it to a random value still makes the global menu work for Audacity +* According to [this](https://github.com/electron/electron/issues/709#issuecomment-59207492), `UBUNTU_MENUPROXY` should be set to `libappmenu.so`? + +``` .. note:: + Please consider submitting issues and pull requests if you know how UBUNTU_MENUPROXY is supposed to work. Is it documented? +``` + ## Executables involved _To be written._ From f251ee3921478ed43dc0b0912238ad7f50aa5d7d Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 24 Jan 2021 13:00:24 +0100 Subject: [PATCH 230/592] libwx_gtk3u_core --- developer/menu.md | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/developer/menu.md b/developer/menu.md index 11644b73..b1c06126 100644 --- a/developer/menu.md +++ b/developer/menu.md @@ -223,6 +223,23 @@ information to be displayed to users of the application through the interface sh * Issues: tbd * Installed by package: `tbd` +### wxGtk libwx_gtk3u_core + +``` +/usr/local/lib/libwx_gtk3u_core-3.1.so +/usr/local/lib/libwx_gtk3u_core-3.1.so.4 +/usr/local/lib/libwx_gtk3u_core-3.1.so.4.0.0 +``` + +* Author: wxWidgets authors +* Description: wxWidgets is a C++ library that lets developers create applications for Windows, Mac OS X, Linux and other platforms with a single code base. On FreeBSD the Gtk toolkit is used +* Bugtracker: https://www.wxwidgets.org/ +* Purpose: tbd +* Theory of operation: tbd +* Status: active +* Issues: Requires the (undocumented?) `UBUNTU_MENUPROXY` environment variable not to be set to `0` or `` +* Installed by package: `wx31-gtk3` + ## Environment variables involved ### GTK_MODULES=appmenu-gtk-module From 807196d769c765aa5c31ca51824af0431f630579 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 24 Jan 2021 13:01:42 +0100 Subject: [PATCH 231/592] Clarify wxWidgets --- developer/menu.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/developer/menu.md b/developer/menu.md index b1c06126..65972c05 100644 --- a/developer/menu.md +++ b/developer/menu.md @@ -235,7 +235,7 @@ information to be displayed to users of the application through the interface sh * Description: wxWidgets is a C++ library that lets developers create applications for Windows, Mac OS X, Linux and other platforms with a single code base. On FreeBSD the Gtk toolkit is used * Bugtracker: https://www.wxwidgets.org/ * Purpose: tbd -* Theory of operation: tbd +* Theory of operation: Applications written with wxWidgets (e.g., Audacity) use this to display their UI with Gtk on FreeBSD * Status: active * Issues: Requires the (undocumented?) `UBUNTU_MENUPROXY` environment variable not to be set to `0` or `` * Installed by package: `wx31-gtk3` From 28879d082c27f9fc5b953071be84611637c56347 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 24 Jan 2021 13:06:55 +0100 Subject: [PATCH 232/592] Ultimaker Cura --- developer/menu.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/developer/menu.md b/developer/menu.md index 65972c05..464d95d9 100644 --- a/developer/menu.md +++ b/developer/menu.md @@ -267,6 +267,15 @@ Audacity is an example for an application that uses `libwx_gtk3u_core-3.1.so.4`. Please consider submitting issues and pull requests if you know how UBUNTU_MENUPROXY is supposed to work. Is it documented? ``` +Ultimaker Cura (which does not have a working global menu integration by default) contains a note in `/usr/local/lib/python3.7/site-packages/UM/Application.py` saying + +``` +# For Ubuntu Unity this makes Qt use its own menu bar rather than pass it on to Unity. +os.putenv("UBUNTU_MENUPROXY", "0") +``` + +Changing this to `"1"` does not make any difference for Cura, though. + ## Executables involved _To be written._ From 9dc2396526e44f765b510e400902141f74c769d5 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 25 Jan 2021 19:49:36 +0100 Subject: [PATCH 233/592] Create tracing.md --- developer/tracing.md | 35 +++++++++++++++++++++++++++++++++++ 1 file changed, 35 insertions(+) create mode 100644 developer/tracing.md diff --git a/developer/tracing.md b/developer/tracing.md new file mode 100644 index 00000000..b42b8a0e --- /dev/null +++ b/developer/tracing.md @@ -0,0 +1,35 @@ +# Tracing with DTrace/dtruss + +The `dtruss` command line tool can be used to examine what a running process is doing. Other than, e.g., `strace` on Linux, `dtruss` can be used to watch already-running processes. This makes it more suitable to watch processes that have been launched by, e.g., the `launch` command. + +``` +sudo pkg install dtrace-toolkit +sudo kldload dtraceall +launch FeatherPad +# In another terminal: ps ax | grep featherpad +# Then use the PID of the featherpad process for the next command: +sudo dtruss -p 1886 -f +``` + + +``` .. note:: + If you get `probe description syscall:::entry does not match any probes`, then possibly you loaded `kldload dtrace` rather than `kldload dtraceall`. +``` + +The [FreeBSD DTrace Tutorial](https://wiki.freebsd.org/DTrace/Tutorial) has many one-liner examples for tasks like observing +* File Opens +* Syscall Counts By Process +* Distribution of read() Bytes +* Timing read() Syscall +* Measuring CPU Time in read() +* Count Process-Level Events +* Profile On-CPU Kernel Stacks +* Scheduler Tracing +* TCP Inbound Connections +* Raw Kernel Tracing + +There is also a full list of [DTrace One-Liners](https://wiki.freebsd.org/DTrace/One-Liners) to pick up more DTrace functionality. + +``` .. note:: + In the future a graphical utility might be written to automate common tracing tasks. +``` From 212d9ff8da6fe5eab0fb67bf028cf2172003dc63 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 25 Jan 2021 19:50:22 +0100 Subject: [PATCH 234/592] Add DTrace --- index.md | 1 + 1 file changed, 1 insertion(+) diff --git a/index.md b/index.md index 3c2af1ed..cd1bb666 100644 --- a/index.md +++ b/index.md @@ -42,6 +42,7 @@ __hello__ (also known as __helloSystem__) is a desktop system for creators with developer/specifications developer/contributing developer/building + developer/tracing developer/distributions developer/acknowledgements developer/contact From 11a8cae06ddbf6ba5a25e07e252561d527bd1691 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 25 Jan 2021 20:18:50 +0100 Subject: [PATCH 235/592] Create ux-guidelines.md --- developer/ux-guidelines.md | 29 +++++++++++++++++++++++++++++ 1 file changed, 29 insertions(+) create mode 100644 developer/ux-guidelines.md diff --git a/developer/ux-guidelines.md b/developer/ux-guidelines.md new file mode 100644 index 00000000..42c7ac58 --- /dev/null +++ b/developer/ux-guidelines.md @@ -0,0 +1,29 @@ +# User Experience Guidelines + +Since helloSystem is intended to be friedndly and welcoming to switchers from the Mac, let's apply some of the underlying concepts and design considerations that went into the Mac. We are not aiming to create a 1:1 replica, but something that is generally consistent with the underlying general user experience (UX) philosophy, which has been openly documented. + +## Macintosh Human Interface Guidelines + +What are the design principles that make user interfaces "Mac-like"? Apple spelled them out for us publicly 30 years ago in a book, the Macintosh Human Interface Guidelines: + +> If you are a designer, a human interface professional, or an engineer, this book contains information you can use to design and create products that fit the Macintosh model. It provides background information that can help you plan and make decisions about your product design. __Even if you don’t design and develop products for the Macintosh, reading this book will help you to understand the Macintosh interface.__ + +Source: Apple Computer, Inc., 1992, Macintosh Human Interface Guidelines, First Printing, November 1992. Addison-Wesley Publishing Company. ISBN 0-201-62216-5 + +## Global menu bar + +Referred to in the Macintosh Human Interface Guidelines with highest praise: + +> A seminal paper on why pull-down menus are superior to any other kind. +> Everyone who designs for the screen must read this paper. Everyone who designs for the screen must read this paper. + +This article provides empirical evidence on the superiority of global menus. + +> Systems that maximize the percentage of menu items with borders will have a decided +advantage over other menu systems. +> +> In this experiment the initial movement to the pull-down menus was larger that +average distance required to reach the top of a 19 inch diagonal screen, yet the p&downs still significantly outperformed the walking menus. Therefore, it may be +more efficient to place menus at the top of the window + +Source: Walker, N & Smelcer, JB 1990, A comparison of selection times from walking and pull-down menus. in JC Chew & J Whiteside (eds), Proceedings of the SIGCHI Conference on Human Factors in Computing Systems, CHI 1990. Association for Computing Machinery, pp. 221-225, 1990 SIGCHI Conference on Human Factors in Computing Systems, CHI 1990, Seattle, United States, 4/1/90. https://dl.acm.org/doi/pdf/10.1145/97243.97277 From 1b6929d6a562ec313dd03e5bd40643906be7e883 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 25 Jan 2021 20:20:32 +0100 Subject: [PATCH 236/592] Update ux-guidelines.md --- developer/ux-guidelines.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/developer/ux-guidelines.md b/developer/ux-guidelines.md index 42c7ac58..8241fc0e 100644 --- a/developer/ux-guidelines.md +++ b/developer/ux-guidelines.md @@ -10,14 +10,14 @@ What are the design principles that make user interfaces "Mac-like"? Apple spell Source: Apple Computer, Inc., 1992, Macintosh Human Interface Guidelines, First Printing, November 1992. Addison-Wesley Publishing Company. ISBN 0-201-62216-5 -## Global menu bar +## Walker, N & Smelcer, 1990 (Superiority of the global menu bar) Referred to in the Macintosh Human Interface Guidelines with highest praise: > A seminal paper on why pull-down menus are superior to any other kind. > Everyone who designs for the screen must read this paper. Everyone who designs for the screen must read this paper. -This article provides empirical evidence on the superiority of global menus. +This paper provides empirical evidence on the superiority of global menus. > Systems that maximize the percentage of menu items with borders will have a decided advantage over other menu systems. From 0ffd22efb7793a9df2fc4b379bb21c60ff43c5d7 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 25 Jan 2021 20:21:48 +0100 Subject: [PATCH 237/592] Update ux-guidelines.md --- developer/ux-guidelines.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/developer/ux-guidelines.md b/developer/ux-guidelines.md index 8241fc0e..905c00d8 100644 --- a/developer/ux-guidelines.md +++ b/developer/ux-guidelines.md @@ -4,7 +4,7 @@ Since helloSystem is intended to be friedndly and welcoming to switchers from th ## Macintosh Human Interface Guidelines -What are the design principles that make user interfaces "Mac-like"? Apple spelled them out for us publicly 30 years ago in a book, the Macintosh Human Interface Guidelines: +What are the design principles that make user interfaces "Mac-like"? Apple spelled them out for us publicly 30 years ago in a book, the Macintosh Human Interface Guidelines. Besides descrbing what makes user interfaces "Mac-like", the book also explains general concepts like how to perform user testing. > If you are a designer, a human interface professional, or an engineer, this book contains information you can use to design and create products that fit the Macintosh model. It provides background information that can help you plan and make decisions about your product design. __Even if you don’t design and develop products for the Macintosh, reading this book will help you to understand the Macintosh interface.__ From 6dac47063c5854a07ed3dcef44e7ce0f7ee9d6f4 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 25 Jan 2021 20:22:27 +0100 Subject: [PATCH 238/592] Update index.md --- index.md | 1 + 1 file changed, 1 insertion(+) diff --git a/index.md b/index.md index cd1bb666..b1f7d46d 100644 --- a/index.md +++ b/index.md @@ -32,6 +32,7 @@ __hello__ (also known as __helloSystem__) is a desktop system for creators with :maxdepth: 2 :glob: + developer/ux-guidelines developer/architecture developer/boot developer/graphics From a955d9ec162e75d8ccec7d0d0a8a8878c07815f9 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 25 Jan 2021 20:25:32 +0100 Subject: [PATCH 239/592] Update ux-guidelines.md --- developer/ux-guidelines.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/developer/ux-guidelines.md b/developer/ux-guidelines.md index 905c00d8..abe67ee1 100644 --- a/developer/ux-guidelines.md +++ b/developer/ux-guidelines.md @@ -1,6 +1,6 @@ # User Experience Guidelines -Since helloSystem is intended to be friedndly and welcoming to switchers from the Mac, let's apply some of the underlying concepts and design considerations that went into the Mac. We are not aiming to create a 1:1 replica, but something that is generally consistent with the underlying general user experience (UX) philosophy, which has been openly documented. +Since helloSystem is intended to be friendly and welcoming to switchers from the Mac, it is important to understand the underlying concepts and design considerations that went into the Mac. We are not aiming to create a 1:1 replica, but something that is generally consistent with the underlying general user experience (UX) philosophy, which has been openly documented. ## Macintosh Human Interface Guidelines From a2bf1263582f05a487ab6edc6980947b22e79704 Mon Sep 17 00:00:00 2001 From: probonopd Date: Thu, 28 Jan 2021 19:00:57 +0100 Subject: [PATCH 240/592] Update applications.md --- developer/applications.md | 38 ++++++++++++++++++++++++++++++++++++++ 1 file changed, 38 insertions(+) diff --git a/developer/applications.md b/developer/applications.md index a60f11e9..5cd6aae1 100644 --- a/developer/applications.md +++ b/developer/applications.md @@ -14,3 +14,41 @@ Please see [https://github.com/learnpyqt/15-minute-apps](https://github.com/lear For an introduction to [Creating GUI applications with Python & Qt5](https://www.learnpyqt.com/pyqt5-book/) you may be interested in the book with the same name by Martin Fitzpatrick. There is also a forum at [forum.learnpyqt.com](https://forum.learnpyqt.com/). [![](https://hellosystem.github.io/docs/_static/book-pyqt5.png)](https://www.learnpyqt.com/pyqt5-book/) + +## Using .ui files in PyQt + +Using Qt Creator, you can also create and edit graphical user inferfaces for __Python__ based applications using `.ui` files. These can be used in PyQt like this: + +``` +#!/usr/bin/env python3 +# This Python file uses the following encoding: utf-8 + + +import sys +import os + + +from PyQt5.QtWidgets import QApplication, QWidget +from PyQt5.QtCore import QFile +from PyQt5.uic import loadUi + + +class Widget(QWidget): + def __init__(self): + super(Disks, self).__init__() + self.load_ui() + + def load_ui(self): + path = os.path.join(os.path.dirname(__file__), "form.ui") + ui_file = QFile(path) + ui_file.open(QFile.ReadOnly) + loadUi(ui_file, self) + ui_file.close() + + +if __name__ == "__main__": + app = QApplication([]) + widget = Widget() + widget.show() + sys.exit(app.exec_()) +``` From a8a0ce1143d2c4145af16222feea0afda5e19c70 Mon Sep 17 00:00:00 2001 From: Laerte Pereira <5853172+Laerte@users.noreply.github.com> Date: Wed, 10 Feb 2021 15:42:37 -0300 Subject: [PATCH 241/592] add module to render markdown tables (#12) * add module to render markdown tables * add sphinx-markdown-tables module to sh --- buildDocs.sh | 2 +- conf.py | 4 +++- requirements.txt | 1 + 3 files changed, 5 insertions(+), 2 deletions(-) diff --git a/buildDocs.sh b/buildDocs.sh index 1f5e3289..85a30c44 100644 --- a/buildDocs.sh +++ b/buildDocs.sh @@ -20,7 +20,7 @@ set -x apt-get update apt-get -y install git rsync python3-pip qttools5-dev-tools qt5-default qt5-qmake pip3 install setuptools wheel -pip3 install sphinx sphinx-autobuild sphinx-rtd-theme commonmark recommonmark sphinxcontrib-qthelp +pip3 install sphinx sphinx-autobuild sphinx-rtd-theme commonmark recommonmark sphinxcontrib-qthelp sphinx-markdown-tables ##################### # DECLARE VARIABLES # diff --git a/conf.py b/conf.py index 6071267c..ce40455d 100644 --- a/conf.py +++ b/conf.py @@ -38,7 +38,8 @@ extensions = [ # Auto-generate section labels. 'sphinx.ext.autosectionlabel', - 'recommonmark' + 'recommonmark', + 'sphinx_markdown_tables' ] master_doc = 'index' @@ -89,6 +90,7 @@ github_doc_root = 'https://' + GITHUB_REPO_OWNER + '.github.io/' + GITHUB_REPO_NAME + '/' + def setup(app): app.add_config_value( 'recommonmark_config', diff --git a/requirements.txt b/requirements.txt index 91898449..0225a94b 100644 --- a/requirements.txt +++ b/requirements.txt @@ -9,3 +9,4 @@ sphinxext-rediraffe sphinx-last-updated-by-git recommonmark sphinxcontrib-qthelp +sphinx-markdown-tables From 738046311a2290ab6c3b140a64aba5e128d80529 Mon Sep 17 00:00:00 2001 From: probonopd Date: Wed, 10 Feb 2021 22:36:13 +0100 Subject: [PATCH 242/592] Add screenshot due to popular requests --- index.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/index.md b/index.md index b1f7d46d..a7af8a97 100644 --- a/index.md +++ b/index.md @@ -12,6 +12,8 @@ __hello__ (also known as __helloSystem__) is a desktop system for creators with focus on simplicity, elegance, and usability. Its design follows the "Less, but better" philosophy. It is intended as a system for "mere mortals", welcoming to switchers from the Mac. [FreeBSD](https://www.freebsd.org/) is used as the core operating system. Please refer to [https://github.com/helloSystem/hello](https://github.com/helloSystem/hello) if you would like to learn more about the ideas and principles behind hello. +![Screenshot](https://github.com/helloSystem/hello/blob/master/screenshots/20210210-desktop-0.4.png?raw=true) + ```eval_rst .. toctree:: :maxdepth: 3 From 249e718b5c973f19ad29b2ded3a3776f70741be7 Mon Sep 17 00:00:00 2001 From: probonopd Date: Thu, 11 Feb 2021 18:54:30 +0100 Subject: [PATCH 243/592] Update architecture.md --- developer/architecture.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/developer/architecture.md b/developer/architecture.md index e358e8ad..339dcb33 100644 --- a/developer/architecture.md +++ b/developer/architecture.md @@ -1,6 +1,6 @@ # Architecture -helloSystem is designed with simplicity in mind. Less, but better. This page describes key elements of the hello desktop. As a general rule, everything should be welcoming for Mac users but 10x as simple. +helloSystem is designed with simplicity in mind. Less, but better. This page describes key elements of the hello desktop. To begin with, everything should be welcoming for Mac users but 10x as simple. ## Frameworks From 78dc1ba4f54152717868d357eafddaddc21fc401 Mon Sep 17 00:00:00 2001 From: probonopd Date: Thu, 11 Feb 2021 20:15:40 +0100 Subject: [PATCH 244/592] Remove outdated screenshot --- user/getting-started.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/user/getting-started.md b/user/getting-started.md index faf34cc5..077d6548 100644 --- a/user/getting-started.md +++ b/user/getting-started.md @@ -24,8 +24,6 @@ hello is known to boot to a graphical desktop on the following machines. Auxilia ### Tested virtualization environments -![helloSystem on VirtualBox in BIOS EFI mode](https://user-images.githubusercontent.com/2480569/101068320-dc2a6880-3598-11eb-9304-28655c8f17a5.png) - * VirtualBox host (on FreeBSD and on macOS), known to work in BIOS and EFI mode * VMware host (on Windows), possibly only working in BIOS mode? From ff40c7bce5cc142d1ac2aecb89fdbb13048db7a6 Mon Sep 17 00:00:00 2001 From: Graham Perrin Date: Fri, 12 Feb 2021 14:59:47 -0500 Subject: [PATCH 245/592] Troubleshooting (users, not developers): update (#13) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Cease directing users of helloSystem to a FuryBSD area. Deduplicate contact information. Typo (grahpics). Help users to gain a mute-free view of boot misbehaviours. Avoid the phrase *Known issues*. Maintaining a meaningful shortlist of truly known issues is a maintenance burden, and can be contentious. Direct readers to perform organisation-wide searches for issues. Terminology: use the phrase that's used by GitHub – *issues*, not *bugs*. --- user/troubleshooting.md | 33 ++++++++++++++++++++++++++------- 1 file changed, 26 insertions(+), 7 deletions(-) diff --git a/user/troubleshooting.md b/user/troubleshooting.md index a7d675a6..7ce6cb11 100644 --- a/user/troubleshooting.md +++ b/user/troubleshooting.md @@ -1,14 +1,33 @@ # Troubleshooting -## Known issues +## Notable issues -* __Boot stalls during `Replicate system image to swap-based memdisk`__: This build of the ISO is damaged. Please wait for another continuous build to appear and try again. -* __Boots to a non-graphical `login:` prompt__: Your grahpics hardware was not detected properly. Please try on another machine. +### FreeBSD logo on screen for more than five minutes -## Getting help +Something might be wrong, but relevant information is *muted* by the logo. You will probably need to stop the computer. If normal use of the power button is not effective, press and hold. + +If – after five minutes – you're reluctant to stop the computer, you can occasionally [key Ctrl-T](https://hellosystem.github.io/docs/developer/boot.html#seeing-what-the-system-is-doing-while-the-graphical-boot-screen-is-shown) to reveal isolated snippets of information. If there's no change from one snippet to the next, across three or more snippets, you may reasonably assume that a stop will be required. + +For a more useful view of relevant information: + +* after stopping the computer, you can [temporarily stop the muting and boot (start) the computer in verbose mode](https://hellosystem.github.io/docs/developer/boot.html#boot-in-verbose-mode). + +### Boot stalls during `Replicate system image to swap-based memdisk`(seen during verbose boot) + +This affects some computers with some builds of the ISO. If you encounter this issue with your computer, please await the next ISO or try with a different computer. -Developers chat at `#FuryBSD` on `irc.freenode.net`. Since we are working in different timezones, do not expect immediate answers. It is best to stay connected for at least a couple of days or so. +### `login:` prompt, no desktop environment -## Reporting bugs +Some graphics hardware is not yet, or not easily, usable with helloSystem. Try with a different computer, or seek help. + +## Other issues + +Use the *Search or jump to…* field at the head of the main [https://github.com/helloSystem/](https://github.com/helloSystem/) page – above the helloSystem logo. This special page allows an organisation-wide search, across all helloSystem repositories. Click in the field, then begin typing. + +If your issue is not already reported, you can create a new one. + +Frequently updated areas include [ISO issues](https://github.com/helloSystem/ISO/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc). + +## Getting help -Please search [https://github.com/helloSystem/ISO/issues](https://github.com/helloSystem/ISO/issues) for known issues. Feel free to add to existing issues or to open new issues there. +Please [contact us](https://hellosystem.github.io/docs/developer/contact.html). From 460fd5b41912e8a4a5f68b98f23098cdc96e1f7a Mon Sep 17 00:00:00 2001 From: probonopd Date: Fri, 12 Feb 2021 21:06:34 +0100 Subject: [PATCH 246/592] Simplify a bit --- user/troubleshooting.md | 14 ++++++-------- 1 file changed, 6 insertions(+), 8 deletions(-) diff --git a/user/troubleshooting.md b/user/troubleshooting.md index 7ce6cb11..0f187a12 100644 --- a/user/troubleshooting.md +++ b/user/troubleshooting.md @@ -4,13 +4,12 @@ ### FreeBSD logo on screen for more than five minutes -Something might be wrong, but relevant information is *muted* by the logo. You will probably need to stop the computer. If normal use of the power button is not effective, press and hold. +It can take up to five minutes to start the system in Live mode. If you see the FreeBSD logo on screen for more than five minutes, then something might be wrong any you might need to restart the computer. -If – after five minutes – you're reluctant to stop the computer, you can occasionally [key Ctrl-T](https://hellosystem.github.io/docs/developer/boot.html#seeing-what-the-system-is-doing-while-the-graphical-boot-screen-is-shown) to reveal isolated snippets of information. If there's no change from one snippet to the next, across three or more snippets, you may reasonably assume that a stop will be required. +If – after five minutes – you're reluctant to stop the computer, you can occasionally [key Ctrl-T](https://hellosystem.github.io/docs/developer/boot.html#seeing-what-the-system-is-doing-while-the-graphical-boot-screen-is-shown) to get some information about what the computer is doing. If there is no change from one snippet to the next, across three or more snippets, you may reasonably assume that the computer needs to be restarted. -For a more useful view of relevant information: - -* after stopping the computer, you can [temporarily stop the muting and boot (start) the computer in verbose mode](https://hellosystem.github.io/docs/developer/boot.html#boot-in-verbose-mode). +* Please restart the computer. If normal use of the power button is not effective, press and hold. +* Then, please [start the computer in verbose mode](https://hellosystem.github.io/docs/developer/boot.html#boot-in-verbose-mode) to see any relevant error messages that may help in resolving the issue. ### Boot stalls during `Replicate system image to swap-based memdisk`(seen during verbose boot) @@ -18,7 +17,8 @@ This affects some computers with some builds of the ISO. If you encounter this i ### `login:` prompt, no desktop environment -Some graphics hardware is not yet, or not easily, usable with helloSystem. Try with a different computer, or seek help. +* Please make sure that your computer has at least 4GB of RAM. helloSystem currently needs at least this amount to be started in Live mode. +* The graphics hardware in your computer may not yet, or not yet easily, be usable with helloSystem. Try with a different computer, or seek help. ## Other issues @@ -26,8 +26,6 @@ Use the *Search or jump to…* field at the head of the main [https://github.com If your issue is not already reported, you can create a new one. -Frequently updated areas include [ISO issues](https://github.com/helloSystem/ISO/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc). - ## Getting help Please [contact us](https://hellosystem.github.io/docs/developer/contact.html). From 365a6607cd142f547cb08ab193dd43075ce76685 Mon Sep 17 00:00:00 2001 From: probonopd Date: Fri, 12 Feb 2021 21:20:44 +0100 Subject: [PATCH 247/592] Fix typo --- user/troubleshooting.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/user/troubleshooting.md b/user/troubleshooting.md index 0f187a12..f351ddce 100644 --- a/user/troubleshooting.md +++ b/user/troubleshooting.md @@ -4,7 +4,7 @@ ### FreeBSD logo on screen for more than five minutes -It can take up to five minutes to start the system in Live mode. If you see the FreeBSD logo on screen for more than five minutes, then something might be wrong any you might need to restart the computer. +It can take up to five minutes to start the system in Live mode. If you see the FreeBSD logo on screen for more than five minutes, then something might be wrong and you might need to restart the computer. If – after five minutes – you're reluctant to stop the computer, you can occasionally [key Ctrl-T](https://hellosystem.github.io/docs/developer/boot.html#seeing-what-the-system-is-doing-while-the-graphical-boot-screen-is-shown) to get some information about what the computer is doing. If there is no change from one snippet to the next, across three or more snippets, you may reasonably assume that the computer needs to be restarted. From 28567addbc6881c1e736ab09bafedc1493d6dab8 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 13 Feb 2021 16:08:06 +0100 Subject: [PATCH 248/592] Add PreyK --- developer/acknowledgements.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/developer/acknowledgements.md b/developer/acknowledgements.md index c52dc243..5deca1ef 100644 --- a/developer/acknowledgements.md +++ b/developer/acknowledgements.md @@ -77,3 +77,7 @@ __[mrclksr](https://github.com/mrclksr)__ ## Graham Perrin __[grahamperrin](https://github.com/grahamperrin)__ * Provided early testing and feedback + +## PreyK +__[PreyK](https://github.com/PreyK)__ +* Allowed the System menu to be dynamically rebuilt and provided fix to Zeroconf utility From 2f914ef2c8ea0c9abccbbfcf4f4171b0eab6d16f Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 13 Feb 2021 16:20:20 +0100 Subject: [PATCH 249/592] Easier wording --- developer/acknowledgements.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/developer/acknowledgements.md b/developer/acknowledgements.md index 5deca1ef..0fe89949 100644 --- a/developer/acknowledgements.md +++ b/developer/acknowledgements.md @@ -80,4 +80,4 @@ __[grahamperrin](https://github.com/grahamperrin)__ ## PreyK __[PreyK](https://github.com/PreyK)__ -* Allowed the System menu to be dynamically rebuilt and provided fix to Zeroconf utility +* Made System menu to refresh itself automatically and provided fix to Zeroconf utility From 8c91a93055e987d72734dba3ce1af1d8397b9fd8 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 13 Feb 2021 19:47:45 +0100 Subject: [PATCH 250/592] Create internationalization.md --- developer/internationalization.md | 5 +++++ 1 file changed, 5 insertions(+) create mode 100644 developer/internationalization.md diff --git a/developer/internationalization.md b/developer/internationalization.md new file mode 100644 index 00000000..2b535914 --- /dev/null +++ b/developer/internationalization.md @@ -0,0 +1,5 @@ +# Internationalization + +helloSystem is localized at https://hosted.weblate.org/projects/hellosystem/. + +Futher details will be added here. From 752176ad8e320e072d9ff7cbbca490a5f8d31ec1 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 13 Feb 2021 19:48:06 +0100 Subject: [PATCH 251/592] Update and rename internationalization.md to localization.md --- developer/{internationalization.md => localization.md} | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) rename developer/{internationalization.md => localization.md} (83%) diff --git a/developer/internationalization.md b/developer/localization.md similarity index 83% rename from developer/internationalization.md rename to developer/localization.md index 2b535914..c8f8af21 100644 --- a/developer/internationalization.md +++ b/developer/localization.md @@ -1,4 +1,4 @@ -# Internationalization +# Localization helloSystem is localized at https://hosted.weblate.org/projects/hellosystem/. From df3335021c7804be11b391f8db20db8035e7dbdf Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 13 Feb 2021 19:48:44 +0100 Subject: [PATCH 252/592] Add Localization --- index.md | 1 + 1 file changed, 1 insertion(+) diff --git a/index.md b/index.md index a7af8a97..02103cc2 100644 --- a/index.md +++ b/index.md @@ -46,6 +46,7 @@ __hello__ (also known as __helloSystem__) is a desktop system for creators with developer/contributing developer/building developer/tracing + developer/localization developer/distributions developer/acknowledgements developer/contact From 916e4dc95ea2a19eb1c578278e2469931fd94443 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 14 Feb 2021 10:54:14 +0100 Subject: [PATCH 253/592] Update acknowledgements.md --- developer/acknowledgements.md | 1 + 1 file changed, 1 insertion(+) diff --git a/developer/acknowledgements.md b/developer/acknowledgements.md index 0fe89949..793ac09a 100644 --- a/developer/acknowledgements.md +++ b/developer/acknowledgements.md @@ -81,3 +81,4 @@ __[grahamperrin](https://github.com/grahamperrin)__ ## PreyK __[PreyK](https://github.com/PreyK)__ * Made System menu to refresh itself automatically and provided fix to Zeroconf utility +* Fixed Menu and desktop for multi-monitor setups From a907755d8e5da01968b66b3e8e905ef636fbe48e Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 14 Feb 2021 10:54:47 +0100 Subject: [PATCH 254/592] Update acknowledgements.md --- developer/acknowledgements.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/developer/acknowledgements.md b/developer/acknowledgements.md index 793ac09a..df3aa951 100644 --- a/developer/acknowledgements.md +++ b/developer/acknowledgements.md @@ -80,5 +80,5 @@ __[grahamperrin](https://github.com/grahamperrin)__ ## PreyK __[PreyK](https://github.com/PreyK)__ -* Made System menu to refresh itself automatically and provided fix to Zeroconf utility +* Made System menu to refresh itself automatically * Fixed Menu and desktop for multi-monitor setups From 00e64636abfabc0aec6fde96229c1e42d11c0c0b Mon Sep 17 00:00:00 2001 From: aki-k Date: Sun, 14 Feb 2021 13:00:53 +0200 Subject: [PATCH 255/592] Update getting-started.md (#14) Added Qemu notes --- user/getting-started.md | 42 ++++++++++++++++++++++++++++++++++++++++- 1 file changed, 41 insertions(+), 1 deletion(-) diff --git a/user/getting-started.md b/user/getting-started.md index 077d6548..606107a1 100644 --- a/user/getting-started.md +++ b/user/getting-started.md @@ -25,9 +25,49 @@ hello is known to boot to a graphical desktop on the following machines. Auxilia ### Tested virtualization environments * VirtualBox host (on FreeBSD and on macOS), known to work in BIOS and EFI mode + * VMware host (on Windows), possibly only working in BIOS mode? -Pleaase note: +* Qemu VM, works in both BIOS and EFI modes + +You can boot and install hello in a Qemu VM. First create a disk image for it with fallocate: +``` +$ pwd +/home/user +$ mkdir -p .qemu/hello +$ fallocate -l $(( 24*1024*1024*1024 )) .qemu/hello/hello.img +``` +This creates a 24 GiB hello.img file where you'll install the system. + +To boot the hello ISO image, use the following qemu-system-x86_64 command: +``` +qemu-system-x86_64 -machine type=q35,accel=kvm \ +-enable-kvm -cpu host -smp 2 -m 4096 \ +-device virtio-net,netdev=vmnic -netdev user,id=vmnic,hostfwd=tcp::5222-:22 \ +-vga std -soundhw hda -no-quit \ +-drive format=raw,file=${HOME}/.qemu/hello/hello.img \ +-drive format=raw,file=${HOME}/Downloads/hello-0.4.0_0D26-FreeBSD-12.1-amd64.iso \ +-boot menu=on +``` +When the Qemu VM starts, press esc and select 2 to boot the iso. + +After you've installed hello on the disk image, you can remove the last two options from the above command. + +The hostfwd= option creates a port forward from your host port 5222 to the Qemu VM port 22. + +Unfortunately the qemu-system-x86_64 USB tablet options don't work with hello so you'll need to press Ctrl+Alt+g to release the mouse pointer from the Qemu VM window. + +If you want to make Qemu VM full screen, press Ctrl+Alt+f. + +To boot/install hello in UEFI mode, first install [OVMF Open Virtual Machine Firmware](https://github.com/tianocore/tianocore.github.io/wiki/OVMF) on your host side. The package name for Fedora 32 is edk2-ovmf. + +Then add these two qemu-system-x86_64 options for the Qemu VM start: +``` +-bios /usr/share/edk2/ovmf/OVMF_CODE.fd \ +-smbios type=0,vendor=0vendor,version=0version,date=0date,release=0.0,uefi=on \ +``` + +Please note: * The VM needs to be 64-bit * The VM needs at least 4 GB of RAM which is higher than the VirtualBox default From ea291c7ae45d4db17e34bb9fa1df507c25499407 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 14 Feb 2021 12:18:14 +0100 Subject: [PATCH 256/592] Update getting-started.md --- user/getting-started.md | 54 ++++++++++++++++++++++++++--------------- 1 file changed, 34 insertions(+), 20 deletions(-) diff --git a/user/getting-started.md b/user/getting-started.md index 606107a1..a6507506 100644 --- a/user/getting-started.md +++ b/user/getting-started.md @@ -19,27 +19,46 @@ Please refer to [FreeBSD Hardware Compatibility](https://www.freebsd.org/doc/en_ hello is known to boot to a graphical desktop on the following machines. Auxiliary functionality such as wireless networking, sound over HDMI, sleep, graphics acceleration, etc. has not yet been tested systematically. +helloSystem developers currently have access to the following hardware: + * Acer Revo RL85 * Dell Inc. OptiPlex 780 -### Tested virtualization environments +Please contact us if you would like to sponsor the project with a hardware donation. We are especially looking for Apple and Lenovo devices from the previous generations that should be available second-hand inexpensively. + +### Virtualization environments + +Users have reported success in running helloSystem in the following virtualization environments: * VirtualBox host (on FreeBSD and on macOS), known to work in BIOS and EFI mode * VMware host (on Windows), possibly only working in BIOS mode? -* Qemu VM, works in both BIOS and EFI modes +* QEMU host (on Linux), works in both BIOS and EFI modes. Note that for acceptable performance, QEMU needs KVM which is currently not available on FreeBSD hosts yet. See below for additional information + +* Proxmox VE + +Please note: + +* The VM needs to be __64-bit__ +* The VM needs __at least 4 GB of RAM__ +* The boot process takes longer than you might expect; boot in verbose mode to see the details + +Please report back about the results on your virtualization environment. + +#### QEMU + +Create an 8 GiB (or larger) `hello.img` image file on which you can install the system: -You can boot and install hello in a Qemu VM. First create a disk image for it with fallocate: ``` $ pwd /home/user $ mkdir -p .qemu/hello -$ fallocate -l $(( 24*1024*1024*1024 )) .qemu/hello/hello.img +$ fallocate -l $(( 8*1024*1024*1024 )) .qemu/hello/hello.img ``` -This creates a 24 GiB hello.img file where you'll install the system. -To boot the hello ISO image, use the following qemu-system-x86_64 command: +Then, boot helloSystem: + ``` qemu-system-x86_64 -machine type=q35,accel=kvm \ -enable-kvm -cpu host -smp 2 -m 4096 \ @@ -49,17 +68,20 @@ qemu-system-x86_64 -machine type=q35,accel=kvm \ -drive format=raw,file=${HOME}/Downloads/hello-0.4.0_0D26-FreeBSD-12.1-amd64.iso \ -boot menu=on ``` -When the Qemu VM starts, press esc and select 2 to boot the iso. -After you've installed hello on the disk image, you can remove the last two options from the above command. +When QEMU starts, press `esc` and select `2` to boot the ISO. -The hostfwd= option creates a port forward from your host port 5222 to the Qemu VM port 22. +Use the __Install FreeBSD__ utility to install helloSystem do the disk image. -Unfortunately the qemu-system-x86_64 USB tablet options don't work with hello so you'll need to press Ctrl+Alt+g to release the mouse pointer from the Qemu VM window. +Then restart QEMU, you now remove the last two options from the above command. -If you want to make Qemu VM full screen, press Ctrl+Alt+f. +Notes -To boot/install hello in UEFI mode, first install [OVMF Open Virtual Machine Firmware](https://github.com/tianocore/tianocore.github.io/wiki/OVMF) on your host side. The package name for Fedora 32 is edk2-ovmf. +* The `hostfwd=` option creates a port forward from your host port `5222` to the Qemu VM port `22`. +* Unfortunately the qemu-system-x86_64 USB tablet options do not work; you will need to press Ctrl+Alt+g to release the mouse pointer from the QEMU window +* To make QEMU full screen, press Ctrl+Alt+F + +To boot/install hello in UEFI mode, first install [OVMF Open Virtual Machine Firmware](https://github.com/tianocore/tianocore.github.io/wiki/OVMF) on your host side. The package name for Fedora 32 is `edk2-ovmf` Then add these two qemu-system-x86_64 options for the Qemu VM start: ``` @@ -67,14 +89,6 @@ Then add these two qemu-system-x86_64 options for the Qemu VM start: -smbios type=0,vendor=0vendor,version=0version,date=0date,release=0.0,uefi=on \ ``` -Please note: - -* The VM needs to be 64-bit -* The VM needs at least 4 GB of RAM which is higher than the VirtualBox default -* The boot process takes longer than you might expect; boot `-v` to see the details - -Please report back about the results on your virtualization environment. - ## Downloading Pre-alpha ISO images are available for download [here](https://github.com/helloSystem/ISO/releases/). From 3c2cfabadc18f2300c520a9fdf16c9c9c1077e49 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 14 Feb 2021 12:21:15 +0100 Subject: [PATCH 257/592] Update getting-started.md --- user/getting-started.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/user/getting-started.md b/user/getting-started.md index a6507506..05b04119 100644 --- a/user/getting-started.md +++ b/user/getting-started.md @@ -26,6 +26,8 @@ helloSystem developers currently have access to the following hardware: Please contact us if you would like to sponsor the project with a hardware donation. We are especially looking for Apple and Lenovo devices from the previous generations that should be available second-hand inexpensively. +To see Hardware Probes of systems running helloSystem, please see the [helloSystem Hardware Database](http://bsd-hardware.info/?d=helloSystem&view=computers) provided by bsd-hardware.info. It is reasonable to assume that every system listed there can at least successfully boot helloSystem. Auxiliary functionality such as wireless networking, sound over HDMI, sleep, graphics acceleration, etc. may or may not be working. + ### Virtualization environments Users have reported success in running helloSystem in the following virtualization environments: From c8ede72f7d61eb199c521819daef44b87aa78d68 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 14 Feb 2021 12:34:05 +0100 Subject: [PATCH 258/592] Update getting-started.md --- user/getting-started.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/user/getting-started.md b/user/getting-started.md index 05b04119..38c47e24 100644 --- a/user/getting-started.md +++ b/user/getting-started.md @@ -85,7 +85,7 @@ Notes To boot/install hello in UEFI mode, first install [OVMF Open Virtual Machine Firmware](https://github.com/tianocore/tianocore.github.io/wiki/OVMF) on your host side. The package name for Fedora 32 is `edk2-ovmf` -Then add these two qemu-system-x86_64 options for the Qemu VM start: +Then add these two `qemu-system-x86_64` options: ``` -bios /usr/share/edk2/ovmf/OVMF_CODE.fd \ -smbios type=0,vendor=0vendor,version=0version,date=0date,release=0.0,uefi=on \ From 7ba061c58c34f065ed288f7dc21bff3f1133a67f Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 15 Feb 2021 18:47:45 +0100 Subject: [PATCH 259/592] Fix typo --- index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.md b/index.md index 02103cc2..4316b511 100644 --- a/index.md +++ b/index.md @@ -10,7 +10,7 @@ # hello -__hello__ (also known as __helloSystem__) is a desktop system for creators with focus on simplicity, elegance, and usability. Its design follows the "Less, but better" philosophy. It is intended as a system for "mere mortals", welcoming to switchers from the Mac. [FreeBSD](https://www.freebsd.org/) is used as the core operating system. Please refer to [https://github.com/helloSystem/hello](https://github.com/helloSystem/hello) if you would like to learn more about the ideas and principles behind hello. +__hello__ (also known as __helloSystem__) is a desktop system for creators with a focus on simplicity, elegance, and usability. Its design follows the "Less, but better" philosophy. It is intended as a system for "mere mortals", welcoming to switchers from the Mac. [FreeBSD](https://www.freebsd.org/) is used as the core operating system. Please refer to [https://github.com/helloSystem/hello](https://github.com/helloSystem/hello) if you would like to learn more about the ideas and principles behind hello. ![Screenshot](https://github.com/helloSystem/hello/blob/master/screenshots/20210210-desktop-0.4.png?raw=true) From 82dd19daab9d51a455e31d9a7f95b7129987e56c Mon Sep 17 00:00:00 2001 From: probonopd Date: Tue, 16 Feb 2021 22:47:51 +0100 Subject: [PATCH 260/592] Update getting-started.md --- user/getting-started.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/user/getting-started.md b/user/getting-started.md index 38c47e24..68c3f7b1 100644 --- a/user/getting-started.md +++ b/user/getting-started.md @@ -30,6 +30,8 @@ To see Hardware Probes of systems running helloSystem, please see the [helloSyst ### Virtualization environments +We recommend running helloSystem on real hardware ("bare metal") if possible. This should give you the best possible performance and hardware support. + Users have reported success in running helloSystem in the following virtualization environments: * VirtualBox host (on FreeBSD and on macOS), known to work in BIOS and EFI mode From e29bd7a4913418bf7aa6efe59e0d0869eb91f738 Mon Sep 17 00:00:00 2001 From: probonopd Date: Wed, 17 Feb 2021 19:02:00 +0100 Subject: [PATCH 261/592] Traditional Chinese [ci skip] https://github.com/helloSystem/ISO/issues/146 --- index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.md b/index.md index 4316b511..43d4de31 100644 --- a/index.md +++ b/index.md @@ -5,7 +5,7 @@ ``` ```eval_rst -.. centered:: Willkommen • Welcome • 欢迎 • Bienvenue • Benvenuto • Bienvenido • ようこそ • Mabuhay • Välkommen • Добро пожаловать • Merhaba • Bonvenon • 歡迎光臨 +.. centered:: Willkommen • Welcome • Bienvenue • Benvenuto • Bienvenido • ようこそ • Mabuhay • Välkommen • Добро пожаловать • Merhaba • Bonvenon • 歡迎 ``` # hello From 2337b8f5790c22d62b8e36a8ec5cc30fca48ead2 Mon Sep 17 00:00:00 2001 From: probonopd Date: Wed, 17 Feb 2021 19:08:38 +0100 Subject: [PATCH 262/592] Add QHexEdit example --- developer/application-bundles.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/developer/application-bundles.md b/developer/application-bundles.md index c1f590b0..ab78c13b 100644 --- a/developer/application-bundles.md +++ b/developer/application-bundles.md @@ -53,6 +53,18 @@ A __desktop2app__ tool ships with helloSystem that automates the creation of suc Please note that the use of wrapper bundles is discouraged and is only available as a bridge technology for backward compatibility with existing application packages. +## Building application bundles + +Here is a real-world example on how to build an application bundle for a Qt application written in C++ using GitHub and [Cirrus CI](cirrus-ci.com): + +https://github.com/helloSystem/QHexEdit + +The application gets compiled and uploaded in a fully automated process. + +The resulting application bundle is provided for download in zipped form on GitHub Releases. + +Please see the [`.cirrus.yml`](https://github.com/helloSystem/QHexEdit/blob/main/.cirrus.yml) file for details. + ## Getting application metadata for running applications Many desktop environments use XDG-style `.desktop` files to figure out which application a given window belongs to but since helloSystem is using `.app` bundles and `.AppDir` application directories this approach is not sufficient since such applications normally do not install XDG-style `.desktop` files in central locations. From f1af28548c28281409fce921dc9f105d1c7c5ea1 Mon Sep 17 00:00:00 2001 From: Graham Perrin Date: Thu, 18 Feb 2021 13:32:22 -0500 Subject: [PATCH 263/592] application-bundles.md: fix broken link (#19) https://hellosystem.github.io/docs/developer/cirrus-ci.com is not found. Instead: https://cirrus-ci.com/ --- developer/application-bundles.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/developer/application-bundles.md b/developer/application-bundles.md index ab78c13b..04332ad2 100644 --- a/developer/application-bundles.md +++ b/developer/application-bundles.md @@ -55,7 +55,7 @@ Please note that the use of wrapper bundles is discouraged and is only available ## Building application bundles -Here is a real-world example on how to build an application bundle for a Qt application written in C++ using GitHub and [Cirrus CI](cirrus-ci.com): +Here is a real-world example on how to build an application bundle for a Qt application written in C++ using GitHub and [Cirrus CI](https://cirrus-ci.com/): https://github.com/helloSystem/QHexEdit From 371b6540a2718b39a3ce93df0d6b723ae1f8f11b Mon Sep 17 00:00:00 2001 From: probonopd Date: Thu, 18 Feb 2021 22:30:13 +0100 Subject: [PATCH 264/592] Parallels --- user/getting-started.md | 15 +++++++++++++-- 1 file changed, 13 insertions(+), 2 deletions(-) diff --git a/user/getting-started.md b/user/getting-started.md index 68c3f7b1..4219ed4d 100644 --- a/user/getting-started.md +++ b/user/getting-started.md @@ -30,7 +30,9 @@ To see Hardware Probes of systems running helloSystem, please see the [helloSyst ### Virtualization environments -We recommend running helloSystem on real hardware ("bare metal") if possible. This should give you the best possible performance and hardware support. +``` .. note:: + We recommend running helloSystem on real hardware ("bare metal") if possible. This should give you the best possible performance and hardware support. +``` Users have reported success in running helloSystem in the following virtualization environments: @@ -38,7 +40,9 @@ Users have reported success in running helloSystem in the following virtualizati * VMware host (on Windows), possibly only working in BIOS mode? -* QEMU host (on Linux), works in both BIOS and EFI modes. Note that for acceptable performance, QEMU needs KVM which is currently not available on FreeBSD hosts yet. See below for additional information +* QEMU host (on Linux), works in both BIOS and EFI modes (see below). Note that for acceptable performance, QEMU needs KVM which is currently not available on FreeBSD hosts yet + +* Parallels host, reported to work in EFI mode (see below) * Proxmox VE @@ -93,6 +97,13 @@ Then add these two `qemu-system-x86_64` options: -smbios type=0,vendor=0vendor,version=0version,date=0date,release=0.0,uefi=on \ ``` +#### Parallels + +* Select Hardware > Boot Order. +* Expand **Advanced Settings**. Set **BIOS** to "EFI 64-bit" and in the Boot flags field, enter `vm.bios.efi=1`. + +![Screenshot](https://docs.01.org/clearlinux/latest/zh_CN/_images/parallels-07.png) + ## Downloading Pre-alpha ISO images are available for download [here](https://github.com/helloSystem/ISO/releases/). From da2304720a6ad3f3c1dfd081185a1d609e56e532 Mon Sep 17 00:00:00 2001 From: probonopd Date: Thu, 18 Feb 2021 23:49:13 +0100 Subject: [PATCH 265/592] Update getting-started.md --- user/getting-started.md | 1 + 1 file changed, 1 insertion(+) diff --git a/user/getting-started.md b/user/getting-started.md index 4219ed4d..a6be9de8 100644 --- a/user/getting-started.md +++ b/user/getting-started.md @@ -51,6 +51,7 @@ Please note: * The VM needs to be __64-bit__ * The VM needs __at least 4 GB of RAM__ * The boot process takes longer than you might expect; boot in verbose mode to see the details +* For best results set **EFI/UEFI** boot mode (not BIOS) Please report back about the results on your virtualization environment. From f7d91d1d6436dd19f291a9584c3b22ff05c8729c Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 20 Feb 2021 10:57:52 +0100 Subject: [PATCH 266/592] Link HIG --- developer/ux-guidelines.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/developer/ux-guidelines.md b/developer/ux-guidelines.md index abe67ee1..2a3dfe15 100644 --- a/developer/ux-guidelines.md +++ b/developer/ux-guidelines.md @@ -8,7 +8,7 @@ What are the design principles that make user interfaces "Mac-like"? Apple spell > If you are a designer, a human interface professional, or an engineer, this book contains information you can use to design and create products that fit the Macintosh model. It provides background information that can help you plan and make decisions about your product design. __Even if you don’t design and develop products for the Macintosh, reading this book will help you to understand the Macintosh interface.__ -Source: Apple Computer, Inc., 1992, Macintosh Human Interface Guidelines, First Printing, November 1992. Addison-Wesley Publishing Company. ISBN 0-201-62216-5 +Source: [Apple Computer, Inc., 1992, Macintosh Human Interface Guidelines, First Printing, November 1992. Addison-Wesley Publishing Company. ISBN 0-201-62216-5](https://dl.acm.org/doi/book/10.5555/573097) ## Walker, N & Smelcer, 1990 (Superiority of the global menu bar) From 8a0d3735432dced896854c4efb2c7155481c5787 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 20 Feb 2021 21:07:49 +0100 Subject: [PATCH 267/592] Update acknowledgements.md --- developer/acknowledgements.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/developer/acknowledgements.md b/developer/acknowledgements.md index df3aa951..e0f645ea 100644 --- a/developer/acknowledgements.md +++ b/developer/acknowledgements.md @@ -82,3 +82,7 @@ __[grahamperrin](https://github.com/grahamperrin)__ __[PreyK](https://github.com/PreyK)__ * Made System menu to refresh itself automatically * Fixed Menu and desktop for multi-monitor setups + +## Chris Moore +__[moochris](https://github.com/moochris)__ +* Improved Filer: Added initial 'spatial mode' option and made already-open windows come to the front rather than opening the same window multiple times From f774e2922e22a7006372be53235ddc9882a659a7 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 20 Feb 2021 21:08:48 +0100 Subject: [PATCH 268/592] Update acknowledgements.md --- developer/acknowledgements.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/developer/acknowledgements.md b/developer/acknowledgements.md index e0f645ea..b24d2241 100644 --- a/developer/acknowledgements.md +++ b/developer/acknowledgements.md @@ -85,4 +85,4 @@ __[PreyK](https://github.com/PreyK)__ ## Chris Moore __[moochris](https://github.com/moochris)__ -* Improved Filer: Added initial 'spatial mode' option and made already-open windows come to the front rather than opening the same window multiple times +* Improved Filer: Added initial 'spatial mode' option (folders open in a new window) and made already-open windows come to the front rather than opening the same window multiple times From b2c1a1481bb2b85b20d30d84ad90ebba73348fb7 Mon Sep 17 00:00:00 2001 From: probonopd Date: Tue, 23 Feb 2021 09:31:28 +0100 Subject: [PATCH 269/592] Update filesystems.md --- user/components/filesystems.md | 1 - 1 file changed, 1 deletion(-) diff --git a/user/components/filesystems.md b/user/components/filesystems.md index 8fbbe018..c51d5273 100644 --- a/user/components/filesystems.md +++ b/user/components/filesystems.md @@ -9,7 +9,6 @@ Additionally, the following filesystems are supported in helloSystem, but it can * EXT4 (Linux) _once available in quarterly packages_ * HFS+ (Macintosh) * XFS (SGI) -* MTP (Android) Supported filesystems are automatically mounted by [automount](https://github.com/vermaden/automount). From a1ef3d1e03068f4f23b1e195fe14aa762f369c90 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 28 Feb 2021 17:42:07 +0100 Subject: [PATCH 270/592] set initgfx.detect.disable=1 https://github.com/nomadbsd/NomadBSD/issues/83#issuecomment-787444868 --- developer/graphics.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/developer/graphics.md b/developer/graphics.md index 86582f50..7136b227 100644 --- a/developer/graphics.md +++ b/developer/graphics.md @@ -42,6 +42,8 @@ If you want to create your own graphics driver settings, you can disable initgfx `initgfx_enable="NO"` to `/etc/rc.conf`. +If you would like to temporarily disable the automatic graphics driver setup and use a failsafe non-accelerated driver (VESA or SCFB), then enter `set initgfx.detect.disable=1` followed by `boot` at the bootloader prompt. This can be useful e.g., in cases where the automatically detected graphics driver does not work properly on the Live system. + ## Troubleshooting If applications that are using OpenGL crash on Nvidia systems, then it may be that the Nvidia driver was correctly loaded but the wrong Xorg configuration has been loaded, not actually using the Nvidia driver. This can happen when initgfx writes the dynamically generated Xorg configuration to `path_xorg_cfg_dir` (which points to `/usr/local/etc/X11/xorg.conf.d/` by default) but other files have been placed by other packages or the user into, e.g., `/etc/X11/xorg.conf.d`. You can verify which Xorg configuration directory was used by Xorg with `cat /var/log/Xorg.0.log | grep Using.config`. Seemingly Xorg cannot combine configuration stored in multiple `xorg.conf.d` directories. From 47c4d70373aad0c21a71b9dec23866fb96ca705a Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 1 Mar 2021 19:17:20 +0100 Subject: [PATCH 271/592] fkorotkov --- developer/acknowledgements.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/developer/acknowledgements.md b/developer/acknowledgements.md index b24d2241..70dd7305 100644 --- a/developer/acknowledgements.md +++ b/developer/acknowledgements.md @@ -27,6 +27,10 @@ malco2001 on irc.freenode.net (#FuryBSD) [https://cirrus-ci.com/](https://cirrus-ci.com/) * Providing continuous build infrastructure +## Fedor Korotkov +__[fkorotkov](https://github.com/fkorotkov)__ +* Provided helpful support concerning all things Cirrus CI + ## FreeBSD Foundation [https://www.freebsdfoundation.org/](https://www.freebsdfoundation.org/) * Gave permission to use the trademarks in the 'Install FreeBSD' utility From 1ffa4f444254c9b193421212b6132cf99faf0800 Mon Sep 17 00:00:00 2001 From: probonopd Date: Wed, 3 Mar 2021 19:20:29 +0100 Subject: [PATCH 272/592] Networking hardware --- user/getting-started.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/user/getting-started.md b/user/getting-started.md index a6be9de8..a56ac32c 100644 --- a/user/getting-started.md +++ b/user/getting-started.md @@ -28,6 +28,13 @@ Please contact us if you would like to sponsor the project with a hardware donat To see Hardware Probes of systems running helloSystem, please see the [helloSystem Hardware Database](http://bsd-hardware.info/?d=helloSystem&view=computers) provided by bsd-hardware.info. It is reasonable to assume that every system listed there can at least successfully boot helloSystem. Auxiliary functionality such as wireless networking, sound over HDMI, sleep, graphics acceleration, etc. may or may not be working. +### Networking hardware + +Not all networking devices may be supported by FreeBSD yet. In those cases, you may want to consider using a USB based networking devices. helloSystem developers currently have access to the following USB based networking devices which are known to work: + +* USB 802.11n WLAN Adapters based on `ID 0bda:8176 Realtek Semiconductor Corp. RTL8188CUS` +* USB Wired Ethernet Adapters based on `ID 0b95:772b ASIX Electronics Corp. AX88772B` + ### Virtualization environments ``` .. note:: From 977533132730949db49e80c7d5125b5ab7175b6d Mon Sep 17 00:00:00 2001 From: probonopd Date: Wed, 3 Mar 2021 19:27:12 +0100 Subject: [PATCH 273/592] Update getting-started.md --- user/getting-started.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/user/getting-started.md b/user/getting-started.md index a56ac32c..30982b9d 100644 --- a/user/getting-started.md +++ b/user/getting-started.md @@ -32,8 +32,8 @@ To see Hardware Probes of systems running helloSystem, please see the [helloSyst Not all networking devices may be supported by FreeBSD yet. In those cases, you may want to consider using a USB based networking devices. helloSystem developers currently have access to the following USB based networking devices which are known to work: -* USB 802.11n WLAN Adapters based on `ID 0bda:8176 Realtek Semiconductor Corp. RTL8188CUS` -* USB Wired Ethernet Adapters based on `ID 0b95:772b ASIX Electronics Corp. AX88772B` +* [USB 802.11n WLAN Adapters based on `ID 0bda:8176 Realtek Semiconductor Corp. RTL8188CUS`](https://vermaden.wordpress.com/2020/10/30/realtek-usb-wifi-review/) +* [USB Wired Ethernet Adapters based on `ID 0b95:772b ASIX Electronics Corp. AX88772B`](https://www.freebsd.org/cgi/man.cgi?query=axe) ### Virtualization environments From 8bd21f858bcd94162f05e038091f733963324b93 Mon Sep 17 00:00:00 2001 From: probonopd Date: Wed, 3 Mar 2021 20:10:16 +0100 Subject: [PATCH 274/592] Weblate --- developer/acknowledgements.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/developer/acknowledgements.md b/developer/acknowledgements.md index 70dd7305..87dee4c5 100644 --- a/developer/acknowledgements.md +++ b/developer/acknowledgements.md @@ -90,3 +90,7 @@ __[PreyK](https://github.com/PreyK)__ ## Chris Moore __[moochris](https://github.com/moochris)__ * Improved Filer: Added initial 'spatial mode' option (folders open in a new window) and made already-open windows come to the front rather than opening the same window multiple times + +### Weblate +[https://hosted.weblate.org/projects/hellosystem](https://hosted.weblate.org/) +* Providing infrastructure for crowd-sourced translations From 2985cc406e57acdf57ddbf4c8bb089a5b3da0053 Mon Sep 17 00:00:00 2001 From: probonopd Date: Wed, 3 Mar 2021 20:10:45 +0100 Subject: [PATCH 275/592] Update acknowledgements.md --- developer/acknowledgements.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/developer/acknowledgements.md b/developer/acknowledgements.md index 87dee4c5..7f1e92c2 100644 --- a/developer/acknowledgements.md +++ b/developer/acknowledgements.md @@ -91,6 +91,6 @@ __[PreyK](https://github.com/PreyK)__ __[moochris](https://github.com/moochris)__ * Improved Filer: Added initial 'spatial mode' option (folders open in a new window) and made already-open windows come to the front rather than opening the same window multiple times -### Weblate -[https://hosted.weblate.org/projects/hellosystem](https://hosted.weblate.org/) +## Weblate +[hosted.weblate.org](https://hosted.weblate.org/projects/hellosystem) * Providing infrastructure for crowd-sourced translations From dc6d747e585256fcdb0b1b54bca48c90e6e96244 Mon Sep 17 00:00:00 2001 From: Andrew Imeson Date: Thu, 4 Mar 2021 13:02:57 -0500 Subject: [PATCH 276/592] Typos and other enhancements (#20) * Fix typos across multiple docs * Syntax highlight code blocks in README * Optimize book image to reduce size Done using pngquant: pngquant --strip --ext .png --force book-pyqt5.png * Cleanup GitHub Actions formatting, remove example step --- .github/workflows/main.yml | 22 ++++-------------- README.md | 4 ++-- _static/book-pyqt5.png | Bin 15577 -> 6378 bytes developer/architecture.md | 10 ++++---- developer/boot.md | 4 ++-- developer/developer-tools.md | 4 ++-- developer/localization.md | 2 +- developer/specifications.md | 2 +- .../preferences/boot-environments.md | 4 ++-- user/components/preferences/keyboard.md | 4 ++-- user/components/preferences/shortcuts.md | 2 +- user/components/system/launch.md | 2 +- user/components/utilities/mountarchive.md | 2 +- 13 files changed, 24 insertions(+), 38 deletions(-) diff --git a/.github/workflows/main.yml b/.github/workflows/main.yml index f4d468d0..76f50f34 100644 --- a/.github/workflows/main.yml +++ b/.github/workflows/main.yml @@ -1,23 +1,18 @@ -# This is a basic workflow to help you get started with Actions - +--- name: CI -# Controls when the action will run. on: - # Triggers the workflow on push or pull request events but only for the main branch push: - branches: [ main ] + branches: [main] tags-ignore: - 'continuous' pull_request: - branches: [ main ] - + branches: [main] + # Allows you to run this workflow manually from the Actions tab workflow_dispatch: -# A workflow run is made up of one or more jobs that can run sequentially or in parallel jobs: - # This workflow contains a single job called "build" build: if: "!contains(github.event.head_commit.message, 'ci skip')" # The type of runner that the job will run on @@ -25,17 +20,8 @@ jobs: env: G_TOKEN: ${{secrets.GITHUB_TOKEN}} - # Steps represent a sequence of tasks that will be executed as part of the job steps: - # Checks-out your repository under $GITHUB_WORKSPACE, so your job can access it - uses: actions/checkout@v2 - # Runs a single command using the runners shell - name: Build docs run: sudo -E bash -ex buildDocs.sh - - # Runs a set of commands using the runners shell - - name: Run a multi-line script - run: | - echo Add other actions to build, - echo test, and deploy your project. diff --git a/README.md b/README.md index 59b1ae49..c8e27bd3 100644 --- a/README.md +++ b/README.md @@ -11,7 +11,7 @@ It uses Sphinx, recommonmark, and GitHub Actions to produce documentation from t Use a local development server that regenerates the output whenever the input changes: -``` +```sh sudo pkg install -y py37-pip gmake # on FreeBSD, e.g., on helloSystem pip-3.7 install -r requirements.txt export GITHUB_REPOSITORY="helloSystem/docs" @@ -25,7 +25,7 @@ Now open http://127.0.0.1:8000 in a web browser. It will be regenerated and refr One can also generate documentation in various output formats locally: -``` +```sh sudo pkg install -y py37-pip gmake # on FreeBSD, e.g., on helloSystem pip-3.7 install -r requirements.txt export GITHUB_REPOSITORY="helloSystem/docs" diff --git a/_static/book-pyqt5.png b/_static/book-pyqt5.png index 676adef2938b4e79d0eaf0560951845412394152..0588503539fbbbd1cf07b40c3ac045328453a4eb 100644 GIT binary patch literal 6378 zcmVPx&08mU+MHw0>DP=ep7$g`OC^xG~|Iea-$Fs9|i~)7Z)c003Q_# zBn=N985bxpia|4*MGz7uDY7{;z*g;cNUKk4~Gnqs= zxJx&%N;EY=A0RFN?nEI&FdG~xDQh`uYjhkgD>9Zu6b=|>W^Q_CF*vkJDsVbJKT0_| zMSOgN+}z&G%+6g;EO2pon39 zDJnMM;o>W}JSw$17#=Btf{6d}L^6{@8$Vw~JSh_)GYnl5|Jy<=yFOJ)EF&T&)6>=e z-a(U-nTT^U2}u$@HYq#6O}4kXA3H8FkU}lOKSoATD<~=V_4Xl0Y4P##prEC6Vlf*m zLwaHrk$N-@PZcG@Hvi~DOhPJRR4!;)FCLwDKpSsgFsO_)#m2}i$UYw`E@ESA zz@IlJBq;yuM3{dtiHeXAH5*DxRUaQG5;ju_R};{zI4~+D|KdXJ?d@M+Xe+-xzP`aN zfr$<>lrX5-I=U zL^PsCBT+Lf&OQue7Dew^7ZfMPq&VuqJVM`88YMU+PIUkFMJZi}C0jN8&_DIdK0nb> z3;`R~vOE9$MkS#%A~a6v>FE+5A1AFhSXp5ggCioFF+Ijk9Fi)ulr1D95^C6RV7q?XjK~}4KtU1ng z8X|i$GaWxAj5SqUb@i-4$^ZZrh)G02RA}C`R$XWs+ZL7y!LVlr_Ji)3VJlb7kE6_i zPzDDo(?DsI)E5mR#DF?hQ3`_k5NV+F7!SdR)Dv3@Jvm4#BX2{ zLId~Z((}@nd*AQfqb4;!m;2NOahRFCzkKVP^{urHh946~qtW$akVlM0yT|&2NW08d zcJ7wPI{VUpRCNUOkBW5q8j&lV~{_`ibCl769M8(A{B&U$j8%2 zigPH)_sER&NSn7xf7~1$Jr7NbT(y(U?pGy&Bux@0nd`rVo5WB9ArLGSwMNyEmc2<8 zNmMP|KEOgxde^j-y*FA~nHar@&Dg4C5rB|a!WfDiRH1};@+*RRM&@<31d8IM^@b9r&i+SSeOr1tF?ty`tws(2k(zR<$H%!sHM`lY18-wD znONIzzVa7ase@hUl)DumG3`toL{6{|bZnQ!yf;68cL046J5}sqOY(69v=2nJ;Gh8? zN;E+=02+0hEmefP+|2>rm@PY0g6-tE6KuQbk)pi3IeIxZh2suhWdvT8wLC~T8r5o3 z$d%LCBC`G2hd~jt7w>R_8`m&t2B*JvL zSjlNgT+FDjT3#yGRjrXIYoO9eg^StNaa5!QHMX8?<;usRTwib19j`#3qt~F`M@%ex z>uu?=j()bdB_0VF2P&0+U^O4&Mf_?hpvuUb3dJEG4cJg>DNl+JaVir@S9S#~!azC~ zRK?I*&pRUn^e3N7f83oo1I-zNSU?iA*`Orw#5@uNg}RN$Hq0>+79~>eSP~H9CzVbX z@kn1xN**yh>bHcR=S{5X#>8+xA-<8b4nd?TBnSf1J&2G1+Z~WiW2A?EFGv!?h4mmw zP(Z}Ey$e~X`}MRv+KD+me}6e#e>kL-6SBZyNbKj7dKY!A2tpx_SX1Rle^Rln-2l+X z>lTGPBa%m=lk3@axclhnJ43VuIhXbwKfn@Ipt zO~5<+0Bn}2eI9_NZb1W$r7$URRRp+@U&pa7!0WJ42S8o-Cldf12fH~aL!ReE?9UhS zQB@+$M@GJn5{j3L4oy37gkf1$W&g3i2_VR8gm*oWCqCrlz(J$6?`$W5*ingT+Y0wVL1W7qWHWhy##FGL8@c>1>a;;0Oa1Cy5zr zC{xyXr>g)6`{Cp_S=QPl!D7Ug%T>JINX8q?6_{acA_;D$0mO2!7T#~B8|yyg=vJzo zF!`2^9LRMl&C1fjQr1!MI~u_bEot4#aRrn&Rj383&0HraH+HjYsYoQ@Y#Gs6Y+70i zbBGMfc(@pjrb3{gp-9SLqhrulfNDMwm23g8uR#1BMKK9Vn~A&%;~}1l2~5Q6gQAc3 z@&0hE!21O1tR_ap>+_cqRI0|wP=vt_aULfyydXIdsd@6TFvOgb)HKfv`Y^&yGUsT- zOFSeCk&}@ar^HK0ppECSPi8LfFNS%V=HePJogNchW{<_pU?GPEAfu3QoV1=!FFTpicX9(8`jqPWRF5X0v7I(W=RAygV+ROsL6m!@KbX!P&D| zFSV1Cl4ttx^QX^SbL@1#ky^=MR35SBeo}+nT&F2qgkBhbI5zvS1?&W=&iyktjINR-g|3?)A*I zD^pjl&0M)NIX+1Z9SL>p$A7xnr^=g~+wAtr;mXmot(_0gZz_i@yH`3Y?YY0+-6|dJ zvEq^tOL5fj(UBs0+_^S;eQIoMOh^CgUkk(NI`&FwrKJ3GPI=^BR90^sJ-Q!0`n0^K zEN>`#+k48b4du`KZ;p0gG`1VV=yYTMBYq^L$NDjK{o2gyFFN`_7#;iN=f%Zk*8O(W z{pPLvg|h1YS-Ii%96fnH!MfR-&u=N)?%$O;7-(kXyno=!KIt!4`lL_Mug<)FINnDe z=uI>s;%*#m%zt$+E6eU}Wzp>-*q_{P_vrHtg8fx_@g-&O#uF#KN+*r}J$p*}JNoQL zQjj{jj%_I&vL3tLWc@V1Vq%w-8|*gWy`wyMqAXe$l?NNjefI<9#eZUeZnoh7Td%yo zW^PZ7osX&8vsXX9>w%9LE%y0Cy_!AjqVklK-X|ij@(ZcM8|;?yLD?dY=g8mc!&dB@ zcPTW$9$$EW_3D+e%VO&G%*-9qcSxHzTjsVcc5*1wMP;Y0=HFge=L{y#oRMYcZq2c* zebr+!u6jgYAddZ^L4}jbyM**0uFt%GH%a~Ux1UDL7SDevv-hB;vO5moiGWuWuDLJ3 zkdO_7mUyWI@TP=K8Ih<&B(yv>bOSTGvA7yVr+~058it99$g*y;JPc4_GV)lL1)QZC z1z8J>fPymZs<7kCT1Cccr;a0W+a9=r0^O*_W`{E4?B%;pE3_1;xejSAWS|nQ+~& zI?9+y7ug0~M8TN0zY2lL$w>qO|5PfKwivNTaC7Vm?`s`xU%hz!tbo>iATgmJ=<~{P zH{(+9lWD8fI*|v*kz4_Z^-n3Kv(1#cRTzoM z#%0Y@%^27AyKR?8a`-?`^rX+*M~e!p3m=x#I*t3-Y!aFnL@^4R$+7O8dF2awjbUhB zE+(+q9VK^KLOJ+H{{UmZ&a-`%wwEsldeQyvvq3wq+I0v*-~wwhilUhlIWy?A?+k_j z`%qQq|>kR2d4+)Ql_S4nX|@M z`$-TKmdyrwWkyDif!6mWxaf;)Mt@2NlF=bZK*G$TJ53^S7^N!4oEfxT*MQ#9*2@X~ z;YXLaZ{GKnyUpl#ZE>e{t^h$Oib4>9fcYdT#6hzh7tM%s8K+viI3Vtc^MSP4r^}B$ zU0^SdDeUW;kNaERpZGb~_H!kbm+83A50hsbtinDJcjqv2`0_fZIk<2jJ z;=Xya7aP=GJz$Hw%c#08KR*|JsN}Xfl*6~j9oWURU4PHrrg00c&&T~|Y&wvqO71i{ zhH0PEE_Anx1|B}NSmDf8m?V;|5OE1DdeSWNAps)`d z1gF7{F41Q6Q*-U1{Leo|;_JKXix$^?>7U^Mztk`=aLw{8e(81F;{Lai*0nrB5MN*3 zUF4x|V26M6pGytb9>_4n=l`-JDm(n-0^)qNL!4jy21KnBaA@MQu6JL%Fyl3+FAq7!!Q{JWBpGpeJ*;8(+)ob-f#P` zmTX6i4)uVdSvU`-&d+X=fiv{q_kg~*?hm%6Zj18v(0SDPIB&r=4n?%q)|TOT9IP#v zl@3ZT6a)QPjAfu`LESIHcYPZEhm|XXS9!BzKP{quo}jN=8aH_TPiwI3O}1Cplz$%FgT2XhzFpfTyv z!RSmFg|&CzkQn`{2rUa*L*H{*%uCPW940l($T&POu&nJ|MhBBT2=oKFFepv;bziie zqXm({$Vrh<1kJw>cV4_*enxg)-uT`)ps&~URL{bn?hNqlcoM`mC{-Bv_42nsz?USC|9&Un=2qiJVld2UpJ>yjI{NPw0_ri<3`(v zskNtVq=z7!nPjsa`oSuMoTO6nr@c4CR(CE!a>X@eHD*IuSG%rEr!$)kW{ue#2x$~L zose+uC!0O5v$Yh3akIgQzqKdnz!pku-Q@?;4}|#47aXU*N(lNPladB!p_csY%nMmv@?VdQ(e9XPw$CZ`3zEs%tdK#X=8u3M?BN+t43}qOuJ}Z@RJ| zjv|EeI(cV{US4+eLfSM8`{!AsYhK|fKdeR zkz8EC5>`N6ge0p=h<9Z{L>5bum6ZjV)Zpe1d9*kAZvuK1I5$>DgTY^{E5|TOBmjeVv|exxA*eRV_D} z>Ijp`q?c>zv`x-P z`xo1cenAW3o#KRoc|@vN`UeEF|;-+TAW;nc&scdztRjW)Jm;TWQsp4M0@BaQa9U!;?6r&gfe>d*#DrQhh5y! z!(a@0>_OPAP=xKU!31u+ zLJvN?d;PNu=7b!+I{eHu-uADvqQ6)u4Tp)dcIlxQEg9Cv0-V7_s;*MAt@Ufy0_UiEvy@OV7n;PnPbgV?~+Yz#avYZh$e?)h3BxO=ZhvoJLY z1duogWqce*2RMv%^Bl23WA_;)QUmOYvlE}iR)cB8t~fcA_skxT`AIC5<7m1vP?QK{ z-_BtpcW>R+Q4K@GIMgDxc}nO?#at3aZ%7>_9IiM=bJ<`~g=fl)w;L0-OQZ9-QLp0s zGoM|}HwP5O5|~{!q+e7v>CKBeoe_5DPDxMF%R2Vh8l9*3ju5ZTvV1q6zuiO$tYaaz zO6Mp(7mnvm>A|YdJq1}eVb|&jc1&VfYJ)!Q0s6n_W_*cS#ApLM6+6Y?l`Qa?i>}a| zn)YgZ*R`0@Iy;tnPY9Fc?@4_{@D!Xa*lWuk{7K z-^@Xq3V;X=ViTdqr$IW`sS2&2=6Mz5dBnVatEs(2WrNVEP@M5a1<`pL8#UuCxB+%} zt3`xp-;r;M4i}N7rj63*m0Dg9x;YD@(fPisubR|k*sGw?CPtw}@9f*Dyur3<7WO}MCVvL;eyzEp&fbe(x=nSjW*D2 zg$seNUCAL>)RxzEW!1_khpiAFvkl7XLJ@4izLP_`_IU@j&;QTXmDTAkMzi5qkUdsb z$18^GO$Rt`)hA%e{w0Sdw9l;_t%-vKSqn%u81NxM{({mD)SILgNET+pRaM!6Vj_`P zT_uxAujimpN|GQ;^7si)8uJth=A|w6M|oNu(%Oh_8jYKWvM82MN{PnV@vzVz77NGM z{c>6Clh3UUpTqXHk53Bk#daav2Z?SXn>`V)#ZTEnTLkxG?6EK9bu%{M2I(Dkj*$mx zoNzy9u;}^2IdPCqGDI|;#PKJw2{*%#0g@pZwX-bXWxN6K-OapU?3g{9ZQ|efWFw3% s_P#0GB6#dHAmeL4X0V^$+-%1F3qa*R(X;vb7ytkO07*qoM6N<$f~t%Fr~m)} literal 15577 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 diff --git a/developer/architecture.md b/developer/architecture.md index 339dcb33..2fa5a5e4 100644 --- a/developer/architecture.md +++ b/developer/architecture.md @@ -28,13 +28,13 @@ Global menu bar that displays the System menu for system-wide commands (such as ### Dock -A Dock that shows icons for running and pinned applications. (In the future it should als get an animated icon as a launching indicator for applications that are being launched but are not yet showing a window.) +A Dock that shows icons for running and pinned applications. (In the future it should also get an animated icon as a launching indicator for applications that are being launched but are not yet showing a window.) ### `launch` command The `launch` command is used to launch applications without specifying a path to them. -The `launch` command is expceted to determine the preferred instance of an application with the given name. (The `launch` command is supposed to find the _preferred_ instance, e.g., the one with the highest version, the one last put onto the system, etc.) Eventually the `launch` command should also get knowledge which application to open a file with. +The `launch` command is expected to determine the preferred instance of an application with the given name. (The `launch` command is supposed to find the _preferred_ instance, e.g., the one with the highest version, the one last put onto the system, etc.) Eventually the `launch` command should also get knowledge which application to open a file with. Filer is supposed to launch all applications through the `launch` command. Shell scripts, `.desktop` files, etc. should be written to use the `launch` command rather than hardcoding paths to applications, where appropriate. @@ -47,13 +47,13 @@ A very simple IPC mechanism should be introduced for the desktop components to t ### Applications -Applications must not need to be installed. Simply downloading them, attaching an external drive containing them, or connecting to a network share containing them must be sufficient. Mutliple versions of the same application must be able to co-exist. The `launch` command is resposible to determine which one to use in cases where the user did not explicitly launch a specific instance by double-clicking it. +Applications must not need to be installed. Simply downloading them, attaching an external drive containing them, or connecting to a network share containing them must be sufficient. Multiple versions of the same application must be able to co-exist. The `launch` command is responsible to determine which one to use in cases where the user did not explicitly launch a specific instance by double-clicking it. -Custom-written applications should come as Appplication bundles whenever possible. It is accaptable for pre-existing applications to come with legacy XDG desktop files instead. +Custom-written applications should come as Application bundles whenever possible. It is acceptable for pre-existing applications to come with legacy XDG desktop files instead. ### Utilities -The system should come with some commonly used utilities, such as a Terminal application, a Process Monitor application, etc. These are just regular applications inside a 'Utilities' subdirectory. It is accaptable for pre-existing applications, preferably written in Qt. +The system should come with some commonly used utilities, such as a Terminal application, a Process Monitor application, etc. These are just regular applications inside a 'Utilities' subdirectory. It is acceptable for pre-existing applications, preferably written in Qt. ### Preferences diff --git a/developer/boot.md b/developer/boot.md index 547cc173..62b6948b 100644 --- a/developer/boot.md +++ b/developer/boot.md @@ -21,7 +21,7 @@ This is a simplified description of the boot process. There may be additional as ### Troubleshooting the Live system early boot process * __Hangs or reboots during replicating the system image to swap-based memdisk.__ The ISO is damaged. About one out of 10 builds of the ISO have this issue. Simply build a new ISO or wait for the next ISO to be available for download -* __"Cannot mount tmpfs on /dev/reroot: Operation not supported by device".__ Reason unkown. Are needed kernel modules missing? +* __"Cannot mount tmpfs on /dev/reroot: Operation not supported by device".__ Reason unknown. Are needed kernel modules missing? ### Seeing what the system is doing while the graphical boot screen is shown @@ -56,7 +56,7 @@ The computer should boot into a text console rescue system in which parts of `in ## Graphical desktop start process 1. The system is configured in `/etc/rc.conf` to start the `slim` login manager. This also results in Xorg being started -1. `slim` is configured in `/usr/local/etc/slim.conf` to start `start-hello` once the user has logged in, or if autologin has occured +1. `slim` is configured in `/usr/local/etc/slim.conf` to start `start-hello` once the user has logged in, or if autologin has occurred 1. The `/usr/local/bin/start-hello` shell script starts the various components of the helloSystem desktop ### Troubleshooting the graphical desktop start process diff --git a/developer/developer-tools.md b/developer/developer-tools.md index 08983e25..a5eea106 100644 --- a/developer/developer-tools.md +++ b/developer/developer-tools.md @@ -2,7 +2,7 @@ The __Developer__ folder in the __Applications__ folder contains useful development tools for use with helloSystem. -* __PyCharm CE__: A powerful integrated development environment (IDE) for the Python languge which is used for +* __PyCharm CE__: A powerful integrated development environment (IDE) for the Python language which is used for many of the utilities and preferences applications in helloSystem * __Qt Creator__: The integrated development environment (IDE) for Qt-based applications, such as Menu, Dock, and Filer. Includes graphical user interface editors for QtWidgets-based user interfaces (such as Menu and Filer) using `.ui` files @@ -15,5 +15,5 @@ and are available for many languages and environments, including Python, Qt, and To minimize the initial download size of the helloSystem image, the applications in the Developer folder need to be downloaded prior to first use. You will be guided through this automatic process when you launch these -applications for the first time. After the applciations have been downloaded, you can use them without an active +applications for the first time. After the applications have been downloaded, you can use them without an active network connection. diff --git a/developer/localization.md b/developer/localization.md index c8f8af21..f479765e 100644 --- a/developer/localization.md +++ b/developer/localization.md @@ -2,4 +2,4 @@ helloSystem is localized at https://hosted.weblate.org/projects/hellosystem/. -Futher details will be added here. +Further details will be added here. diff --git a/developer/specifications.md b/developer/specifications.md index 3d45b2c4..1d7ca5ac 100644 --- a/developer/specifications.md +++ b/developer/specifications.md @@ -15,7 +15,7 @@ These specifications cover technologies that are enthusiastically embraced in he This list is not exhaustive. -## Conventions devloped for use in helloSystem +## Conventions developed for use in helloSystem These conventions cover technologies that are embraced for being used in helloSystem and applications running on it. diff --git a/user/components/preferences/boot-environments.md b/user/components/preferences/boot-environments.md index 0dd629aa..2378845f 100644 --- a/user/components/preferences/boot-environments.md +++ b/user/components/preferences/boot-environments.md @@ -16,7 +16,7 @@ The __Boot Environments__ preferences application lets you view, create, remove, ## Viewing Boot Environments -Open the __Boot Environments__ preferences application. If you have a user password set, you will be asked to enter your credentials. Only users in whe administrative group (`wheel`) can use the Boot Environments application by default. +Open the __Boot Environments__ preferences application. If you have a user password set, you will be asked to enter your credentials. Only users in the administrative group (`wheel`) can use the Boot Environments application by default. You will see the available Boot Environments. @@ -32,7 +32,7 @@ Select a Boot Environment by clicking on it, and then press "Remove". Note that You can make available, or "mount", existing Boot Environments, e.g., in order to inspect them or to copy files from there. -To do this, select a Boot Environment by clicking on it, and then press "Mount". Note that you cannot mout the currently active Boot Environment since it is already mounted at `/`. +To do this, select a Boot Environment by clicking on it, and then press "Mount". Note that you cannot mount the currently active Boot Environment since it is already mounted at `/`. The selected Boot Environment will be mounted, and a Filer window will be opened at the mountpoint of the Boot Environment. diff --git a/user/components/preferences/keyboard.md b/user/components/preferences/keyboard.md index f6e04547..297ed612 100644 --- a/user/components/preferences/keyboard.md +++ b/user/components/preferences/keyboard.md @@ -1,6 +1,6 @@ # Keyboard -The __Keyboard__ preferences application lets you change the keyboard layout (language) of your attached keyboard, and allows you to set which physical key should act as your ⌘ (command) key. it also lets you disable the Caps Lock key. +The __Keyboard__ preferences application lets you change the keyboard layout (language) of your attached keyboard, and allows you to set which physical key should act as your ⌘ (command) key. It also lets you disable the Caps Lock key. ``` .. note:: The keyboard layout (language) gets set automatically during system startup if an official Raspberry Pi keyboard is attached or the system is running on Macintosh hardware, which has the prev-lang:kbd EFI key set. @@ -12,7 +12,7 @@ Simply click on a language (keyboard layout). The change is effective immediatel ## Selecting a physical key to act as ⌘ (command) -Swapping the keys will result in the key left from the spacebar to act as the ⌘ (command) key (like switchers from the Mac would expect) and therfore is the default. +Swapping the keys will result in the key left from the spacebar to act as the ⌘ (command) key (like switchers from the Mac would expect) and therefore is the default. __If a PC keyboard is attached__, you can select the "Use the Alt key as ⌘" checkbox. This will swap the __Ctrl__ and __Alt__ keys. diff --git a/user/components/preferences/shortcuts.md b/user/components/preferences/shortcuts.md index 96f9a003..c994a94b 100644 --- a/user/components/preferences/shortcuts.md +++ b/user/components/preferences/shortcuts.md @@ -18,7 +18,7 @@ A __shortcut__ is a key or key combination you can press to invoke a defined act The ⌘ key, also known as Command, is the key left to the spacebar on helloSystem, unless you have configured your system differently. ``` .. note:: - The software may refer to the Comand key as "Ctrl". This is a known cosmetic issue. + The software may refer to the Command key as "Ctrl". This is a known cosmetic issue. ``` ## Default shortcuts diff --git a/user/components/system/launch.md b/user/components/system/launch.md index 2a667d18..ca7f9fe9 100644 --- a/user/components/system/launch.md +++ b/user/components/system/launch.md @@ -20,7 +20,7 @@ On UNIX systems, applications are typically launched by entering the name of the executable file, which is searched in a fixed list of directories determined by the `$PATH` environment variable. - Many graphical desktop environments use `.desktop` files to integrate applications with the system. While this has traditionally worked well for installed applications, it does not work well for dynamically changing applications that are moved in the filesystem, such as `.app` bundles or `.AppDir` directories. Also, it does not handle mutliple versions of the same application gracefully. Hence, helloSystem uses the `launch` command to launch graphical applications. This has the following advantages: + Many graphical desktop environments use `.desktop` files to integrate applications with the system. While this has traditionally worked well for installed applications, it does not work well for dynamically changing applications that are moved in the filesystem, such as `.app` bundles or `.AppDir` directories. Also, it does not handle multiple versions of the same application gracefully. Hence, helloSystem uses the `launch` command to launch graphical applications. This has the following advantages: * You do not need to know the path to the application to be launched, even if the applciation is not on the `$PATH` * If multiple versions of an application are available on the system, the most recent one will be launched automatically (unless specified otherwise by the user) __(to be implemented)__ diff --git a/user/components/utilities/mountarchive.md b/user/components/utilities/mountarchive.md index 721f8fce..44e8c4dc 100644 --- a/user/components/utilities/mountarchive.md +++ b/user/components/utilities/mountarchive.md @@ -1,5 +1,5 @@ # mountarchive -The __`mountarchive`__ tool makes archives (like `.zip`, `.tar.gz`, and `.tar.bz2` accesible in the Filer without having to extract them. +The __`mountarchive`__ tool makes archives (like `.zip`, `.tar.gz`, and `.tar.bz2` accessible in the Filer without having to extract them. For example, if you double-click a zip file called `plugin.video.invidious-0.5.3.zip` on your desktop, it will be mounted and a Filer window will be opened at its mountpoint, e.g., `/var/run/user/1001/_home_user_Desktop_plugin.video.invidious-0.5.3.zip`. From 95b23b5fdc67aa3c9c1d1ec3d4a074c0517e3dc0 Mon Sep 17 00:00:00 2001 From: probonopd Date: Thu, 4 Mar 2021 19:31:34 +0100 Subject: [PATCH 277/592] Update acknowledgements.md --- developer/acknowledgements.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/developer/acknowledgements.md b/developer/acknowledgements.md index 7f1e92c2..1693303f 100644 --- a/developer/acknowledgements.md +++ b/developer/acknowledgements.md @@ -94,3 +94,9 @@ __[moochris](https://github.com/moochris)__ ## Weblate [hosted.weblate.org](https://hosted.weblate.org/projects/hellosystem) * Providing infrastructure for crowd-sourced translations + + +## Chris Rees +__[crees](https://github.com/__crees)__ +* Made it possible to use a fixed Intel GPU driver for FreeBSD 12.2 from a private package +* Created a package for the Falkon browser that does not pull in many KDE dependencies From 870288cb030d2797dbdc242a114b81c447bc2a7e Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 6 Mar 2021 09:30:53 +0100 Subject: [PATCH 278/592] Update troubleshooting.md --- user/troubleshooting.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/user/troubleshooting.md b/user/troubleshooting.md index f351ddce..b40b069c 100644 --- a/user/troubleshooting.md +++ b/user/troubleshooting.md @@ -13,7 +13,9 @@ If – after five minutes – you're reluctant to stop the computer, you can occ ### Boot stalls during `Replicate system image to swap-based memdisk`(seen during verbose boot) -This affects some computers with some builds of the ISO. If you encounter this issue with your computer, please await the next ISO or try with a different computer. +You may also see the error message `md1.uzip: UZIP(zlib) inflate() failed`. + +This affects some computers with some (~ out of 10) builds of the ISO. If you encounter this issue with your computer, please __retry with the next build of the ISO__ or try with a different computer. ### `login:` prompt, no desktop environment From 9ccf67704dc5eabc1811e3102c3116ef488d7101 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 6 Mar 2021 09:36:43 +0100 Subject: [PATCH 279/592] Update boot.md --- developer/boot.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/developer/boot.md b/developer/boot.md index 62b6948b..fc37f0ae 100644 --- a/developer/boot.md +++ b/developer/boot.md @@ -17,6 +17,8 @@ This is a simplified description of the boot process. There may be additional as 1. `init.sh` from the ramdisk image exits 1. `etc/rc` from the ramdisk image gets executed as specified in `overlays/ramdisk/etc/rc` (by what?). It tells the kernel to "reroot" (not "chroot") into the live filesystem, `/livecd` using `reboot -r` 1. From here on, the boot process is the regular FreeBSD boot process +1. `/usr/local/etc/rc.d/localize` runs `/usr/local/sbin/localize` which tries to determine the language of the keyboard, and by proxy, of the system. This currently supports the official Raspberry Pi keyboard and Apple computers which store the keyboard and system language in the `prev-lang:kbd` EFI variable +1. The `slim` session manager (login window) is started; when the user is loggen in, it starts the script `/usr/local/bin/start-hello` which starts the desktop session ### Troubleshooting the Live system early boot process From 21366d43d9e96d50995c0adff19553ddc8b1d64f Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 6 Mar 2021 09:39:24 +0100 Subject: [PATCH 280/592] Update boot.md --- developer/boot.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/developer/boot.md b/developer/boot.md index fc37f0ae..09e8df82 100644 --- a/developer/boot.md +++ b/developer/boot.md @@ -16,9 +16,10 @@ This is a simplified description of the boot process. There may be additional as 1. The `/livecd` chroot is exited 1. `init.sh` from the ramdisk image exits 1. `etc/rc` from the ramdisk image gets executed as specified in `overlays/ramdisk/etc/rc` (by what?). It tells the kernel to "reroot" (not "chroot") into the live filesystem, `/livecd` using `reboot -r` -1. From here on, the boot process is the regular FreeBSD boot process -1. `/usr/local/etc/rc.d/localize` runs `/usr/local/sbin/localize` which tries to determine the language of the keyboard, and by proxy, of the system. This currently supports the official Raspberry Pi keyboard and Apple computers which store the keyboard and system language in the `prev-lang:kbd` EFI variable -1. The `slim` session manager (login window) is started; when the user is loggen in, it starts the script `/usr/local/bin/start-hello` which starts the desktop session +1. From here on, the boot process is the regular FreeBSD boot process with the following particularities: +1. `/etc/rc.d/initgfx` detects the GPU and loads the appropriate drivers +3. `/usr/local/etc/rc.d/localize` runs `/usr/local/sbin/localize` which tries to determine the language of the keyboard, and by proxy, of the system. This currently supports the official Raspberry Pi keyboard and Apple computers which store the keyboard and system language in the `prev-lang:kbd` EFI variable +4. The `slim` session manager (login window) is started; when the user is loggen in, it starts the script `/usr/local/bin/start-hello` which starts the desktop session and sets the keyboard and system language based on the information provided by `localize` in an earlier step ### Troubleshooting the Live system early boot process From 9b92bb2cb5781f9ac3736974aa860bbdaa512de3 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 6 Mar 2021 11:02:43 +0100 Subject: [PATCH 281/592] Create binary-compatibility.md --- developer/binary-compatibility.md | 45 +++++++++++++++++++++++++++++++ 1 file changed, 45 insertions(+) create mode 100644 developer/binary-compatibility.md diff --git a/developer/binary-compatibility.md b/developer/binary-compatibility.md new file mode 100644 index 00000000..dc0a3e00 --- /dev/null +++ b/developer/binary-compatibility.md @@ -0,0 +1,45 @@ + # Binary Compatibility + +Binary compatibility is an important concept in software engineering. It allows applications compiled on a build system to run on user's target systems without forcing them to upgrade their entire system all the time. As the FreeBSD wiki page on binary compatibility points out, "a lot of downstream users keep systems for about 10 years and want to be able to keep running their stack on top of FreeBSD without worrying that an upgrade will break things." + +``` .. note:: + This page is in draft status and needs to be reviewed by experienced FreeBSD developers. Pull requests welcome. +``` + + ## Application compatibility + + The Application Binary Interface (ABI) defines which applications can run on which systems. The two main factors in determining application compatibility are the FreeBSD version (e.g., `12.x`) and the version of packages (e.g., `quarterly`). + + * Applications compiled on one major version of FreeBSD are expected to run on subsequent minor versions of the same major version of FreeBSD if the packages of the dependencies on the target system are no older than on the build system. __Example:__ An application compiled on FreeBSD 12.0 is expected to run on FreeBSD 12.1 and 12.2 if the packages of the dependencies on the target system are no older than on the build system + * Applications compiled on one major version of FreeBSD are expected to run on subsequent major versions of FreeBSD if compatiblity libraries are installed. __Example:__ An application compiled on FreeBSD 3.2 is expected to run on FreeBSD 14 if compatiblity libraries are installed. + + +### Recommendation for building binary compatible applications + +Build on the `.0` minor version for each still-supported major version of FreeBSD, using `quarterly` or older packages. This should allow the application to run on all still-supported FreeBSD releases. + + ## Kernel module compatibility + + The Kernel Binary Interface (KBI) defines which kernel extensions can run on which systems. + +``` .. note:: + Sectino to be written. Pull requests welcome. +``` + + * Normally, kernel extensions compiled on one major version of FreeBSD are expected to run on subsequent minor versions of the same major version of FreeBSD. However, there are notable exceptions such as the `i915kms` package that contains the Intel GPU driver. + + __Note:__ The `i915kms` package that contains the Intel GPU driver breaks on 12.2-RELEASE. + +``` .. note:: + Explanation to be written. Pull requests welcome. +``` + + +### Recommendation for building binary compatible kernel modules + +Build on the `.0` minor version for each still-supported major version of FreeBSD. Test whether the kernel module runs on all subsequent minr versions and build for those minor versions separately in case it does not. This should allow the kernel module to run on all still-supported FreeBSD releases. + + + ## References + + * https://wiki.freebsd.org/BinaryCompatibility describes best practices for maintaining binary compatibility in FreeBSD From c49ba0cd039f21a80ce0b20b06bab42119a2560b Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 6 Mar 2021 11:03:42 +0100 Subject: [PATCH 282/592] Add developer/binary-compatibility --- index.md | 1 + 1 file changed, 1 insertion(+) diff --git a/index.md b/index.md index 43d4de31..0b713052 100644 --- a/index.md +++ b/index.md @@ -38,6 +38,7 @@ __hello__ (also known as __helloSystem__) is a desktop system for creators with developer/architecture developer/boot developer/graphics + developer/binary-compatibility developer/applications developer/application-bundles developer/menu From 750a9c6323aab63c13b9ffec4813e37c9beec3ea Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 6 Mar 2021 11:06:33 +0100 Subject: [PATCH 283/592] Update binary-compatibility.md --- developer/binary-compatibility.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/developer/binary-compatibility.md b/developer/binary-compatibility.md index dc0a3e00..08deecef 100644 --- a/developer/binary-compatibility.md +++ b/developer/binary-compatibility.md @@ -23,7 +23,7 @@ Build on the `.0` minor version for each still-supported major version of FreeBS The Kernel Binary Interface (KBI) defines which kernel extensions can run on which systems. ``` .. note:: - Sectino to be written. Pull requests welcome. + Section to be written. Pull requests welcome. ``` * Normally, kernel extensions compiled on one major version of FreeBSD are expected to run on subsequent minor versions of the same major version of FreeBSD. However, there are notable exceptions such as the `i915kms` package that contains the Intel GPU driver. @@ -43,3 +43,4 @@ Build on the `.0` minor version for each still-supported major version of FreeBS ## References * https://wiki.freebsd.org/BinaryCompatibility describes best practices for maintaining binary compatibility in FreeBSD + * [i915kms package breaks on 12.2-RELEASE](https://forums.freebsd.org/threads/i915kms-package-breaks-on-12-2-release-workaround-build-from-ports.77501/) From 72835d86e48f855edccb805fdf7d7145ca08e4f3 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 6 Mar 2021 12:14:09 +0100 Subject: [PATCH 284/592] Update getting-started.md --- user/getting-started.md | 1 + 1 file changed, 1 insertion(+) diff --git a/user/getting-started.md b/user/getting-started.md index 30982b9d..a86b58f6 100644 --- a/user/getting-started.md +++ b/user/getting-started.md @@ -10,6 +10,7 @@ hello is currently being developed. It is not yet available for general use, but * 4 GiB RAM (system memory for physical and viritualized installs) * VGA capable of 1024x768 screen resolution * Either a CD/DVD drive or a USB port for booting the installer media +* On non-Macintosh hardware, [Raspberry Pi keyboard](https://static.raspberrypi.org/files/product-briefs/210108_Product_Brief_Keyboard_and_Mouse.pdf) is recommended as it allows the keyboard and system language to be detected automatically if it is attached while the system is starting up. On Macintosh hardware, the `prev-lang:kbd` EFI variable is usually set and is used to detect the keyboard and system language In the future, there may also be builds for other processor architectures. We would like to bring down the RAM requirement considerably. From 56ce54dce00f6e078e7cf9251d4f4735b7295e73 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 6 Mar 2021 12:15:06 +0100 Subject: [PATCH 285/592] Update getting-started.md --- user/getting-started.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/user/getting-started.md b/user/getting-started.md index a86b58f6..0ac8f4b9 100644 --- a/user/getting-started.md +++ b/user/getting-started.md @@ -10,7 +10,7 @@ hello is currently being developed. It is not yet available for general use, but * 4 GiB RAM (system memory for physical and viritualized installs) * VGA capable of 1024x768 screen resolution * Either a CD/DVD drive or a USB port for booting the installer media -* On non-Macintosh hardware, [Raspberry Pi keyboard](https://static.raspberrypi.org/files/product-briefs/210108_Product_Brief_Keyboard_and_Mouse.pdf) is recommended as it allows the keyboard and system language to be detected automatically if it is attached while the system is starting up. On Macintosh hardware, the `prev-lang:kbd` EFI variable is usually set and is used to detect the keyboard and system language +* On non-Macintosh hardware, a [Raspberry Pi keyboard](https://static.raspberrypi.org/files/product-briefs/210108_Product_Brief_Keyboard_and_Mouse.pdf) is recommended as it allows the keyboard and system language to be detected automatically if it is attached while the system is starting up. On Macintosh hardware, the `prev-lang:kbd` EFI variable is usually set and is used to detect the keyboard and system language. Note that the key left to the space bar is used as the Command key (Alt key on PC keyboards, Apple key on Apple keyboards). In the future, there may also be builds for other processor architectures. We would like to bring down the RAM requirement considerably. From fd9e211a0cf9608468c3d8e762e44bd5af1f1427 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 6 Mar 2021 13:00:09 +0100 Subject: [PATCH 286/592] Update application-bundles.md --- developer/application-bundles.md | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) diff --git a/developer/application-bundles.md b/developer/application-bundles.md index 04332ad2..cf1bcfc9 100644 --- a/developer/application-bundles.md +++ b/developer/application-bundles.md @@ -65,6 +65,29 @@ The resulting application bundle is provided for download in zipped form on GitH Please see the [`.cirrus.yml`](https://github.com/helloSystem/QHexEdit/blob/main/.cirrus.yml) file for details. +### Making an application load privately bundled libraries + +If an application is supposed to load privately bundled libraries, one must patch it so that it loads privately bundled libraries from a path relative to itself (`$ORIGIN`) rather than from `/usr/local/lib`: + +``` +sed -i -e 's|/usr/local/lib|$ORIGIN/../lib|g' usr/local/bin/falkon +ln -s usr/local/lib . +rm usr/local/bin/falkon-e +``` + +This works because by coincidence the string `/usr/local/lib` has the exact same length as `$ORIGIN/../lib`. If this was not the case, one would need to either specifiy the rpath at compilation time, or use a tool such as `patchelf`. + +### Avoiding absolute paths + +For an application to be fully relocateable in the filesystem, one must take care that no absolute paths to data files (e.g., those in `/usr/share/` get compiled in. + +In Qt applications, void [`QStringList QStandardPaths::standardLocations(QStandardPaths::AppDataLocation);`](http://doc.qt.io/qt-5/qstandardpaths.html). According to the [Qt documentation](http://doc.qt.io/qt-5/qstandardpaths.html), this resolves to `"~/.local/share/", "/usr/local/share/", "/usr/share/"` but clearly `/usr` is not where these things are located in an `.app` bundle. + +Instead, use [`QString QCoreApplication::applicationDirPath()`](http://doc.qt.io/qt-5/qcoreapplication.html#applicationDirPath) and construct a _relative_ path to `../share/` from there. + +For an example, see: +https://github.com/KaidanIM/Kaidan/commit/da38011b55a1aa5d17764647ecd699deb4be437f + ## Getting application metadata for running applications Many desktop environments use XDG-style `.desktop` files to figure out which application a given window belongs to but since helloSystem is using `.app` bundles and `.AppDir` application directories this approach is not sufficient since such applications normally do not install XDG-style `.desktop` files in central locations. From f8a8d68c841c095cb4f2bb20a9ee24cea0f26e45 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 6 Mar 2021 23:59:41 +0100 Subject: [PATCH 287/592] Document LD_DEBUG=libs and truss --- user/troubleshooting.md | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/user/troubleshooting.md b/user/troubleshooting.md index b40b069c..3105e8e9 100644 --- a/user/troubleshooting.md +++ b/user/troubleshooting.md @@ -22,6 +22,21 @@ This affects some computers with some (~ out of 10) builds of the ISO. If you en * Please make sure that your computer has at least 4GB of RAM. helloSystem currently needs at least this amount to be started in Live mode. * The graphics hardware in your computer may not yet, or not yet easily, be usable with helloSystem. Try with a different computer, or seek help. +## Debugging application issues + +When debugging application issues, it can be helpful to see what an application is actually doing. For example, if we are interested in which libaries with "menu" in their name `firefox` is loading, we can run + +``` +LD_DEBUG=libs firefox 2>&1 | grep -i menu +``` + +Or, if we are interested in which activities with "menu" in their name `firefox` is doing, we can run + +``` +sudo sysctl security.bsd.unprivileged_proc_debug=1 +truss firefox 2>&1 | grep -e menu +``` + ## Other issues Use the *Search or jump to…* field at the head of the main [https://github.com/helloSystem/](https://github.com/helloSystem/) page – above the helloSystem logo. This special page allows an organisation-wide search, across all helloSystem repositories. Click in the field, then begin typing. From 58f69afca91ca633be881ed67112a41b9c276ab7 Mon Sep 17 00:00:00 2001 From: Phillip Musumeci Date: Fri, 12 Mar 2021 08:39:42 +1000 Subject: [PATCH 288/592] Update architecture.md (#23) Missing word "of", small other change. (reading the docs for the first time so noting anything I see) --- developer/architecture.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/developer/architecture.md b/developer/architecture.md index 2fa5a5e4..658558e1 100644 --- a/developer/architecture.md +++ b/developer/architecture.md @@ -34,7 +34,7 @@ A Dock that shows icons for running and pinned applications. (In the future it s The `launch` command is used to launch applications without specifying a path to them. -The `launch` command is expected to determine the preferred instance of an application with the given name. (The `launch` command is supposed to find the _preferred_ instance, e.g., the one with the highest version, the one last put onto the system, etc.) Eventually the `launch` command should also get knowledge which application to open a file with. +The `launch` command is expected to determine the preferred instance of an application with the given name. (The `launch` command is supposed to find the _preferred_ instance, e.g., the one with the highest version, the one last put onto the system, etc.) Eventually the `launch` command should also gain knowledge of which application to open a file with. Filer is supposed to launch all applications through the `launch` command. Shell scripts, `.desktop` files, etc. should be written to use the `launch` command rather than hardcoding paths to applications, where appropriate. From 0bb61be3f96c15e1f5e6c2d608dc42cc9a611ab8 Mon Sep 17 00:00:00 2001 From: Phillip Musumeci Date: Fri, 12 Mar 2021 08:45:28 +1000 Subject: [PATCH 289/592] Update ux-guidelines.md (#22) Typo fix. --- developer/ux-guidelines.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/developer/ux-guidelines.md b/developer/ux-guidelines.md index 2a3dfe15..57d7b56a 100644 --- a/developer/ux-guidelines.md +++ b/developer/ux-guidelines.md @@ -4,7 +4,7 @@ Since helloSystem is intended to be friendly and welcoming to switchers from the ## Macintosh Human Interface Guidelines -What are the design principles that make user interfaces "Mac-like"? Apple spelled them out for us publicly 30 years ago in a book, the Macintosh Human Interface Guidelines. Besides descrbing what makes user interfaces "Mac-like", the book also explains general concepts like how to perform user testing. +What are the design principles that make user interfaces "Mac-like"? Apple spelled them out for us publicly 30 years ago in a book, the Macintosh Human Interface Guidelines. Besides describing what makes user interfaces "Mac-like", the book also explains general concepts like how to perform user testing. > If you are a designer, a human interface professional, or an engineer, this book contains information you can use to design and create products that fit the Macintosh model. It provides background information that can help you plan and make decisions about your product design. __Even if you don’t design and develop products for the Macintosh, reading this book will help you to understand the Macintosh interface.__ From 952098ed361335f8f6b1ff7860a673df92e7a8df Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 13 Mar 2021 12:57:14 +0100 Subject: [PATCH 290/592] Clarify AyatanaIndicators --- developer/menu.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/developer/menu.md b/developer/menu.md index 464d95d9..75f8866d 100644 --- a/developer/menu.md +++ b/developer/menu.md @@ -37,7 +37,7 @@ Those may or may not be used in helloSystem, they are mentioned here to give an * __Panel__: Ubuntu calls the widget at the top of the screen the "panel". In helloSystem, the rough equivalent is __Menu__. * [__Aytana__](https://wiki.ubuntu.com/Ayatana): The Buddhist term for a "sense base" or "sense sphere". A project by Canonical to improve user experience in Ubuntu. Abandoned? -* [__AyatanaIndicators__](https://github.com/AyatanaIndicators): tbd. A project that as of 2020 seems to be still pretty active on https://github.com/AyatanaIndicators. __With Ubuntu now using Gnome rather than Unity, what is this AytanaIndicators project doing?__ +* [__AyatanaIndicators__](https://ayatanaindicators.github.io/): "The Ayatana Indicators project is the continuation of Application Indicators, a technology developed by Canonical for the Unity desktop. Application Indicators are a GNOME implementation of the StatusNotifierItem Specification (SNI) that was originally submitted to freedesktop.org by KDE. The Ayatana Indicator project intends to become the new upstream for application indicators and associated projects with a focus on making Ayatana Indicators a desktop agnostic technology.". With Ubuntu now using GNOME rather than Unity, it is no longer developed by Canonical. UBports, MATE and XFCE are adopting AyatanaIndicators and Ubuntu are starting to migrate to it in 21.04. Some people say that StatusNotifierItems should be preferred since they are already more widely supported across the various desktops * [__Application Menu or appmenu__](https://wiki.ubuntu.com/DesktopExperienceTeam/ApplicationMenu): As part of Aytana, Canonical has produced an implementation called `indicator-appmenu` which re-routes Gtk and Qt menus over `dbusmenu` so that they appear in the panel * [__dbusmenu__](https://wiki.ubuntu.com/DesktopExperienceTeam/ApplicationIndicators#Software_Architecture): Library by Canonical implementing the transport protocol between the applications and the panel * [__libappindicator__](https://wiki.ubuntu.com/DesktopExperienceTeam/ApplicationIndicators#Software_Architecture): Library by Canonical to register icons and menus and internally uses dbusmenu to publish context menus over dbus. Needed for some applications (e.g., screenkey) to show icons in the upper right hand corner of the menu (system tray/notification area). The same as [`indicator-application`](https://launchpad.net/indicator-application)? From 43f3e9995c222225c3b4783a7fbd6ebad014e7ed Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 13 Mar 2021 13:04:25 +0100 Subject: [PATCH 291/592] StatusNotifierItem --- developer/menu.md | 1 + 1 file changed, 1 insertion(+) diff --git a/developer/menu.md b/developer/menu.md index 75f8866d..9955bd70 100644 --- a/developer/menu.md +++ b/developer/menu.md @@ -25,6 +25,7 @@ To provide this unified user experience, it is crucial that all applications can APIs can be described in specifications, protocols, and interfaces. +* [__StatusNotifierItem spec__](https://www.freedesktop.org/wiki/Specifications/StatusNotifierItem/): "This specification defines the management of visual items, usually icons used for reporting the status of an application to the user or provide a quick access to common actions performed by that application." Similar to what "tray icons" do on Windows. * [__DBusMenu protocol__](): Protocol for which implementations exist for Glib, Gtk, Qt (starting with Qt 2). Applications can export and import their menus (question: only indicators or all menus?) using this protocol. The specification used to be at https://people.canonical.com/~agateau/dbusmenu/spec/index.html but the link is dead as of 2020. On https://agateau.com/2009/statusnotifieritem-and-dbusmenu/ it is described as: "The goal of DBusMenu is to make it possible for applications using the StatusNotifierItem spec to send their menus over DBus, so that the workspace can display them in a consistent way, regardless of whether the application is written using Qt, GTK or another toolkit." Possibly it has significantly evolved since then? According to [__@ximion__](https://github.com/ximion), DBusMenu is a spec that transfers menus to status notifiers, and in combination with `com.canonical.AppMenu.Registrar` can be used for global menus. * [__org.gtk.Menus interface__](https://wiki.gnome.org/Projects/GLib/GApplication/DBusAPI#org.gtk.Menus): An interface defined by Gnome that "is primarily concerned with three things: communicating menus to the client, establishing links between menus and other menus, and notifying clients of changes". Note that "To do so, it employs a number of D-Bus interfaces. These interfaces are currently considered private implementation details of GApplication and subject to change - therefore they are not documented in the GIO documentation." ([Source](https://wiki.gnome.org/Projects/GLib/GApplication/DBusAPI#org.gtk.Menus)). __How does it relate to the DBusMenu protocol, does it have an overlapping scope or is it a complement?__ According to [__@ximion__](https://github.com/ximion), the `org.gtk.Menus` interface has nothing to do with DBusMenu and was only for the Gnome Shell global menu (deprecated in Gnome). __Why was it deprecated in Gnome Shell and what is the replacement?__ * [__com.canonical.AppMenu.Registrar D-Bus Service__](): `com.canonical.AppMenu.Registrar`, an interface to register a menu from an application's window to be displayed in another window. This manages that association between XWindow Window IDs and the dbus address and object that provides the menu using the dbusmenu dbus interface. ([Source](https://github.com/KDE/plasma-workspace/blob/master/appmenu/com.canonical.AppMenu.Registrar.xml)). "Appmenu registrar allows other applications to access any active window's application menu tree. Such a registrar is extremely useful for, e.g. implementing global menus (application menus appear in the top panel bar of the desktop environment, and for adding an application menu browser or search engine to HUDs" ([Source](https://packages.debian.org/buster/appmenu-registrar)). __How does it relate to the DBusMenu protocol, does it have an overlapping scope or is it a complement?__ From 46ca934ef63c1ce2fca051e60ddbae7268ee5ca2 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 15 Mar 2021 20:02:48 +0100 Subject: [PATCH 292/592] Update binary-compatibility.md --- developer/binary-compatibility.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/developer/binary-compatibility.md b/developer/binary-compatibility.md index 08deecef..7488050f 100644 --- a/developer/binary-compatibility.md +++ b/developer/binary-compatibility.md @@ -16,7 +16,9 @@ Binary compatibility is an important concept in software engineering. It allows ### Recommendation for building binary compatible applications -Build on the `.0` minor version for each still-supported major version of FreeBSD, using `quarterly` or older packages. This should allow the application to run on all still-supported FreeBSD releases. +Build on the `.0` minor version for each still-supported major version of FreeBSD, using `release_0`, `release_1`, `release_2`,... but __NOT__ `quarterly`, `latest` packages as those are moving targets which will vanish over time. + +This should allow the application to run on all still-supported FreeBSD releases. ## Kernel module compatibility From 4e9ba1a4dbb178ee1a37d8057eb0bdc69ebae73e Mon Sep 17 00:00:00 2001 From: probonopd Date: Wed, 17 Mar 2021 18:55:42 +0100 Subject: [PATCH 293/592] Update boot.md --- developer/boot.md | 17 ++++++++++++++++- 1 file changed, 16 insertions(+), 1 deletion(-) diff --git a/developer/boot.md b/developer/boot.md index 09e8df82..8694f57e 100644 --- a/developer/boot.md +++ b/developer/boot.md @@ -28,7 +28,22 @@ This is a simplified description of the boot process. There may be additional as ### Seeing what the system is doing while the graphical boot screen is shown -While the graphical boot screen is being displayed you can press __Ctrl+T__ to see what it is doing at that moment in time. Press __Ctrl+T__ repeatedly to see what is going on over time. +While the graphical boot screen is being displayed you can press __Ctrl+T__ to see what it is doing at that moment in time. By keeping __Ctrl+T__ __pressed down__ you can see what is going on over time. By then pressing __ScrLk__, you can use __PgUp__ and __PgDn__ to scroll around. + +The following information will be printed to the screen for the most relevant process based on recency and CPU usage (as decided by `proc_compare()`): + +* `load:` and the 1 minute load average of the system +* `cmd:` and process name of the most relevant process +* Process ID (PID) of that process +* State of that process in `[]`. FreeBSD specific wait states are explained in https://wiki.freebsd.org/WaitChannels +* Real (r), User (u), and System (s) times ([Source](https://stackoverflow.com/a/556411)) + * Real is wall clock time - time from start to finish of the call. This is all elapsed time including time slices used by other processes and time the process spends blocked (for example if it is waiting for I/O to complete) + * User is the amount of CPU time spent in user-mode code (outside the kernel) _within_ the process. This is only actual CPU time used in executing the process. Other processes and time the process spends blocked do not count towards this figure + * Sys is the amount of CPU time spent _in the kernel for the process_. This means executing CPU time spent in system calls within the kernel, as opposed to library code, which is still running in user-space +* CPU usage in percent +* Resident set size (RSS), the amount of memory occupied in RAM by the most relevant process + +Example: `load: 0.62 cmd: sleep 1739 [nanslp] 2.97r 0.00u 0.00s 0% 2168k` ### Boot in verbose mode From a13d682145e11b5457f8be329b55a6b93f3be972 Mon Sep 17 00:00:00 2001 From: probonopd Date: Thu, 18 Mar 2021 19:10:33 +0100 Subject: [PATCH 294/592] Create ports.md [ci skip] --- developer/ports.md | 90 ++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 90 insertions(+) create mode 100644 developer/ports.md diff --git a/developer/ports.md b/developer/ports.md new file mode 100644 index 00000000..ac6649c5 --- /dev/null +++ b/developer/ports.md @@ -0,0 +1,90 @@ +# Working with FreeBSD Ports + +In some situations it may be necessary to make changes to existing software that comes in FreeBSD packages. +This section describes how to make such changes using an example. + +## Example + +Suppose you would like to make a small change to the source code of software that comes as a FreeBSD package. Since packages are built from FreeBSD Ports, you need to modify the corresponding FreeBSD port. + +Here is a real-life example on how to do that: + +https://github.com/lxqt/qterminal/issues/474 can be fixed by changing a few lines in + +https://github.com/lxqt/qtermwidget/blob/059d832086facb19035a07d975ea4fd05d36b1ec/lib/TerminalDisplay.cpp#L3206 + +Here is how to do it using FreeBSD Ports: + +## Building the port without changes + +Build the port without changes first to ensure it builds and works as expected. + +``` +# Build the library +# NOTE: Applications that have a library that is used by nothing but that application are just +# annoying because now you have to deal with two entities rather than one +cd /usr/ports/x11-toolkits/qtermwidget/ +MAKE_JOBS_UNSAFE=yes ALLOW_UNSUPPORTED_SYSTEM=1 sudo -E make -j4 + +# Build the application +cd /usr/ports/x11/qterminal +QTermWidget5_DIR=/usr/ports/x11-toolkits/qtermwidget/work/stage/usr/local/lib/cmake/qtermwidget5/ MAKE_JOBS_UNSAFE=yes ALLOW_UNSUPPORTED_SYSTEM=1 sudo -E make -j4 + +# Run the application with the changed library +LD_LIBRARY_PATH=/usr/ports/x11-toolkits/qtermwidget/work/stage/usr/local/lib/ /usr/ports/x11/qterminal/work/stage/usr/local/bin/qterminal +``` + +## Making changes to the port + +Now make changes to the port. + +``` .. note:: + In the ports system you cannot just change the source code because it would be overwritten during the build process. +You first need to make a copy of the source code, then make the changes in the copy, then create a patch that will get applied automatically at build time. +``` + +``` +# Copy the file to be changed +cd /usr/ports/x11-toolkits/qtermwidget +sudo cp work/qtermwidget-*/lib/TerminalDisplay.cpp work/qtermwidget-*/lib/TerminalDisplay.cpp.orig + +# Make the change in the library +sudo nano work/qtermwidget-*/lib/TerminalDisplay.cpp + dropText += QLatin1Char('\''); + dropText += urlText; + dropText += QLatin1Char('\''); + dropText += QLatin1Char(' '); + +# Make a patch +sudo make makepatch + +# Build the library again +# sudo make clean # Run this only if the next line does nothing +MAKE_JOBS_UNSAFE=yes ALLOW_UNSUPPORTED_SYSTEM=1 sudo -E make -j4 + +# Run the application with the changed library +LD_LIBRARY_PATH=/usr/ports/x11-toolkits/qtermwidget/work/stage/usr/local/lib/ /usr/ports/x11/qterminal/work/stage/usr/local/bin/qterminal +``` + +As a result we have a patch: + +``` +% cat files/patch-lib_TerminalDisplay.cpp +--- lib/TerminalDisplay.cpp.orig 2020-11-03 08:19:26 UTC ++++ lib/TerminalDisplay.cpp +@@ -3099,10 +3099,10 @@ void TerminalDisplay::dropEvent(QDropEvent* event) + // without quoting them (this only affects paths with spaces in) + //urlText = KShell::quoteArg(urlText); + +- dropText += urlText; +- +- if ( i != urls.count()-1 ) +- dropText += QLatin1Char(' '); ++ dropText += QLatin1Char('\''); ++ dropText += urlText; ++ dropText += QLatin1Char('\''); ++ dropText += QLatin1Char(' '); + } + } + else +``` From 867e4a1937c100059b52374ca0b3089bb06ba1a7 Mon Sep 17 00:00:00 2001 From: probonopd Date: Thu, 18 Mar 2021 19:11:06 +0100 Subject: [PATCH 295/592] Update index.md --- index.md | 1 + 1 file changed, 1 insertion(+) diff --git a/index.md b/index.md index 0b713052..d4a97ac1 100644 --- a/index.md +++ b/index.md @@ -48,6 +48,7 @@ __hello__ (also known as __helloSystem__) is a desktop system for creators with developer/building developer/tracing developer/localization + developer/ports developer/distributions developer/acknowledgements developer/contact From 18a1fa5fd9ddd0d1f97c6681a03c6ea193fdb963 Mon Sep 17 00:00:00 2001 From: probonopd Date: Thu, 18 Mar 2021 19:12:36 +0100 Subject: [PATCH 296/592] Making packages --- developer/ports.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/developer/ports.md b/developer/ports.md index ac6649c5..0dd9606c 100644 --- a/developer/ports.md +++ b/developer/ports.md @@ -88,3 +88,19 @@ As a result we have a patch: } else ``` + +## Making packages + +Optionally, make packages for the ports. Note that `make build` needs to have run already before this step. + +``` +# Library +cd /usr/ports/x11-toolkits/qtermwidget/ +sudo make package +ls work/pkg + +# Application +cd /usr/ports/x11/qterminal +sudo make package +ls work/pkg +``` From fb025f8655abb8b45e1154b553cf2dac10004bde Mon Sep 17 00:00:00 2001 From: probonopd Date: Thu, 18 Mar 2021 19:19:21 +0100 Subject: [PATCH 297/592] Installing the ports tree --- developer/ports.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/developer/ports.md b/developer/ports.md index 0dd9606c..135d1a7f 100644 --- a/developer/ports.md +++ b/developer/ports.md @@ -15,6 +15,16 @@ https://github.com/lxqt/qtermwidget/blob/059d832086facb19035a07d975ea4fd05d36b1e Here is how to do it using FreeBSD Ports: +## Installing the ports tree + +Unfortunately one has to download/update the whole ports tree, containing all available ports, even if one just wants to make a change to one or a few of the ports. + +``` +sudo portsnap fetch +sudo portsnap fetch update +sudo portsnap extract +``` + ## Building the port without changes Build the port without changes first to ensure it builds and works as expected. From 01ad8cf541d43bc81965cd35fa50a397c4c4ede1 Mon Sep 17 00:00:00 2001 From: probonopd Date: Thu, 18 Mar 2021 21:08:11 +0100 Subject: [PATCH 298/592] Try to get rid of the .html extension in URLs --- buildDocs.sh | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/buildDocs.sh b/buildDocs.sh index 85a30c44..e1d7c41f 100644 --- a/buildDocs.sh +++ b/buildDocs.sh @@ -37,7 +37,8 @@ export SOURCE_DATE_EPOCH=$(git log -1 --pretty=%ct) # build our documentation with sphinx (see ./conf.py) # * https://www.sphinx-doc.org/en/master/usage/quickstart.html#running-the-build make clean -make html +# make html +make dirhtml make epub make qthelp qcollectiongenerator _build/qthelp/*.qhcp From 57e1668d1637333b7dee1a3cee4ba063ab076e7e Mon Sep 17 00:00:00 2001 From: probonopd Date: Thu, 18 Mar 2021 21:11:53 +0100 Subject: [PATCH 299/592] Revert --- buildDocs.sh | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/buildDocs.sh b/buildDocs.sh index e1d7c41f..85a30c44 100644 --- a/buildDocs.sh +++ b/buildDocs.sh @@ -37,8 +37,7 @@ export SOURCE_DATE_EPOCH=$(git log -1 --pretty=%ct) # build our documentation with sphinx (see ./conf.py) # * https://www.sphinx-doc.org/en/master/usage/quickstart.html#running-the-build make clean -# make html -make dirhtml +make html make epub make qthelp qcollectiongenerator _build/qthelp/*.qhcp From ea90205eb75b9a8898bea951bf6e98f63dd10e61 Mon Sep 17 00:00:00 2001 From: probonopd Date: Fri, 26 Mar 2021 19:24:45 +0100 Subject: [PATCH 300/592] Update ports.md --- developer/ports.md | 122 +++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 122 insertions(+) diff --git a/developer/ports.md b/developer/ports.md index 135d1a7f..e4d7bacf 100644 --- a/developer/ports.md +++ b/developer/ports.md @@ -114,3 +114,125 @@ cd /usr/ports/x11/qterminal sudo make package ls work/pkg ``` + +## Creating a port from scratch + +The [FreeBSD Porter's Handbook](https://docs.freebsd.org/en_US.ISO8859-1/books/porters-handbook/quick-porting.html#porting-makefile) is the authoritative source on how to write Ports. This section shows a hands-on example on how to package a set of tools from a GitHub repository. + + +``` .. note:: + This section is a work in progress. Corrections are welcome. +``` + +First, prepare the Ports environment: + +``` +sudo bash +pkg install portlint +echo DEVELOPER=yes >> /etc/make.conf +portsnap fetch extract update # Run this from time to time +``` + +Next, create a directory for the new port: + +``` +mkdir /usr/ports/sysutils/fluxengine +cd /usr/ports/sysutils/fluxengine +``` + +Create `Makefile` with the following content: + +``` +# $FreeBSD$ + +PORTNAME= fluxengine +DISTVERSION= 572 +CATEGORIES= sysutils + +MAINTAINER= probono@puredarwin.org +COMMENT= USB floppy disk interface for reading and writing non-PC disk formats + +LICENSE= MIT + +LIB_DEPENDS= libsqlite3.so:databases/sqlite3 \ + libstdc++.so:lang/gcc9 + +BUILD_DEPENDS= ninja:devel/ninja + +USES= gmake + +USE_GITHUB= yes +GH_ACCOUNT= davidgiven +GH_TAGNAME= 61ff48c + +PLIST_FILES= bin/brother120tool \ + bin/brother240tool \ + bin/fluxengine + +do-install: + ${INSTALL_PROGRAM} ${WRKSRC}/brother120tool ${STAGEDIR}${PREFIX}/bin/ + ${INSTALL_PROGRAM} ${WRKSRC}/brother240tool ${STAGEDIR}${PREFIX}/bin/ + ${INSTALL_PROGRAM} ${WRKSRC}/fluxengine ${STAGEDIR}${PREFIX}/bin/ + +.include +``` + +Notes +* See `ls /usr/ports/` for possible categories, such as `sysutils` +* See [5.2. Naming](https://docs.freebsd.org/en_US.ISO8859-1/books/porters-handbook/makefile-naming.html) for naming and versioning conventions +* The lines must be in a defined order. Run `portlint` to get information on this and re-order until it no longer complains +* Run `make stage-qa` to find out dependencies + +Create `pkg-descr` based on the description on the GitHub [README.md](https://github.com/davidgiven/fluxengine): + +``` +The FluxEngine is a very cheap USB floppy disk interface capable of +reading and writing exotic non-PC floppy disk formats. +It allows you to use a conventional PC drive to accept Amiga disks, +CLV Macintosh disks, bizarre 128-sector CP/M disks, +and other weird and bizarre formats. + : +The hardware consists of a single, commodity part with a floppy drive +connector soldered onto it. No ordering custom boards, +no fiddly surface mount assembly, and no fuss: +nineteen simpler solder joints and you're done. + +WWW: http://cowlark.com/fluxengine/ +``` + +Notes +* For details please refer to [3.2. Writing the Description Files](https://docs.freebsd.org/en_US.ISO8859-1/books/porters-handbook/porting-desc.html). + +Create the checksum file by running + +``` +ALLOW_UNSUPPORTED_SYSTEM=YES make makesum +``` + +Check the Makefile with + +``` +portlint +``` + +and correct any mistakes it reports, then repeat. + +Once `portlint` says `looks fine`, try to build by running + +``` +ALLOW_UNSUPPORTED_SYSTEM=YES make +``` + +Note that the compilation will fail. This is because in this case the application needs to be built with `gmake` rather than `make`. + +Run tests + +``` +make stage +make stage-qa +make package +make install +make deinstall +``` + +None of these must produce errors. See [3.4. Testing the Port](https://docs.freebsd.org/en_US.ISO8859-1/books/porters-handbook/porting-testing.html) for details. From dc92e14021bae31623dad3515a81ecca792ba7cd Mon Sep 17 00:00:00 2001 From: probonopd Date: Fri, 26 Mar 2021 19:26:47 +0100 Subject: [PATCH 301/592] Update ports.md --- developer/ports.md | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/developer/ports.md b/developer/ports.md index e4d7bacf..912259d3 100644 --- a/developer/ports.md +++ b/developer/ports.md @@ -117,7 +117,7 @@ ls work/pkg ## Creating a port from scratch -The [FreeBSD Porter's Handbook](https://docs.freebsd.org/en_US.ISO8859-1/books/porters-handbook/quick-porting.html#porting-makefile) is the authoritative source on how to write Ports. This section shows a hands-on example on how to package a set of tools from a GitHub repository. +The [FreeBSD Porter's Handbook](https://docs.freebsd.org/en_US.ISO8859-1/books/porters-handbook/quick-porting.html#porting-makefile) is the authoritative source on how to write new ports from scratch. This section shows a hands-on example on how to package a set of tools from a GitHub repository. ``` .. note:: @@ -182,6 +182,7 @@ Notes * See [5.2. Naming](https://docs.freebsd.org/en_US.ISO8859-1/books/porters-handbook/makefile-naming.html) for naming and versioning conventions * The lines must be in a defined order. Run `portlint` to get information on this and re-order until it no longer complains * Run `make stage-qa` to find out dependencies +* The `do-install` section is needed in this example because there is no `make install` in the original software's Makefile Create `pkg-descr` based on the description on the GitHub [README.md](https://github.com/davidgiven/fluxengine): @@ -236,3 +237,5 @@ make deinstall ``` None of these must produce errors. See [3.4. Testing the Port](https://docs.freebsd.org/en_US.ISO8859-1/books/porters-handbook/porting-testing.html) for details. + +At this point it may be a good idea to have an experienced FreeBSD Ports developer have a look at your new port. From ecbccd73c024f65e668b28dddf0546c0ea9553a9 Mon Sep 17 00:00:00 2001 From: probonopd Date: Fri, 26 Mar 2021 19:33:05 +0100 Subject: [PATCH 302/592] Correct link [ci skip] --- developer/ports.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/developer/ports.md b/developer/ports.md index 912259d3..5f887c8d 100644 --- a/developer/ports.md +++ b/developer/ports.md @@ -117,7 +117,7 @@ ls work/pkg ## Creating a port from scratch -The [FreeBSD Porter's Handbook](https://docs.freebsd.org/en_US.ISO8859-1/books/porters-handbook/quick-porting.html#porting-makefile) is the authoritative source on how to write new ports from scratch. This section shows a hands-on example on how to package a set of tools from a GitHub repository. +The [FreeBSD Porter's Handbook](https://docs.freebsd.org/en_US.ISO8859-1/books/porters-handbook/) is the authoritative source on how to write new ports from scratch. This section shows a hands-on example on how to package a set of tools from a GitHub repository. ``` .. note:: From 73b34ad1a54662591f0f49ff8e32ef987a751f50 Mon Sep 17 00:00:00 2001 From: probonopd Date: Fri, 26 Mar 2021 19:42:40 +0100 Subject: [PATCH 303/592] Update ports.md --- developer/ports.md | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/developer/ports.md b/developer/ports.md index 5f887c8d..f47ca15b 100644 --- a/developer/ports.md +++ b/developer/ports.md @@ -128,7 +128,7 @@ First, prepare the Ports environment: ``` sudo bash -pkg install portlint +pkg install portlint subversion echo DEVELOPER=yes >> /etc/make.conf portsnap fetch extract update # Run this from time to time ``` @@ -239,3 +239,11 @@ make deinstall None of these must produce errors. See [3.4. Testing the Port](https://docs.freebsd.org/en_US.ISO8859-1/books/porters-handbook/porting-testing.html) for details. At this point it may be a good idea to have an experienced FreeBSD Ports developer have a look at your new port. + +Once everything looks good, prepare a `.shar` file for submitting it to https://bugs.freebsd.org/submit/: + +``` +rm -rf work/ +cd .. +tar cf fluxengine.shar --format shar fluxengine +``` From 8c9e69bfbf51699d54a6a20101241eb318f4402e Mon Sep 17 00:00:00 2001 From: probonopd Date: Fri, 26 Mar 2021 20:05:24 +0100 Subject: [PATCH 304/592] Create filer-context-menus.md --- developer/filer-context-menus.md | 1690 ++++++++++++++++++++++++++++++ 1 file changed, 1690 insertions(+) create mode 100644 developer/filer-context-menus.md diff --git a/developer/filer-context-menus.md b/developer/filer-context-menus.md new file mode 100644 index 00000000..e30c481e --- /dev/null +++ b/developer/filer-context-menus.md @@ -0,0 +1,1690 @@ +# Extending Filer context menus + +It is possible to extend Filer context menu items by writing files that conform to the __DES-EMA__ (Desktop Entry Specification - Extension for Menus and Actions). Apparently this format was never adopted as a standard, so it is documented here. The information on this page is based on [draft 0.15](https://gitlab.gnome.org/GNOME/filemanager-actions/-/blob/NAUTILUS_ACTIONS_3_2_4/docs/des-ema/des-ema-0.15) from November 23, 2010. + +``` .. note:: + Filer inherits its DES-EMA implementation from PCManFM, and may use a different format in the future. + +It still needs to be verified which portions have actually been implemented in Filer, so currently this page describes functionality which may or may not be implemented in Filer. Corrections are welcome. +``` + +## Examples + +### An example of an action + +In the following example, we define an "Open terminal here" action, which has three profiles. These profiles are thought to be able to open a suitable terminal in most situations. They are ordered, and so only the first profile whose conditions are met at runtime will be used in the Filer context menu. + +``` +[Desktop Entry] +Name=Open terminal here +Tooltip=Open a new terminal here +Icon=terminal +Profiles=on_folder; on_file; on_desktop; + +[X-Action-Profile on_folder] +Name=open a terminal on the current folder or on the selected folder +MimeTypes=inode/directory; +# note that this means strictly less than 2, as the equal sign is part of the DES syntax +SelectionCount=< 2 +Exec=launch QTerminal --workdir %d + +[X-Action-Profile on_file] +Name=open a terminal in the folder which contains selected items +MimeTypes=all/allfiles; +Exec=launch QTerminal --workdir $(echo %D | cut -d ' ' -f 1) + +[X-Action-Profile on_desktop] +Name=open a terminal of the desktop +Schemes=x-nautilus-desktop; +Exec=launch QTerminal --workdir ~/Desktop +``` + +This may be saved, e.g. as `~/.local/share/file-manager/actions/open-terminal.desktop` file. + +Note that this is only an example of how an action may be defined in a `.desktop` file. It has not been deeply tested, and there is most probably more efficient ways of opening a terminal somewhere... + +### An example of a menu + +Suppose we would like to place the menu elements into a submenu. To achieve this, we create a second `.desktop` file with following content: + +``` +[Desktop Entry] +Type=Menu +Name=Terminal menu +Tooltip=Terminal submenu +Icon=terminal-group +ItemsList=open-terminal; +``` + +This may be saved, e.g. as `~/.local/share/file-manager/actions/menu-terminal.desktop` file. + +## Desktop file + +#### Desktop file format + +This specification relies on the common syntax defined in the [Desktop Entry Specification](http://standards.freedesktop.org/desktop-entry-spec/desktop-entry-spec-latest.html). Here is a summary of some main points: + +* Files are UTF-8 encoded. +* All keys and values are case sensitive. +* The `[Desktop Entry]` group must be the first group of the file. +* Boolean values must be `true` or `false`. +* Strings, in strings lists, are semicolon-separated; the list itself ends with a semicolon. + +#### Desktop file identifier + +In the rest of this specification, when a desktop file needs to be identified, we are using the basename of the file, without the extension, calling this a _desktop_file_id_. + +#### Desktop files search path + +`.desktop` files are searched for in `XDG_DATA_DIRS/file-manager/actions` directories. All used _desktop_file_id_s should be unique. + +## Managed objects + +#### Actions and profiles + +This specification essentially defines how actions are to be described in `.desktop` files in order to be displayed in the Filer context menu, and available as selectable items to be executed by the user. + +An action might be defined as a group of several elements: + +* the displayable part: label, tooltip, icon +* conditions which have to be met in order the item be actually displayed in the context menu; these conditions are checked against the current Filer selection; these might be mimetypes, scheme, etc. +* the command to be executed, and its parameters. + +As a user might want have the very same action execute a different command depending of the current environment at runtime, we define that an action is built on one to several profiles, where each profile is defined by: + +* conditions which have to be met in order the item be actually displayed in the context menu; these conditions are checked against the current Filer selection; these might be mimetypes, scheme, etc. +* the command to be executed, and its parameters. + +#### Menus + +This specification also defines how these actions may be gathered and ordered in menus, and submenus, and so on. + +A menu is defined by: + +* its displayable part: label, tooltip, icon +* conditions which are to be met in order the menu, and recursively all of its subitems, be actuelly displayed in the Filer context menu +* the ordered list of the items in the menu. + +#### Conditions + +As we are dealing with three level of objects (menus, actions, profiles), it appears that whether a condition must be defined at one of these levels is rather an arbitrary decision. + +We so say that conditions may appear in any of these levels: + +* When a condition appears in a menu definition, the result of its evaluation recursively applies to all included items. If the condition is not met, then neither the menu nor any of its subitems will be displayed. +* When a condition appears in an action definition, the result of its evaluation applies to all its profiles. If the condition is not met, then the action will not be candidate; the profiles will even not be considered. + +## Action definition + +An action must be entirely defined in one `.desktop` file. The action is identified by the _desktop_file_id_ in which it is defined. + +Only valid actions are displayed in the Filer context menu. + +To be valid, an action must have a non-empty name, and at least one profile must be found valid at runtime. + +As stated + +An action is primarily defined in the `[Desktop Entry]` group, which has following keys: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
**Key****Description****Value type****Req ?**
`Type`This define this `.desktop` file as an Action definition. +Defaults to `Action`.stringno
`Name`The label of the action, as it should appear in the context menu. +localestringYES
`Tooltip`The tooltip associated with the item in the context menu. +Defaults to empty.localestringno
`Icon`The name of a themed icon, or the path to an icon. +Defaults to empty.localestringno
`Description`A free description of the action, which may be used in the management UI, in a Web page, and so on. +Defaults to empty.localestringno
`SuggestedShortcut`A shortcut suggested for the action. +Please note that this might be only a suggestion as the shortcut may be already reserved for another use. Implementation should not override an already existing shortcut to define this one. +The format may look like `a` or `F1`. +Defaults to empty.stringno
`Enabled`Whether the item is candidate to be displayed in the context menu. +A user might define many actions or menus, and choose to only enable some of them from time to time. +Defaults to `true`.booleanno
`Hidden`From [DES](http://standards.freedesktop.org/desktop-entry-spec/desktop-entry-spec-latest.html): `Hidden` should have been called `Deleted`. It means the user deleted (at his level) something that was present (at an upper level, e.g. in the system dirs). It's strictly equivalent to the `.desktop` file not existing at all, as far as that user is concerned. This can also be used to "uninstall" existing files (e.g. due to a renaming) - by letting make install install a file with `Hidden=true` in it. +Defaults to `false`.booleanno
`TargetContext`Whether the item targets the Filer context menu. +This means that the action will be candidate if defined conditions met the current selection. +Defaults to `true`.booleanno
`TargetLocation`Whether the item targets a location menu, if Filer supports this. +This means that the action will be candidate if defined conditions met the current location. +Defaults to `false`.booleanno
`TargetToolbar`Whether the item targets the toolbar, if Filer supports this. +Note that, in order to keep a nice and stable UI, the Filer may reserve toolbar actions to those only targeting the current folder. +Defaults to `false`.booleanno
`ToolbarLabel`The label to be displayed in the toolbar, if it is not the same that those displayed in context menu. +Defaults to `Name` value.localestringno
`Profiles` + +The ordered list of the profiles attached to this action. +Each element of this strings list may be: + +* a _profile_id_, _i.e._ the id of a profile, as an ASCII string +* a command to be executed, if the string is enclosed between square brackets (`[`...`]`). + +So, `Profiles` key has a dynamic value: if an element of the string list is enclosed between square brackets (`[`...`]`), it is considered as a command, optionally with + +After reading, and maybe evaluation of dynamic elements, profiles identified by the `Profiles` value, but not found in this `.desktop` file, are just ignored. + +It is up to the implementation to decide whether profiles found in this `.desktop` file, but not identified in this list, should or not be attached to the action. +It could be for example an acceptable fallback to append these "orphan" profiles at the end of the list of profiles. +Another choice might also be: + +* at runtime, only attach to the action profiles which are listed in this `Profiles` key +* while a management UI may load all profiles found in the `.desktop` file. + +strings listYES
+ +## Profile definition + +Profile is identified by its _profile_id_, as an ASCII string. + +Each profile defined in the `Profiles` key, whether statically by its _profile_id_ identifier, or as the result of an evaluated command, must be defined in a `[X-Action-Profile _profile_id_]` group. + +When several profiles are defined for an action, only the first valid profile whose conditions are met at runtime is selected to be made available in the context menu. + +Defining several profiles let so the user have an ordered OR-ed set of conditions, i.e. have one action be available if one set of conditions is met, OR this same action, though most probably with a slightly different command, be available if another set of conditions is met, and so on. + +In order to be valid, a profile must at least have an executable command. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
**Key****Description****Value type****Req ?**
`Name`The name of the profile; this name is not displayed in the context menu, and should just be thought as a convenience for the management UI. It may also be seen as a good place for a description of what the profile exactly does. +Defaults to empty.localestringno
`Exec`From [DES](http://standards.freedesktop.org/desktop-entry-spec/desktop-entry-spec-latest.html): command to execute, possibly with arguments +stringYES
`Path`The working directory the program should be started in. +Defaults to base directory of the current selection, which happens to be the value of `%d` parameter.stringno
`ExecutionMode`Execution mode of the program. +This may be chosen between following values: + +* `Normal`: Starts as a standard graphical user interface +* `Terminal`: Starts the preferred terminal of the graphical environment, and runs the command in it +* `Embedded`: Makes use of a special feature of the file manager which allows a terminal to be ran inside of it; an acceptable fallback is `Terminal` +* `DisplayOutput`: The ran terminal may be closed at end of the command, but standard streams (stdout, stderr) should be collected and displayed; an acceptable fallback is `Terminal` + +Defaults to `Normal`.stringno
`StartupNotify`From [DES](http://standards.freedesktop.org/desktop-entry-spec/desktop-entry-spec-latest.html): if `true`, it is KNOWN that the application will send a "remove" message when started with the DESKTOP_STARTUP_ID environment variable set. If `false`, it is KNOWN that the application does not work with startup notification at all (does not shown any window, breaks even when using StartupWMClass, etc.). If absent, a reasonable handling is up to implementations (assuming false, using StartupWMClass, etc.). (See the [Startup Notification Protocol Specification](http://www.freedesktop.org/Standards/startup-notification-spec) for more details). +Only relevant when `ExecutionMode=Normal`. +Defaults to `false`.booleanno
`StartupWMClass`From [DES](http://standards.freedesktop.org/desktop-entry-spec/desktop-entry-spec-latest.html): if specified, it is known that the application will map at least one window with the given string as its WM class or WM name hint (see the [Startup Notification Protocol Specification](http://www.freedesktop.org/Standards/startup-notification-spec) for more details). +Only relevant when `ExecutionMode=Normal`. +Defaults to empty.stringno
`ExecuteAs`The user the command must be ran as. The user may be identified by its numeric UID or by its login. +The implementation should ignore a profile defining a non-existing UID or login as a value for the `ExecuteAs` key. +The implementation might require the presence of a well-configured subsystem (e.g. sudo). +Defaults to empty: the command will be executed as the current user.stringno
+ +## Menu definition + +Just as an action, a menu has label, tooltip, icon. + +But, where an action is intended to eventually execute a command, a menu is just a way of gathering some subitems, actions or menus, in an ordered list. + +In order to be valid, a menu must have a non-empty name, and include at least one valid subitem. + +It is the responsability of the implementation to ensure that the displayed menus are relevant, _i.e._ not empty, with no separator at the begin or the end of the menu, with no double separator, etc. + +As stated + +The menu is so defined as a particular case of a `.desktop` file, identified by its _desktop_file_id_, whose the `[Desktop Entry]` section has following keys: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
**Key****Description****Value type****Req ?**
`Type`This define this `.desktop` file as a Menu definition. +Must be equal to `Menu`.stringYES
`Name`The label of the menu, as it should appear in the context menu. +localestringYES
`Tooltip`The tooltip associated with the submenu in the context menu. +Defaults to empty.localestringno
`Icon`The name of a themed icon, or the path to an icon, to be associated to the submenu. +Defaults to empty.localestringno
`Description`A free description of the menu, which may be used in the management UI, in a Web page, and so on. +Defaults to empty.localestringno
`SuggestedShortcut`A shortcut suggested for the menu. +Please note that this might be only a suggestion as the shortcut may be already reserved for another use. Implementation should not override an already existing shortcut to define this one. +The format may look like `a" or `F1". +Defaults to empty.stringno
`Enabled`Whether the item is candidate to be displayed in the context menu. +A user might define many actions or menus, and choose to only enable some of them from time to time. +Defaults to `true`.booleanno
`Hidden`From [DES](http://standards.freedesktop.org/desktop-entry-spec/desktop-entry-spec-latest.html): `Hidden` should have been called `Deleted`. It means the user deleted (at his level) something that was present (at an upper level, e.g. in the system dirs). It's strictly equivalent to the `.desktop` file not existing at all, as far as that user is concerned. This can also be used to "uninstall" existing files (e.g. due to a renaming) - by letting make install install a file with `Hidden=true` in it. +Defaults to `false`.booleanno
`ItemsList` + +The ordered list of the subitems (actions or menus) attached to this menu. +Each element of this strings list may be: + +* the id of an action or a menu, +* a command to be executed, if the string is enclosed between square brackets (`[`...`]`). + +So, `ItemsList` key has a dynamic value: if an element of the string list is enclosed between square brackets (`[`...`]`), it is considered as a command, optionally with + +The keyword `SEPARATOR` is a special case of _desktop_file_id_. It may be used to define a separator in the menu. + +Actions or menus identified here as a subitem of a menu should not be redisplayed elsewhere. + +Actions or menus not identified here, or not identified as subitems of a menu or of a submenu, should not be ignored by the implementation; instead of that, the implementation should display these "orphan" items, most probably at the level zero of the hierarchy (though in a unspecified order). + +strings listYES
+ +## Conditions + +As a remainder of that has been said above, each one of the following conditions may appear in a menu, an action or a profile. + +Conditions are AND-ed, that is all specified conditions which appear in a menu, an action or a profile must be met in order the item be considered as a candidate. + +When a condition is defined as a string list, elements of the list are considered as OR-ed (but for When an element of the string list is negated, it must be considered as an AND condition. + +Example: + +> The line "`MimeTypes = image/*; video/*;`" must be read as "condition is met if each file in the current selection has a mimetype of `image/*` or of `video/*`" +> +> And the line "`MimeTypes = image/*; video/*; !image/bmp`" must be read as "condition is met if each file in the current selection has a mimetype of `image/*` or of `video/*`, but must not have the `image/bmp` mimetype". + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
**Key****Description****Value type****Req ?**
`OnlyShowIn`, +`NotShowIn`From [DES](http://standards.freedesktop.org/desktop-entry-spec/desktop-entry-spec-latest.html): a list of strings identifying the environments that should display/not display a given desktop entry. Only one of these keys, either `OnlyShowIn` or `NotShowIn`, may appear in a group (for possible values see the [Desktop Menu Specification](http://www.freedesktop.org/Standards/menu-spec)). +Defaults to show anywhere.strings listno
`TryExec`Fromn [DES](http://standards.freedesktop.org/desktop-entry-spec/desktop-entry-spec-latest.html): path to an executable file on disk used to determine if some program is actually installed. If the path is not an absolute path, the file is looked up in the $PATH environment variable. If the file is not found or is not executable, this condition evals to `false`. +Defaults to successful.stringno
`ShowIfRegistered`The well-known name of a DBus service. +The item will be candidate if the named service is registered on session DBus at runtime. +Defaults to successful. + + + + + + + + + + + + + + + +
_Comment:__This is the equivalent of KDE `X-KDE-ShowIfRunning` key._
+ +
stringno
`ShowIfTrue`A command which, when executed, should output a string on stdout. +The item will be candidate if the outputed string is equal to `true`. +Example: `[ -r %d/.svn/entries ] && echo \"true\` +Defaults to successful. + + + + + + + + + + + + + + + +
_Comment:__This is the equivalent of KDE `X-KDE-ShowIfDBusCall` key, extended to any command able to output a string._
+ +
stringno
`ShowIfRunning`The name of a process. +The item will be candidate if the process name is found in memory at runtime. +Defaults to successful.stringno
`MimeTypes`From [DES](http://standards.freedesktop.org/desktop-entry-spec/desktop-entry-spec-latest.html): the MIME type(s) supported by this application. +Each mimetype may be fully specified (e.g. `audio/mpeg;`), or as a group (e.g. `image/*;`). +Mimetypes may be negated (e.g. `audio/*; !audio/mpeg;`). +Some of well-known mimetypes include: + +* `all/all`: matches all items +* `all/allfiles`: matches only files +* `inode/directory`: matches only directories + +`*` character is accepted as a wildcard in only two cases: + +* when used alone as in `*;`, _i.e._ when used as a group wildcard without subgroup, +* when used as the subgroup wildcard, after the `/` character, as in `image/*`. + +Defaults to `*;`, which happends to be exactly equivalent to `all/all` or to `all/*`. + + + + + + + + + + + + + + + + + +
_Comment:__This is the equivalent of `ServiceTypes`, `X-KDE-ServiceTypes`, `ExcludeServiceTypes` KDE and `MimeType` freedesktop keys._
+ +
strings listno
`Basenames`List of basenames the selection should match in order this profile be selected. +`*` character is accepted as a wildcard. +Basenames may be negated (e.g. `*; !*.h;`). +Defaults to `*;`.strings listno
`Matchcase`Whether the above `Basenames` is case sensitive. +Defaults to `true`.booleanno
`SelectionCount`Whether this profile may be selected depending of the count of the selection. +This is a string of the form `{'<'|'='|'>'} number`. +Examples of valid strings are: `=0`, `> 1`, `< 10`. +Defaults to `>0`.stringno
`Schemes`The list of schemes the selection must satisfy in order the item be selected. +Exemples of well-known schemes are: + +* `file` +* `sftp` +* `smb` +* `http` + +Schemes may be negated, e.g. `!http;`. +Defaults to `*;`. + + + + + + + + + + + + + + + +
_Comment:__This is the equivalent of `X-KDE-Protocol` and `X-KDE-Protocols` KDE keys._
+ +
strings listno
`Folders`A list of paths the current base directory must be in in order the item be selected. +A folder path may be negated (e.g. `/data; !/data/resources/secret;`). +`*` character is accepted as a wildcard, replacing any level(s) of subdirectory (e.g. `/music; /video; !*/secret;`). +Also note that a terminating `/*` is always implied by the definition of this key. +Last, note that different implementations today widely consider that, for a directory point of view, having no selection is roughly the same that selecting the currently opened folder. If this makes a difference for your action, thenstrings listno
`Capabilities`A list of capabilities each item of the selection must satisfy in order the item be candidate. +Capabilities may be negated. +Please note that each element of the specified list must be considered as ANDed, i.e. if we have `Capabilities=Readable;Writable;!Local`, then each element of the selection must be both readable AND writable AND not local. +Capabilities have to be chosen between following predefined ones: + +* `Owner`: current user is the owner of the selected items +* `Readable`: selected items are readable by user (probably more usefull when negated) +* `Writable`: selected items are writable by user +* `Executable`: selected items are executable by user +* `Local`: selected items are local + +Defaults to an empty list (do not care of capabilities). + + + + + + + + + + + + + + + +
_Comment:__This is the equivalent of `X-KDE-Require` KDE key._
+ +
strings listno
+ +## Parameters + +### Parameters expansion + +Whenever parameters are said to be accepted, they will be replaced at run-time. + +It should be noted by the implementation that items, actions or menus, which were considered valid at load time, may become invalid after parameters expansion, due, for example, to a label becoming empty. + +Also, this specification doesn't make any assumption about whether a parameter is relevant in a given situation, or secure, or may be used several times, or so. It instead considers that this sort of check is up to the action creator. + +The implementation should take care of correctly shell-escape the substituted values, so that it should not be needed for the action creator to use any sort of quotes to handle spaces in filenames. + +### Multiple execution + +The action creator may want its command be executed once, giving it the list of selected items as argument. + +Or the action creator may want its command be repeated for each selected item, giving to each execution a different item as argument. + +Actually, the command defined in the `Exec` key will be executed once, or repeated for each selected item, depending of the form of arguments. + +Though some parameters are not sensible to the count of the selection (e.g. `%c`, the selection count itself), most have two declensions: + +* a "singular" one, e.g. `%b`, the basename of the selected item +* a "plural" one, e.g. `%B`, a space-separated list of the basenames of selected items + +When the selection is empty or contains only one element, and from this topic point of view, these two forms are exactly equivalent. + +When the selection contains more than one item: + +* if the first relevant parameter found in the `Exec` key is of a singular form, then the implementation should consider that the command is only able to deal with one item at a time, and thus that it has to be ran one time for each selected item; +* contrarily, if the first relevant parameter found is of the plural form, then the implementation should consider that the command is able to deal with a list of items, and thus the command should be executed only once; +* if all found parameters are "irrelevant", then the default is to consider that the command should be executed only once. + +Example: + +> Say the current folder is /data, and the current selection contains the three files `pierre`, `paul` and `jacques`. +> +> If the `Exec` key is `echo %b`, then the following commands will be run: +> `echo pierre` +> `echo paul` +> `echo jacques` +> +> If the `Exec` key is `echo %B`, then the following command will be run: +> `echo pierre paul jacques` +> +> If the `Exec` key is `echo %b %B`, then the following commands will be run: +> `echo pierre pierre paul jacques` +> `echo paul pierre paul jacques` +> `echo jacques pierre paul jacques` +> +> If the `Exec` key is `echo %B %b`, then the following commands will be run: +> `echo pierre paul jacques pierre` +> The basename used is the one of the first item of the selected items list as provided by the Filer. There is only a small chance that it would be those of the first visually selected item, and there is contrarily great chances that it would not be predictable at all. +> +> Even if the chosen parameter is the same for all selected items, the behavior is identical. +> If the `Exec` key is `echo %d %B`, then the following commands will be run: +> `echo /data pierre paul jacques` +> `echo /data pierre paul jacques` +> `echo /data pierre paul jacques` +> which obviously doesn't make many sense. +> +> As the last three examples show up, action creator should avoid to mix singular and plural forms, unless they know what they are doing, whether it doesn't make sense or this may lead to unwaited results. +> +> Nonetheless, mixing singular and plural forms, though we warn against, is not an error. As a counter example, there may be some situations where a command-line of the form `echo %B %d` would be useful. In that case, the following command would be run: +> `echo pierre paul jacques /data` +> It is left as an exercize for the reader to find a use case. + +The word "first" in the following table makes so reference to the case where the singular form parameter is used in a plural form command. We recall one more time that which is the "first" element is not specified, and, most probably, rather unpredictable. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
**Parameter****Description****Said form**
%b(first) basenamesingular
%Bspace-separated list of basenamesplural
%ccount of selected itemsirrelevant
%d(first) base directorysingular
%Dspace-separated list of base directory of each selected itemsplural
%f(first) file namesingular
%Fspace-separated list of selected file namesplural
%hhostname of the (first) URIirrelevant
%mmimetype of the (first) selected itemsingular
%Mspace-separated list of the mimetypes of the selected itemsplural
%nusername of the (first) URIirrelevant
%ono-op operator which forces a singular form of execution when specified as first parameter, +ignored elsesingular
%Ono-op operator which forces a plural form of execution when specified as first parameter, +ignored elseplural
%pport number of the (first) URIirrelevant
%sscheme of the (first) URIirrelevant
%u(first) URIsingular
%Uspace-separated list of selected URIsplural
%w(first) basename without the extensionsingular
%Wspace-separated list of basenames without their extensionplural
%x(first) extensionsingular
%Xspace-separated list of extensionsplural
%%the "%" characterirrelevant
+ +## Building the whole hierarchy + +The processus described here is only a sort of meta-algorythm, whose only goal is to better specify how the menus and actions should be layouted in the final hierarchy. + +The implementor might take advantage of preparing once the whole hierarchy of the menus and actions: + +* to minimize the time spent in the parsing of all files; +* to identify and eliminate duplicate _desktop_file_id_s, +* to eliminate invalid menus and actions. + +1. as described in desktop_file_ids and invalid `.desktop` files; implentation so obtains a flat list of menus or actions; + +2. recursively build the hierarchy; this merely consists in the build of the hierarchy as a tree of menus and actions, where each _desktop_file_id_ addressed as the subitem of a menu consumes this same id from the flat list + * if the level-zero order (which is not specified here, but see desktop_file_id addressed in the level zero consumes this same id from the flat list; + * else, if might be reasonable to start with an empty tree; + +3. at the end, implementation stays with: + * the output tree with some menus at the root; + * some actions, left in the input flat list because they were not addressed by any menu; these left actions should be added to the level zero of the hierarchy (though in a unspecified order) + * some menus, left in the input flat list because their subitems were not found; as these menus happen to be empty, they must be considered as invalid. + +After this built phase, the resultant tree only contains valid (before runtime parameters expansion) menus and actions. + +So, menus or actions may appear at the level zero of the whole hierarchy for only two reasons: + +1. because they are explicitly addressed by the level-zero configuration, if the implementation defines it; this may concern menus and actions; +2. because these items were not adressed by any menu (but this may only concern actions). + +## Appendix A. The level-zero case + +Though not strictly an action or a menu definition, the level-zero issue might be easily solved by this specification. The implementation is free to implement it or not. + +Ordering the elements which have to be displayed at the level-zero of the Filer context menu is just a particular case of a menu definition. + +An implementation might define a `level-zero.directory` file, which would contain the ordered list of level zero items identified by their _desktop_file_id_. + +The `[Desktop Entry]` section of this `level-zero.directory` file would so have only one of the following keys: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
**Key****Description****Value type****Req ?**
`ItemsList`Same signification asstrings listno
+ +The `level-zero.directory` file may be searched for in `XDG_DATA_DIRS/file-manager/actions`. The first one found would be used. + +Not finding a `level-zero.directory` file should not prevent actions or menus to be displayed. Instead, they just would be displayed in an unspecified, implementation-dependent, order. + +The name `level-zero.directory` is chosen to not risk any collision with regular `.desktop` files. + +## References + +* [Desktop Entry Specification](http://standards.freedesktop.org/desktop-entry-spec/desktop-entry-spec-latest.html) +* [Desktop Menu Specification](http://standards.freedesktop.org/menu-spec/menu-spec-latest.html) +* [XDG Base Directory Specification](http://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html) +* [Creating Konqueror Service Menus](http://developer.kde.org/documentation/tutorials/dot/servicemenus.html) +* [Krusader UserActions](http://www.krusader.org/handbook/useractions.html) +* [Thunar Custom Actions](http://thunar.xfce.org/pwiki/documentation/custom_actions) + +## Contributors + +* Jonas Bähr +* David Faure +* Ted Gould +* Hong Jen Yee "PCMan" +* Michael Pyne +* Liam R. E. Quin +* Pierre Wieser + +## ChangeLog + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
VersionDateChanges
0.1-draft2009-12-07Creation
0.2-draft2009-12-17- Move syntax considerations to a new "Desktop file" section. +- Add "Managed objects" section. +- Add "Defining menus" section. +- Deal with level zero items. +- Define a separate "Conditions" section. +- Remove "Rationales" section, moving comments to the corresponding key description. +- Remove `Type` key +- Remove all `X-Action-` prefix of the key names. +- Add needed keys in order to provider equivalent functionalities to KDE service menus. +- Current and extensions keys have been merged in the same table. +
0.3-draft2009-12-23- No more talk about "extending", but rather of "deriving". +- Replace "[fds](http://standards.freedesktop.org/desktop-entry-spec/desktop-entry-spec-latest.html)" acronym with "[DES](http://standards.freedesktop.org/desktop-entry-spec/desktop-entry-spec-latest.html)". +- More clearly notice what this specification specifies, and what it doesn't specify. +- Move the "level-zero" case to a specific - Move rationales about the menu description to a specific - `Comment` key is renamed as `Tooltip` in menu and action definitions. +- Add `Description`, `SuggestedShortcut` keys to menu and action definitions. +- Add `Path`, `StartupNotify`, `StartupWMClass`, `ForEach` keys to profile definition. +- Remove `SelectionCount` key. +- Define available parameters. +- Create - Create
0.4-draft2010-01-07- Remove `ToolbarSameLabel` action property. +- Add `ExecuteAs` profile property. +- Restore `SelectionCount` condition. +- Add myself as a - Add a link to - Fix some links. +
0.5-draft2010-01-28- Setup a default value for `Path` parameter. +- Update
0.6-draft2010-02-03- Add `Type` key for distinguishing Actions from Menus. +- Specifies what to do with present, but not listed, profiles. +- Specifies defaults for `TryExec`, `ShowIfRegistered`, `ShowIfTrue`, `ShowIfRunning`, `MimeTypes`, `SelectionCount`, `Schemes`, `Capabilities` keys. +
0.7-draft2010-03-01- Remove `Minimized` and `Maximized` from available `ExecutionMode` modes. +- Remove `ForEach` key +- `Profiles` and `ItemsList` become dynamic +- Remove `GetItemsList` key +- Change `SelectionCount` default from `*` to `>0` +- `Folders` elements may be negated +- Specify how to read a Conditions string list which contains both positive and negated elements +
0.8-draft2010-03-18- Update the `Profile` and `ItemsList` keys description, describing their dynamic behavior. +- Update the `Path` key description, removing the word 'first'. +- Set the `ItemsList` key as requested. +- Specify the use of wildcards in `MimeTypes`, `Basenames` and `Folders` keys. +- The `Folders` key value is now defined as a list of paths. +- Update the `Folders` key description, describing SelectionCount-based behavior. +- More precisely describes parameters expansion against multiple selection. +- Create - Specify the format of the `SuggestedShortcut` key. +- Change to ExtensionAction and ExtensionMenu the type of actions and menus. +
0.9-draft2010-03-25- Define the `TargetLocation` key. +
0.10-draft2010-03-29- `Hidden` and `NoDisplay` keys are moved to `Desktop Entry` group. +
0.11-draft2010-04-15- Change back the `Type` of actions (resp. menus) to `Action` (resp. `Menu`). +- Change the keyword `_SEPARATOR_` to `SEPARATOR`. +- Add - Rename the `NoDisplay` keyword to `Enabled`. +
0.12-draft2010-06-15- Replace the "Same as DES" words by the exact relevant excerpt from DES, for `Hidden`, `Exec`, `StartupNotify`, `StartupWMClass`, `OnlyShowIn/NotShowIn` and `TryExec` keys. +- Change the `Capabilities` default value from `*;` to the empty list. +- Specify that the `Capabilities` conditions are ANDed. +
0.13-draft2010-08-04- Slightly rewrite introduction. +- Improve consistency of the specification by replace "protocol" with "scheme", and "program" with "command". +- Restates in relevant chapters that actions and menus may have their own set of conditions. +- Add a - Add `%m` and `%M` parameters. +- Better specify which parameters can be used to determine between "singular" and "plural" forms, and define the default behavior when only "irrelevant" parameters are found. +- States which value must be used in parameter expansions in the case of a singular form. +- The condition defined by the `TryExec` key evaluates to `false` if the specified file is not found or is not executable, instead of the entry being ignored. +
0.14-draft2010-08-05- Remove the (non-sense) states added in the previous version, about the value to be used in parameter expansions in the case of a singular form. +- Introduce more clearly the multiple execution algorythm. +
0.15-draft2010-11-23- Add `%o` and `%O` parameters. +
From 722b6741f326e052685257c753093abc8446643e Mon Sep 17 00:00:00 2001 From: probonopd Date: Fri, 26 Mar 2021 20:06:04 +0100 Subject: [PATCH 305/592] developer/filer-context-menus --- index.md | 1 + 1 file changed, 1 insertion(+) diff --git a/index.md b/index.md index d4a97ac1..0718ef15 100644 --- a/index.md +++ b/index.md @@ -42,6 +42,7 @@ __hello__ (also known as __helloSystem__) is a desktop system for creators with developer/applications developer/application-bundles developer/menu + developer/filer-context-menus developer/developer-tools developer/specifications developer/contributing From 34d42523c4a4cae7b945662a964a2c6fa595b18c Mon Sep 17 00:00:00 2001 From: probonopd Date: Fri, 26 Mar 2021 20:11:52 +0100 Subject: [PATCH 306/592] Update filer-context-menus.md --- developer/filer-context-menus.md | 235 +------------------------------ 1 file changed, 2 insertions(+), 233 deletions(-) diff --git a/developer/filer-context-menus.md b/developer/filer-context-menus.md index e30c481e..f8e6e9c0 100644 --- a/developer/filer-context-menus.md +++ b/developer/filer-context-menus.md @@ -3,8 +3,7 @@ It is possible to extend Filer context menu items by writing files that conform to the __DES-EMA__ (Desktop Entry Specification - Extension for Menus and Actions). Apparently this format was never adopted as a standard, so it is documented here. The information on this page is based on [draft 0.15](https://gitlab.gnome.org/GNOME/filemanager-actions/-/blob/NAUTILUS_ACTIONS_3_2_4/docs/des-ema/des-ema-0.15) from November 23, 2010. ``` .. note:: - Filer inherits its DES-EMA implementation from PCManFM, and may use a different format in the future. - + Filer inherits its DES-EMA implementation from PCManFM, but may use a different format in the future. It still needs to be verified which portions have actually been implemented in Filer, so currently this page describes functionality which may or may not be implemented in Filer. Corrections are welcome. ``` @@ -1392,7 +1391,7 @@ So, menus or actions may appear at the level zero of the whole hierarchy for onl 1. because they are explicitly addressed by the level-zero configuration, if the implementation defines it; this may concern menus and actions; 2. because these items were not adressed by any menu (but this may only concern actions). -## Appendix A. The level-zero case +## The level-zero case Though not strictly an action or a menu definition, the level-zero issue might be easily solved by this specification. The implementation is free to implement it or not. @@ -1458,233 +1457,3 @@ The name `level-zero.directory` is chosen to not risk any collision with regular * Michael Pyne * Liam R. E. Quin * Pierre Wieser - -## ChangeLog - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
VersionDateChanges
0.1-draft2009-12-07Creation
0.2-draft2009-12-17- Move syntax considerations to a new "Desktop file" section. -- Add "Managed objects" section. -- Add "Defining menus" section. -- Deal with level zero items. -- Define a separate "Conditions" section. -- Remove "Rationales" section, moving comments to the corresponding key description. -- Remove `Type` key -- Remove all `X-Action-` prefix of the key names. -- Add needed keys in order to provider equivalent functionalities to KDE service menus. -- Current and extensions keys have been merged in the same table. -
0.3-draft2009-12-23- No more talk about "extending", but rather of "deriving". -- Replace "[fds](http://standards.freedesktop.org/desktop-entry-spec/desktop-entry-spec-latest.html)" acronym with "[DES](http://standards.freedesktop.org/desktop-entry-spec/desktop-entry-spec-latest.html)". -- More clearly notice what this specification specifies, and what it doesn't specify. -- Move the "level-zero" case to a specific - Move rationales about the menu description to a specific - `Comment` key is renamed as `Tooltip` in menu and action definitions. -- Add `Description`, `SuggestedShortcut` keys to menu and action definitions. -- Add `Path`, `StartupNotify`, `StartupWMClass`, `ForEach` keys to profile definition. -- Remove `SelectionCount` key. -- Define available parameters. -- Create - Create
0.4-draft2010-01-07- Remove `ToolbarSameLabel` action property. -- Add `ExecuteAs` profile property. -- Restore `SelectionCount` condition. -- Add myself as a - Add a link to - Fix some links. -
0.5-draft2010-01-28- Setup a default value for `Path` parameter. -- Update
0.6-draft2010-02-03- Add `Type` key for distinguishing Actions from Menus. -- Specifies what to do with present, but not listed, profiles. -- Specifies defaults for `TryExec`, `ShowIfRegistered`, `ShowIfTrue`, `ShowIfRunning`, `MimeTypes`, `SelectionCount`, `Schemes`, `Capabilities` keys. -
0.7-draft2010-03-01- Remove `Minimized` and `Maximized` from available `ExecutionMode` modes. -- Remove `ForEach` key -- `Profiles` and `ItemsList` become dynamic -- Remove `GetItemsList` key -- Change `SelectionCount` default from `*` to `>0` -- `Folders` elements may be negated -- Specify how to read a Conditions string list which contains both positive and negated elements -
0.8-draft2010-03-18- Update the `Profile` and `ItemsList` keys description, describing their dynamic behavior. -- Update the `Path` key description, removing the word 'first'. -- Set the `ItemsList` key as requested. -- Specify the use of wildcards in `MimeTypes`, `Basenames` and `Folders` keys. -- The `Folders` key value is now defined as a list of paths. -- Update the `Folders` key description, describing SelectionCount-based behavior. -- More precisely describes parameters expansion against multiple selection. -- Create - Specify the format of the `SuggestedShortcut` key. -- Change to ExtensionAction and ExtensionMenu the type of actions and menus. -
0.9-draft2010-03-25- Define the `TargetLocation` key. -
0.10-draft2010-03-29- `Hidden` and `NoDisplay` keys are moved to `Desktop Entry` group. -
0.11-draft2010-04-15- Change back the `Type` of actions (resp. menus) to `Action` (resp. `Menu`). -- Change the keyword `_SEPARATOR_` to `SEPARATOR`. -- Add - Rename the `NoDisplay` keyword to `Enabled`. -
0.12-draft2010-06-15- Replace the "Same as DES" words by the exact relevant excerpt from DES, for `Hidden`, `Exec`, `StartupNotify`, `StartupWMClass`, `OnlyShowIn/NotShowIn` and `TryExec` keys. -- Change the `Capabilities` default value from `*;` to the empty list. -- Specify that the `Capabilities` conditions are ANDed. -
0.13-draft2010-08-04- Slightly rewrite introduction. -- Improve consistency of the specification by replace "protocol" with "scheme", and "program" with "command". -- Restates in relevant chapters that actions and menus may have their own set of conditions. -- Add a - Add `%m` and `%M` parameters. -- Better specify which parameters can be used to determine between "singular" and "plural" forms, and define the default behavior when only "irrelevant" parameters are found. -- States which value must be used in parameter expansions in the case of a singular form. -- The condition defined by the `TryExec` key evaluates to `false` if the specified file is not found or is not executable, instead of the entry being ignored. -
0.14-draft2010-08-05- Remove the (non-sense) states added in the previous version, about the value to be used in parameter expansions in the case of a singular form. -- Introduce more clearly the multiple execution algorythm. -
0.15-draft2010-11-23- Add `%o` and `%O` parameters. -
From d3c926645ddd5c8745e89a9f95b06c0fb9b899fb Mon Sep 17 00:00:00 2001 From: probonopd Date: Fri, 26 Mar 2021 20:15:09 +0100 Subject: [PATCH 307/592] Update filer-context-menus.md --- developer/filer-context-menus.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/developer/filer-context-menus.md b/developer/filer-context-menus.md index f8e6e9c0..5425d90d 100644 --- a/developer/filer-context-menus.md +++ b/developer/filer-context-menus.md @@ -338,6 +338,7 @@ Another choice might also be: + ## Profile definition Profile is identified by its _profile_id_, as an ASCII string. @@ -472,6 +473,7 @@ Defaults to empty: the command will be executed as the current user. + ## Menu definition Just as an action, a menu has label, tooltip, icon. @@ -641,6 +643,7 @@ Actions or menus not identified here, or not identified as subitems of a menu or + ## Conditions As a remainder of that has been said above, each one of the following conditions may appear in a menu, an action or a profile. @@ -966,6 +969,7 @@ Defaults to an empty list (do not care of capabilities). + ## Parameters ### Parameters expansion @@ -1363,6 +1367,7 @@ ignored else + ## Building the whole hierarchy The processus described here is only a sort of meta-algorythm, whose only goal is to better specify how the menus and actions should be layouted in the final hierarchy. From 8cb83a3d0bf6aab35fa19365ffa61e5f80131ab8 Mon Sep 17 00:00:00 2001 From: probonopd Date: Fri, 26 Mar 2021 22:26:02 +0100 Subject: [PATCH 308/592] Restart Filer [ci skip] --- developer/filer-context-menus.md | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/developer/filer-context-menus.md b/developer/filer-context-menus.md index 5425d90d..fa8f66a2 100644 --- a/developer/filer-context-menus.md +++ b/developer/filer-context-menus.md @@ -4,9 +4,14 @@ It is possible to extend Filer context menu items by writing files that conform ``` .. note:: Filer inherits its DES-EMA implementation from PCManFM, but may use a different format in the future. -It still needs to be verified which portions have actually been implemented in Filer, so currently this page describes functionality which may or may not be implemented in Filer. Corrections are welcome. + + It still needs to be verified which portions have actually been implemented in Filer, so currently this page describes functionality which may or may not be implemented in Filer. Corrections are welcome. ``` +Changes take effect after a restart of Filer. To restart Filer: +1. Press Ctrl+Alt+Esc and click on the Desktop to force-quit it +2. Press Alt+F2 and enter `launch Filer --desktop` to start it again + ## Examples ### An example of an action From 036a18073079cead8aa6d0f74d9a65129b2840dc Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 27 Mar 2021 10:57:48 +0100 Subject: [PATCH 309/592] Remove _US.ISO8859-1 Thanks @igalic --- developer/ports.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/developer/ports.md b/developer/ports.md index f47ca15b..6103a2d7 100644 --- a/developer/ports.md +++ b/developer/ports.md @@ -117,7 +117,7 @@ ls work/pkg ## Creating a port from scratch -The [FreeBSD Porter's Handbook](https://docs.freebsd.org/en_US.ISO8859-1/books/porters-handbook/) is the authoritative source on how to write new ports from scratch. This section shows a hands-on example on how to package a set of tools from a GitHub repository. +The [FreeBSD Porter's Handbook](https://docs.freebsd.org/en/books/porters-handbook/) is the authoritative source on how to write new ports from scratch. This section shows a hands-on example on how to package a set of tools from a GitHub repository. ``` .. note:: @@ -179,7 +179,7 @@ do-install: Notes * See `ls /usr/ports/` for possible categories, such as `sysutils` -* See [5.2. Naming](https://docs.freebsd.org/en_US.ISO8859-1/books/porters-handbook/makefile-naming.html) for naming and versioning conventions +* See [5.2. Naming](https://docs.freebsd.org/en/books/porters-handbook/makefile-naming.html) for naming and versioning conventions * The lines must be in a defined order. Run `portlint` to get information on this and re-order until it no longer complains * Run `make stage-qa` to find out dependencies * The `do-install` section is needed in this example because there is no `make install` in the original software's Makefile @@ -202,7 +202,7 @@ WWW: http://cowlark.com/fluxengine/ ``` Notes -* For details please refer to [3.2. Writing the Description Files](https://docs.freebsd.org/en_US.ISO8859-1/books/porters-handbook/porting-desc.html). +* For details please refer to [3.2. Writing the Description Files](https://docs.freebsd.org/en/books/porters-handbook/porting-desc.html). Create the checksum file by running @@ -236,7 +236,7 @@ make install make deinstall ``` -None of these must produce errors. See [3.4. Testing the Port](https://docs.freebsd.org/en_US.ISO8859-1/books/porters-handbook/porting-testing.html) for details. +None of these must produce errors. See [3.4. Testing the Port](https://docs.freebsd.org/en/books/porters-handbook/porting-testing.html) for details. At this point it may be a good idea to have an experienced FreeBSD Ports developer have a look at your new port. From f1f07a20e0aaa4dd5028aade7dd65d2681e5c908 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 27 Mar 2021 11:10:15 +0100 Subject: [PATCH 310/592] 'sudo su' works now https://github.com/helloSystem/ISO/pull/176/files --- developer/ports.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/developer/ports.md b/developer/ports.md index 6103a2d7..9d9825c2 100644 --- a/developer/ports.md +++ b/developer/ports.md @@ -127,7 +127,7 @@ The [FreeBSD Porter's Handbook](https://docs.freebsd.org/en/books/porters-handbo First, prepare the Ports environment: ``` -sudo bash +sudo su pkg install portlint subversion echo DEVELOPER=yes >> /etc/make.conf portsnap fetch extract update # Run this from time to time From 60bf4f1e591cc498863ee9b7eb091acfe5b34dcb Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 27 Mar 2021 12:20:25 +0100 Subject: [PATCH 311/592] export ALLOW_UNSUPPORTED_SYSTEM=1 --- developer/ports.md | 17 ++++++++++++----- 1 file changed, 12 insertions(+), 5 deletions(-) diff --git a/developer/ports.md b/developer/ports.md index 9d9825c2..6bfa18a3 100644 --- a/developer/ports.md +++ b/developer/ports.md @@ -25,6 +25,12 @@ sudo portsnap fetch update sudo portsnap extract ``` +If you are running an end-of-life FreeBSD version such as 12.1, you also need to + +``` +export ALLOW_UNSUPPORTED_SYSTEM=1 +``` + ## Building the port without changes Build the port without changes first to ensure it builds and works as expected. @@ -34,11 +40,11 @@ Build the port without changes first to ensure it builds and works as expected. # NOTE: Applications that have a library that is used by nothing but that application are just # annoying because now you have to deal with two entities rather than one cd /usr/ports/x11-toolkits/qtermwidget/ -MAKE_JOBS_UNSAFE=yes ALLOW_UNSUPPORTED_SYSTEM=1 sudo -E make -j4 +MAKE_JOBS_UNSAFE=yes sudo -E make -j4 # Build the application cd /usr/ports/x11/qterminal -QTermWidget5_DIR=/usr/ports/x11-toolkits/qtermwidget/work/stage/usr/local/lib/cmake/qtermwidget5/ MAKE_JOBS_UNSAFE=yes ALLOW_UNSUPPORTED_SYSTEM=1 sudo -E make -j4 +QTermWidget5_DIR=/usr/ports/x11-toolkits/qtermwidget/work/stage/usr/local/lib/cmake/qtermwidget5/ MAKE_JOBS_UNSAFE=yes sudo -E make -j4 # Run the application with the changed library LD_LIBRARY_PATH=/usr/ports/x11-toolkits/qtermwidget/work/stage/usr/local/lib/ /usr/ports/x11/qterminal/work/stage/usr/local/bin/qterminal @@ -70,7 +76,7 @@ sudo make makepatch # Build the library again # sudo make clean # Run this only if the next line does nothing -MAKE_JOBS_UNSAFE=yes ALLOW_UNSUPPORTED_SYSTEM=1 sudo -E make -j4 +MAKE_JOBS_UNSAFE=yes sudo -E make -j4 # Run the application with the changed library LD_LIBRARY_PATH=/usr/ports/x11-toolkits/qtermwidget/work/stage/usr/local/lib/ /usr/ports/x11/qterminal/work/stage/usr/local/bin/qterminal @@ -128,6 +134,7 @@ First, prepare the Ports environment: ``` sudo su +export ALLOW_UNSUPPORTED_SYSTEM=YES pkg install portlint subversion echo DEVELOPER=yes >> /etc/make.conf portsnap fetch extract update # Run this from time to time @@ -207,7 +214,7 @@ Notes Create the checksum file by running ``` -ALLOW_UNSUPPORTED_SYSTEM=YES make makesum +make makesum ``` Check the Makefile with @@ -221,7 +228,7 @@ and correct any mistakes it reports, then repeat. Once `portlint` says `looks fine`, try to build by running ``` -ALLOW_UNSUPPORTED_SYSTEM=YES make +make ``` Note that the compilation will fail. This is because in this case the application needs to be built with `gmake` rather than `make`. From 4ef3f7163b715540f79d2461c1c85941acb89c4d Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 27 Mar 2021 12:35:12 +0100 Subject: [PATCH 312/592] make stage-qa 2>&1 | grep "you need" | sort | uniq | cut -d " " -f 4 --- developer/ports.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/developer/ports.md b/developer/ports.md index 6bfa18a3..a0c5936e 100644 --- a/developer/ports.md +++ b/developer/ports.md @@ -188,7 +188,7 @@ Notes * See `ls /usr/ports/` for possible categories, such as `sysutils` * See [5.2. Naming](https://docs.freebsd.org/en/books/porters-handbook/makefile-naming.html) for naming and versioning conventions * The lines must be in a defined order. Run `portlint` to get information on this and re-order until it no longer complains -* Run `make stage-qa` to find out dependencies +* Run `make stage-qa` to find out dependencies. Using something like `make stage-qa 2>&1 | grep "you need" | sort | uniq | cut -d " " -f 4` can speed this up * The `do-install` section is needed in this example because there is no `make install` in the original software's Makefile Create `pkg-descr` based on the description on the GitHub [README.md](https://github.com/davidgiven/fluxengine): From 729dd455e523719c7d6db343e3b1bc9cd17f75b4 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 27 Mar 2021 18:47:59 +0100 Subject: [PATCH 313/592] The VM needs at least 2 CPU cores Thanks @rbircher --- user/getting-started.md | 1 + 1 file changed, 1 insertion(+) diff --git a/user/getting-started.md b/user/getting-started.md index 0ac8f4b9..0f8988e7 100644 --- a/user/getting-started.md +++ b/user/getting-started.md @@ -58,6 +58,7 @@ Please note: * The VM needs to be __64-bit__ * The VM needs __at least 4 GB of RAM__ +* The VM needs __at least 2 CPU cores__ * The boot process takes longer than you might expect; boot in verbose mode to see the details * For best results set **EFI/UEFI** boot mode (not BIOS) From 7bb295d42db467b640347484d70f396b48db56dc Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 28 Mar 2021 10:47:41 +0200 Subject: [PATCH 314/592] Made volumes show up on the desktop --- developer/acknowledgements.md | 1 + 1 file changed, 1 insertion(+) diff --git a/developer/acknowledgements.md b/developer/acknowledgements.md index 1693303f..aef2edbe 100644 --- a/developer/acknowledgements.md +++ b/developer/acknowledgements.md @@ -90,6 +90,7 @@ __[PreyK](https://github.com/PreyK)__ ## Chris Moore __[moochris](https://github.com/moochris)__ * Improved Filer: Added initial 'spatial mode' option (folders open in a new window) and made already-open windows come to the front rather than opening the same window multiple times +* Made volumes show up on the desktop ## Weblate [hosted.weblate.org](https://hosted.weblate.org/projects/hellosystem) From 68cc5c941991cfa7414470775c89a38569943838 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 28 Mar 2021 10:58:31 +0200 Subject: [PATCH 315/592] Update acknowledgements.md --- developer/acknowledgements.md | 1 + 1 file changed, 1 insertion(+) diff --git a/developer/acknowledgements.md b/developer/acknowledgements.md index aef2edbe..cd52d0f8 100644 --- a/developer/acknowledgements.md +++ b/developer/acknowledgements.md @@ -101,3 +101,4 @@ __[moochris](https://github.com/moochris)__ __[crees](https://github.com/__crees)__ * Made it possible to use a fixed Intel GPU driver for FreeBSD 12.2 from a private package * Created a package for the Falkon browser that does not pull in many KDE dependencies +* Helped updating required FreeBSD ports From 43a0ac23b4c4d3fa4628ac9d0e07bd87d156e398 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 28 Mar 2021 10:58:51 +0200 Subject: [PATCH 316/592] Update acknowledgements.md --- developer/acknowledgements.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/developer/acknowledgements.md b/developer/acknowledgements.md index cd52d0f8..deb7dd74 100644 --- a/developer/acknowledgements.md +++ b/developer/acknowledgements.md @@ -101,4 +101,4 @@ __[moochris](https://github.com/moochris)__ __[crees](https://github.com/__crees)__ * Made it possible to use a fixed Intel GPU driver for FreeBSD 12.2 from a private package * Created a package for the Falkon browser that does not pull in many KDE dependencies -* Helped updating required FreeBSD ports +* Updated required FreeBSD ports and helped writing new ports From 6a65a6537584d0c469d924e5563cb08eec556b04 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 28 Mar 2021 22:15:17 +0200 Subject: [PATCH 317/592] Avoiding configuration options https://github.com/helloSystem/Filer/issues/9#issuecomment-808941899 --- developer/ux-guidelines.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/developer/ux-guidelines.md b/developer/ux-guidelines.md index 57d7b56a..adb66e90 100644 --- a/developer/ux-guidelines.md +++ b/developer/ux-guidelines.md @@ -27,3 +27,7 @@ average distance required to reach the top of a 19 inch diagonal screen, yet the more efficient to place menus at the top of the window Source: Walker, N & Smelcer, JB 1990, A comparison of selection times from walking and pull-down menus. in JC Chew & J Whiteside (eds), Proceedings of the SIGCHI Conference on Human Factors in Computing Systems, CHI 1990. Association for Computing Machinery, pp. 221-225, 1990 SIGCHI Conference on Human Factors in Computing Systems, CHI 1990, Seattle, United States, 4/1/90. https://dl.acm.org/doi/pdf/10.1145/97243.97277 + +## Avoiding configuration options + +Configuration options add complexity to software, increase the test matrix, and make software harder to support (e.g., over the phone) because no two systems behave exactly the same way depending on how they were configured. Hence in helloSystem we want to avoid unnecessary user-facing configuration options whenever possible. But in return, we take great care to set sensible defaults and make things "just work" as expected (in line with our design objectives) out of the box, without the need for configuration. From 3ebbfd72ee53980adcc61b6676bf130d0e623b9a Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 28 Mar 2021 22:18:24 +0200 Subject: [PATCH 318/592] Avoiding configuration options --- developer/ux-guidelines.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/developer/ux-guidelines.md b/developer/ux-guidelines.md index adb66e90..1afe5b26 100644 --- a/developer/ux-guidelines.md +++ b/developer/ux-guidelines.md @@ -30,4 +30,4 @@ Source: Walker, N & Smelcer, JB 1990, A comparison of selection times from walki ## Avoiding configuration options -Configuration options add complexity to software, increase the test matrix, and make software harder to support (e.g., over the phone) because no two systems behave exactly the same way depending on how they were configured. Hence in helloSystem we want to avoid unnecessary user-facing configuration options whenever possible. But in return, we take great care to set sensible defaults and make things "just work" as expected (in line with our design objectives) out of the box, without the need for configuration. +Configuration options add complexity to software, increase the test matrix, and make software harder to support (e.g., over the phone) because no two systems behave exactly the same way depending on how they were configured. Hence in helloSystem we want to avoid unnecessary user-facing configuration options whenever possible. We take great care to set sensible defaults and make things "just work" as expected (in line with our design objectives) out of the box, without the need for configuration. KDE Plasma is recommended as an alternative for users who wish to configure and customize every aspect of the system. From a5b5aa1ea4ab26e0e38b1aedb77bda96351643cf Mon Sep 17 00:00:00 2001 From: probonopd Date: Wed, 31 Mar 2021 15:25:12 +0200 Subject: [PATCH 319/592] Update binary-compatibility.md --- developer/binary-compatibility.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/developer/binary-compatibility.md b/developer/binary-compatibility.md index 7488050f..e6a0005e 100644 --- a/developer/binary-compatibility.md +++ b/developer/binary-compatibility.md @@ -11,7 +11,7 @@ Binary compatibility is an important concept in software engineering. It allows The Application Binary Interface (ABI) defines which applications can run on which systems. The two main factors in determining application compatibility are the FreeBSD version (e.g., `12.x`) and the version of packages (e.g., `quarterly`). * Applications compiled on one major version of FreeBSD are expected to run on subsequent minor versions of the same major version of FreeBSD if the packages of the dependencies on the target system are no older than on the build system. __Example:__ An application compiled on FreeBSD 12.0 is expected to run on FreeBSD 12.1 and 12.2 if the packages of the dependencies on the target system are no older than on the build system - * Applications compiled on one major version of FreeBSD are expected to run on subsequent major versions of FreeBSD if compatiblity libraries are installed. __Example:__ An application compiled on FreeBSD 3.2 is expected to run on FreeBSD 14 if compatiblity libraries are installed. + * Applications compiled on one major version of FreeBSD are expected to run on subsequent major versions of FreeBSD if compatiblity libraries are installed. __Example:__ An application compiled on FreeBSD 3.2 is expected to run on FreeBSD 14 if compatibility libraries are installed. __But__ this is what happens when you try to install a package built on FreeBSD 12 on a FreeBSD 13 machine: `pkg-static: wrong architecture: FreeBSD:12:amd64 instead of FreeBSD:13:amd64`; apparently `pkg` does not make use of the combatibility assumption. ### Recommendation for building binary compatible applications From 7bf1b5a976ba97501d2724aa7069581e528a6ed8 Mon Sep 17 00:00:00 2001 From: probonopd Date: Wed, 31 Mar 2021 16:08:30 +0200 Subject: [PATCH 320/592] Update binary-compatibility.md --- developer/binary-compatibility.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/developer/binary-compatibility.md b/developer/binary-compatibility.md index e6a0005e..952471ac 100644 --- a/developer/binary-compatibility.md +++ b/developer/binary-compatibility.md @@ -11,7 +11,7 @@ Binary compatibility is an important concept in software engineering. It allows The Application Binary Interface (ABI) defines which applications can run on which systems. The two main factors in determining application compatibility are the FreeBSD version (e.g., `12.x`) and the version of packages (e.g., `quarterly`). * Applications compiled on one major version of FreeBSD are expected to run on subsequent minor versions of the same major version of FreeBSD if the packages of the dependencies on the target system are no older than on the build system. __Example:__ An application compiled on FreeBSD 12.0 is expected to run on FreeBSD 12.1 and 12.2 if the packages of the dependencies on the target system are no older than on the build system - * Applications compiled on one major version of FreeBSD are expected to run on subsequent major versions of FreeBSD if compatiblity libraries are installed. __Example:__ An application compiled on FreeBSD 3.2 is expected to run on FreeBSD 14 if compatibility libraries are installed. __But__ this is what happens when you try to install a package built on FreeBSD 12 on a FreeBSD 13 machine: `pkg-static: wrong architecture: FreeBSD:12:amd64 instead of FreeBSD:13:amd64`; apparently `pkg` does not make use of the combatibility assumption. + * Applications compiled on one major version of FreeBSD are expected to run on subsequent major versions of FreeBSD if compatiblity libraries are installed. __Example:__ An application compiled on FreeBSD 3.2 is expected to run on FreeBSD 14 if compatibility libraries are installed. __But__ this is what happens when you try to `pkg-static add` a package built on FreeBSD 12 on a FreeBSD 13 machine: `pkg-static: wrong architecture: FreeBSD:12:amd64 instead of FreeBSD:13:amd64` - apparently `pkg-static add` does not make use of the combatibility assumption but this can be worked around by exporting, e.g., `ABI=freebsd:12:amd64`; `pkg install` does not seem to have this issue. ### Recommendation for building binary compatible applications From 510b8d3b3db36c62904b7a3621c6d2e06551c8f4 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 3 Apr 2021 09:27:37 +0200 Subject: [PATCH 321/592] csh: setenv ALLOW_UNSUPPORTED_SYSTEM YES --- developer/ports.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/developer/ports.md b/developer/ports.md index a0c5936e..e6c2431e 100644 --- a/developer/ports.md +++ b/developer/ports.md @@ -29,6 +29,8 @@ If you are running an end-of-life FreeBSD version such as 12.1, you also need to ``` export ALLOW_UNSUPPORTED_SYSTEM=1 +# Or in csh +setenv ALLOW_UNSUPPORTED_SYSTEM YES ``` ## Building the port without changes @@ -135,6 +137,8 @@ First, prepare the Ports environment: ``` sudo su export ALLOW_UNSUPPORTED_SYSTEM=YES +# or on csh +setenv ALLOW_UNSUPPORTED_SYSTEM YES pkg install portlint subversion echo DEVELOPER=yes >> /etc/make.conf portsnap fetch extract update # Run this from time to time From f38817d3b550e28e5646ffbc651a07ae26b2fc31 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 3 Apr 2021 12:51:51 +0200 Subject: [PATCH 322/592] Add files via upload From https://www.kernel.org/doc/html/latest/_static/theme_overrides.css --- _static/theme_overrides.css | 137 ++++++++++++++++++++++++++++++++++++ 1 file changed, 137 insertions(+) create mode 100644 _static/theme_overrides.css diff --git a/_static/theme_overrides.css b/_static/theme_overrides.css new file mode 100644 index 00000000..459ec5b2 --- /dev/null +++ b/_static/theme_overrides.css @@ -0,0 +1,137 @@ +/* -*- coding: utf-8; mode: css -*- + * + * Sphinx HTML theme customization: read the doc + * + */ + +/* Improve contrast and increase size for easier reading. */ + +body { + font-family: serif; + color: black; + font-size: 100%; +} + +h1, h2, .rst-content .toctree-wrapper p.caption, h3, h4, h5, h6, legend { + font-family: sans-serif; +} + +.wy-menu-vertical li.current a { + color: #505050; +} + +.wy-menu-vertical li.on a, .wy-menu-vertical li.current > a { + color: #303030; +} + +div[class^="highlight"] pre { + font-family: monospace; + color: black; + font-size: 100%; +} + +.wy-menu-vertical { + font-family: sans-serif; +} + +.c { + font-style: normal; +} + +p { + font-size: 100%; +} + +/* Interim: Code-blocks with line nos - lines and line numbers don't line up. + * see: https://github.com/rtfd/sphinx_rtd_theme/issues/419 + */ + +div[class^="highlight"] pre { + line-height: normal; +} +.rst-content .highlight > pre { + line-height: normal; +} + +/* Keep fields from being strangely far apart due to inheirited table CSS. */ +.rst-content table.field-list th.field-name { + padding-top: 1px; + padding-bottom: 1px; +} +.rst-content table.field-list td.field-body { + padding-top: 1px; + padding-bottom: 1px; +} + +@media screen { + + /* content column + * + * RTD theme's default is 800px as max width for the content, but we have + * tables with tons of columns, which need the full width of the view-port. + */ + + .wy-nav-content{max-width: none; } + + /* table: + * + * - Sequences of whitespace should collapse into a single whitespace. + * - make the overflow auto (scrollbar if needed) + * - align caption "left" ("center" is unsuitable on vast tables) + */ + + .wy-table-responsive table td { white-space: normal; } + .wy-table-responsive { overflow: auto; } + .rst-content table.docutils caption { text-align: left; font-size: 100%; } + + /* captions: + * + * - captions should have 100% (not 85%) font size + * - hide the permalink symbol as long as link is not hovered + */ + + .toc-title { + font-size: 150%; + font-weight: bold; + } + + caption, .wy-table caption, .rst-content table.field-list caption { + font-size: 100%; + } + caption a.headerlink { opacity: 0; } + caption a.headerlink:hover { opacity: 1; } + + /* Menu selection and keystrokes */ + + span.menuselection { + color: blue; + font-family: "Courier New", Courier, monospace + } + + code.kbd, code.kbd span { + color: white; + background-color: darkblue; + font-weight: bold; + font-family: "Courier New", Courier, monospace + } + + /* fix bottom margin of lists items */ + + .rst-content .section ul li:last-child, .rst-content .section ul li p:last-child { + margin-bottom: 12px; + } + + /* inline literal: drop the borderbox, padding and red color */ + + code, .rst-content tt, .rst-content code { + color: inherit; + border: none; + padding: unset; + background: inherit; + font-size: 85%; + } + + .rst-content tt.literal,.rst-content tt.literal,.rst-content code.literal { + color: inherit; + } +} From b4b0d67d57ae9ef383ef4afde0a42cec8448ea82 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 3 Apr 2021 13:06:19 +0200 Subject: [PATCH 323/592] Use theme_overrides.css https://github.com/helloSystem/docs/issues/25 --- conf.py | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/conf.py b/conf.py index ce40455d..aeed091f 100644 --- a/conf.py +++ b/conf.py @@ -88,6 +88,12 @@ # so a file named "default.css" will overwrite the builtin "default.css". html_static_path = ['_static'] +# These paths are either relative to html_static_path +# or fully qualified paths (eg. https://...) +html_css_files = [ + 'theme_overrides.css', +] + github_doc_root = 'https://' + GITHUB_REPO_OWNER + '.github.io/' + GITHUB_REPO_NAME + '/' From 2cd1547ba171830a2dd7bc2e6101a25a2c08db4e Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 3 Apr 2021 13:09:04 +0200 Subject: [PATCH 324/592] font-family: sans-serif; --- _static/theme_overrides.css | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/_static/theme_overrides.css b/_static/theme_overrides.css index 459ec5b2..09453969 100644 --- a/_static/theme_overrides.css +++ b/_static/theme_overrides.css @@ -6,8 +6,12 @@ /* Improve contrast and increase size for easier reading. */ +* { + font-family: sans-serif; +} + body { - font-family: serif; + font-family: sans-serif; color: black; font-size: 100%; } From d14d931e2ec8f5cfcba3df09b209e5ea49cb81e6 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 3 Apr 2021 13:56:56 +0200 Subject: [PATCH 325/592] Did this garble our code blocks? --- _static/theme_overrides.css | 4 ---- 1 file changed, 4 deletions(-) diff --git a/_static/theme_overrides.css b/_static/theme_overrides.css index 09453969..c57ec18e 100644 --- a/_static/theme_overrides.css +++ b/_static/theme_overrides.css @@ -6,10 +6,6 @@ /* Improve contrast and increase size for easier reading. */ -* { - font-family: sans-serif; -} - body { font-family: sans-serif; color: black; From 9de4b3c6ab32e242ea263915b70a33366d3348ac Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 3 Apr 2021 13:57:53 +0200 Subject: [PATCH 326/592] For code: font-family: "Courier New", Courier, monospace --- _static/theme_overrides.css | 1 + 1 file changed, 1 insertion(+) diff --git a/_static/theme_overrides.css b/_static/theme_overrides.css index c57ec18e..470997ee 100644 --- a/_static/theme_overrides.css +++ b/_static/theme_overrides.css @@ -129,6 +129,7 @@ div[class^="highlight"] pre { padding: unset; background: inherit; font-size: 85%; + font-family: "Courier New", Courier, monospace } .rst-content tt.literal,.rst-content tt.literal,.rst-content code.literal { From 6bbff7c49a66e93dce85a5a8a2c37a9a9cb2e097 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 3 Apr 2021 19:11:24 +0200 Subject: [PATCH 327/592] pip3 install docutils==0.16 sphinx ... https://github.com/sphinx-doc/sphinx/issues/9049#issuecomment-812875386 --- buildDocs.sh | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/buildDocs.sh b/buildDocs.sh index 85a30c44..ee327468 100644 --- a/buildDocs.sh +++ b/buildDocs.sh @@ -20,7 +20,7 @@ set -x apt-get update apt-get -y install git rsync python3-pip qttools5-dev-tools qt5-default qt5-qmake pip3 install setuptools wheel -pip3 install sphinx sphinx-autobuild sphinx-rtd-theme commonmark recommonmark sphinxcontrib-qthelp sphinx-markdown-tables +pip3 install docutils==0.16 sphinx sphinx-autobuild sphinx-rtd-theme commonmark recommonmark sphinxcontrib-qthelp sphinx-markdown-tables ##################### # DECLARE VARIABLES # From 89a03904f6ad1b0ec3d2ae355de34b35516e14a3 Mon Sep 17 00:00:00 2001 From: probonopd Date: Wed, 7 Apr 2021 21:16:01 +0200 Subject: [PATCH 328/592] Create base.md --- developer/base.md | 49 +++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 49 insertions(+) create mode 100644 developer/base.md diff --git a/developer/base.md b/developer/base.md new file mode 100644 index 00000000..f94ae395 --- /dev/null +++ b/developer/base.md @@ -0,0 +1,49 @@ +# Working with the FreeBSD base system + +In some situations it may be necessary to make changes to existing software that comes in the FreeBSD base system. +This section describes how to make such changes using an example. + +## Example + +Suppose you would like to make a small change to the source code of software that comes in the FreeBSD base system. + +Here is a real-life example on how to do that: + +https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=251025 can be fixed by changing a few lines in + +https://github.com/freebsd/freebsd-src/blob/main/usr.sbin/efivar/efivar.c + +## Installing the FreeBSD source code + +Unfortunately one has to download/update the whole FreeBSD source code, even if one just wants to make a change to one command line tool. + +From http://ftp.freebsd.org/pub/FreeBSD/releases/amd64/12.2-RELEASE/ (or from whatever FreeBSD version you are using) download `src.txz`. Then: + +``` +cd / +sudo tar xf ~/Downloads/src.txz +rm ~/Downloads/src.txz +``` + +## Building a command line tool without changes + +Build the command line tool without changes first to ensure it builds and works as expected. + +``` +cd /usr/src/usr.sbin/efivar/ +make +/usr/obj/usr/src/amd64.amd64/usr.sbin/efivar/efivar +``` + +## Making changes + +Now make changes to the command line tool. + +``` +cd /usr/src/usr.sbin/efivar/ +rm efivar.c +# From https://reviews.freebsd.org/D29620 +wget "https://reviews.freebsd.org/file/data/qquakxqeqeeepcbml5cy/PHID-FILE-ryp4c3imjqswnsjqiip3/usr.sbin_efivar_efivar.c" -O efivar.c +make +/usr/obj/usr/src/amd64.amd64/usr.sbin/efivar/efivar +``` From 2637ceb8da11b07ebff3efff0786b9eb65a0fd3c Mon Sep 17 00:00:00 2001 From: probonopd Date: Wed, 7 Apr 2021 21:16:38 +0200 Subject: [PATCH 329/592] Add information on how to change code in FreeBSD base --- index.md | 1 + 1 file changed, 1 insertion(+) diff --git a/index.md b/index.md index 0718ef15..f68f05f2 100644 --- a/index.md +++ b/index.md @@ -50,6 +50,7 @@ __hello__ (also known as __helloSystem__) is a desktop system for creators with developer/tracing developer/localization developer/ports + developer/base developer/distributions developer/acknowledgements developer/contact From 27cbf0303ab3cffcaa44f1706e91b540b9236b91 Mon Sep 17 00:00:00 2001 From: probonopd Date: Fri, 16 Apr 2021 18:41:09 +0200 Subject: [PATCH 330/592] Create rpi.md --- developer/rpi.md | 267 +++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 267 insertions(+) create mode 100644 developer/rpi.md diff --git a/developer/rpi.md b/developer/rpi.md new file mode 100644 index 00000000..70e861b0 --- /dev/null +++ b/developer/rpi.md @@ -0,0 +1,267 @@ +# Raspberry Pi + +Although we are currently not providing installation images for Raspberry Pi, we are investigating whether doing so would be feasible and beneficial. + +__NOTE:__ This page is intended for technically advanced users and developers, not for end users. This page is work in progress. Instructions are brief and assume prior knowledge with the subject + +This page describes how to run the main components of helloSystem (referred to collectively as helloDesktop) on Raspberry Pi 3 and Raspberry Pi 4 devices, starting with the official FreeBSD 13 image that does not even contain Xorg. + +It describes how to build and set up the main components of helloSystem by hand, so this is a good walkthrough in case you are interested in bringing up the helloDesktop on other systems as well. + +If there is enough interest, we might eventually provide readymade helloSystem images for Raspberry Pi in the future. This depends on how usable helloSystem will be on the Raspberry Pi (e.g., whether we can get decent graphics performance). + +## Prerequisites + +* Raspberry Pi 3 Model B or B+, Raspberry Pi 4 Model B, or Raspberry Pi 400 +* Suitable power supply +* Class-1 or faster microSD card with at least 8 GB of memory +* HDMI display +* Keyboard and mouse (we recommend the official Raspberry Pi keyboard since helloSystem can automatically detect its language) +* Ethernet (WLAN is not yet covered on this page) + +## Preparing + +* Install the official FreeBSD 13 image (not FreeBSD 14) to a microSD card +* Copy this file to the microSD card you are running the Raspberry Pi from. You will need it because you will not have an internet browser at hand +* Edit `config.txt` in the `MSDOSBOOT` partition to contain the correct resolution for your screen. Apparently the screen resolution is not autodetected on the Raspberry Pi? + +``` +hdmi_safe=0 +framebuffer_width=1920 +framebuffer_height=1080 +disable_overscan=1 +``` + +__NOTE:__ Please let us know if you know how to get screen resolution autodetection working on FreeBSD with Raspberry Pi + +## Booting into the system + +We will be doing all subsequent steps on the Raspberry Pi system itself since we are assuming you don't have any other 64-bit ARM (`aarch64`) machines at hand. + +* Insert the microSD card into the Raspberry Pi +* Attach keyboard and mouse (we recommend the official Raspberry Pi keyboard since helloSystem can automatically detect its language) +* Attach the display (on the Raspberry Pi 4, the display needs to be attached to the HDMI port next to the USB type C power port) +* Attach Ethernet +* Power on the Raspberry Pi +* After some time you should land in a login screen +* Log in with `root`, password `root` +* Install some basic software with `pkg install -y xorg xterm nano openbox fluxbox` + +__NOTE:__ `fluxbox` is not strictly needed and can be removed later on, but it gives us a graphical desktop session while we are working on installing helloDesktop + +## Starting a graphical session + +Start Xorg with + +``` +echo startfluxbox > ~/.xinitrc +startx +``` + +Doing it like this is the easiest way since the display `DISPLAY` environment variable and other things will be set automatically. + +## Compiling and installing helloDesktop core components + +### launch + +The `launch` command is central to helloSystem and is used to launch applications throughout the system. + +``` +git clone https://github.com/helloSystem/launch +cd launch/ +mkdir build +cd build/ +cmake .. +make -j4 +./launch +make install +cd ../../ +``` + +### Menu + +``` +pkg install -y git-lite cmake pkgconf qt5-qmake qt5-buildtools kf5-kdbusaddons kf5-kwindowsystem libdbusmenu-qt5 +git clone https://github.com/helloSystem/Menu +cd Menu +mkdir build +cd build +cmake .. +make -j4 +make install +ln -s /usr/local/bin/menubar /usr/local/bin/Menu # Workaround for the 'launch' command to find it +cd ../../ +``` + +### Filer + +``` +git clone https://github.com/helloSystem/Filer +cd Filer/ +mkdir build +cd build/ +pkg install -y libfm +cmake .. +make -j4 +make install +ln -s /usr/local/bin/filer-qt /usr/local/bin/Filer # Workaround for the 'launch' command to find it +cd ../../ +``` + +__NOTE:__ It seems like Filer refuses to start if D-Bus is missing. We should change it so that it can also work without D-Bus and at prints a clear warning if D-Bus is missing. Currently all you see if D-Bus is missing is the following: `** (process:3691): WARNING **: The directory '~/Templates' doesn't exist, ignoring it`, and then Filer exits + +### Dock + +``` +pkg install -y <...> +git clone https://github.com/helloSystem/Dock +cd Dock +mkdir build +cd build +cmake .. +make -j4 +make install +ln -s /usr/local/bin/cyber-dock /usr/local/bin/Dock # Workaround for the 'launch' command to find it +cd ../../ +``` + +### QtPlugin + +``` +git clone https://github.com/helloSystem/QtPlugin +cd QtPlugin/ +mkdir build +cd build/ +pkg install -y libqtxdg +cmake .. +make -j4 +make install +cp stylesheet.qss /usr/local/etc/xdg/ +cd ../../ +``` + +### Icons and other assets + +Install icons and other helloSystem assets that are not packaged as FreeBSD packages (yet). It is easiest to run `bash`, then `export uzip=/`, and then run the corresponding sections of https://raw.githubusercontent.com/helloSystem/ISO/experimental/settings/script.hello. Here are some examples. + +For the system icons: + +``` +pkg install -y wget +wget -c -q http://archive.ubuntu.com/ubuntu/pool/universe/x/xubuntu-artwork/xubuntu-icon-theme_16.04.2_all.deb +tar xf xubuntu-icon-theme_16.04.2_all.deb +tar xf data.tar.xz +mkdir -p "${uzip}"/usr/local/share/icons/ +mv ./usr/share/icons/elementary-xfce "${uzip}"/usr/local/share/icons/ +mv ./usr/share/doc/xubuntu-icon-theme/copyright "${uzip}"/usr/local/share/icons/elementary-xfce/ +sed -i -e 's|usr/share|usr/local/share|g' "${uzip}"/usr/local/share/icons/elementary-xfce/copyright +rm "${uzip}"/usr/local/share/icons/elementary-xfce/copyright-e + +wget "https://raw.githubusercontent.com/helloSystem/hello/master/branding/computer-hello.png" -O "${uzip}"/usr/local/share/icons/elementary-xfce/devices/128/computer-hello.png +``` + +For the system fonts: + +``` +wget -c -q https://github.com/ArtifexSoftware/urw-base35-fonts/archive/20200910.zip +unzip -q 20200910.zip +mkdir -p "${uzip}/usr/local/share/fonts/TTF/" +cp -R urw-base35-fonts-20200910/fonts/*.ttf "${uzip}/usr/local/share/fonts/TTF/" +rm -rf urw-base35-fonts-20200910/ 20200910.zip +``` + +Proceed similarly for the cursor theme, wallpaper, applications from the helloSystem/Utilities repository, and other assets. + +### Installing required packages + +Install every package that is not commented out in https://raw.githubusercontent.com/helloSystem/ISO/experimental/settings/packages.hello that are installable. + +__NOTE:__ Not every package will be installable. This probably means that the package in question has not been compiled for the `aarch64` architecture on FreeBSD 13 yet. + +To enable `automount`, run `service devd restart`. + +### Installing overlays + +``` +git clone https://github.com/helloSystem/ISO +cp -Rfv ISO/overlays/uzip/hello/files/ / +cp -Rfv ISO/overlays/uzip/localize/files/ / +cp -Rfv ISO/overlays/uzip/openbox-theme/files/ / +cp -Rfv ISO/overlays/uzip/mountarchive/files/ / +``` + +__NOTE:__ If we provided the temporary packages that are used in the helloSystem ISO build process for download, then one could just install those instead of having to do the above + +### Editing start-hello + +Edit the `start-hello` script + +``` +################################# +# Details to be inserted here +################################# +``` + +### Starting helloDesktop session + +``` +echo start-hello > ~/.xinitrc +killall Xorg +``` + +Type `startx` to start an Xorg session; it should now load a helloDesktop session + +### Adding a user + +Added a new user with Applications -> Preferences -> Users + +``` +cp /home/user/.openbox* . +cp -r /home/user/.config/* .config/ +``` + +## Known issues + +__NOTE:__ Any help in improving the situation is appreciated. + +### Missing login window + +The `slim` package is missing, hence we don't have a login window at the moment. + +### Missing drop shadows + +We could not get drop shadows to work yet. + +__NOTE:__ Please let us know if you know how to enable compositing on FreeBSD on the Raspberry Pi + +### Lacking functionality due to missing packages + +Due to missing packages in FreeBSD for `aarch64`, some functionality is currently unavailable, including: +* Global keyboard shortcuts +* Screenshots + +### D-Bus issues + +Something is not quite right: + +``` +root@generic:~ # /usr/local/sbin/avahi-daemon +Found user 'avahi' (UID 558) and group 'avahi' (GID 558). +Successfully dropped root privileges. +avahi-daemon 0.8 starting up. +WARNING: No NSS support for mDNS detected, consider installing nss-mdns! +dbus_bus_get_private(): Failed to connect to socket /var/run/dbus/system_bus_socket: No such file or directory +WARNING: Failed to contact D-Bus daemon. +avahi-daemon 0.8 exiting. +``` + +D-Bus is so complicated. +What is supposed to provide `/var/run/dbus/system_bus_socket` and why are we missing it? + +### Web browser + +The Falkon browser can be launched on a Raspberry Pi 4 with 512 MB RAM, but trying to load more than the most basic web pages such as http://frogfind.com/ leads to an instant crash, presumably due to a lack of memory. + +__NOTE:__ Please let us know the results with Raspberry Pi models that have more memory + +__NOTE:__ Please let us know if you know how to use RAM compression on FreeBSD From 84880e02265fdafa023644ec61cb2d09599cb9c8 Mon Sep 17 00:00:00 2001 From: probonopd Date: Fri, 16 Apr 2021 18:41:40 +0200 Subject: [PATCH 331/592] Add Raspberry Pi page --- index.md | 1 + 1 file changed, 1 insertion(+) diff --git a/index.md b/index.md index f68f05f2..46e9e971 100644 --- a/index.md +++ b/index.md @@ -51,6 +51,7 @@ __hello__ (also known as __helloSystem__) is a desktop system for creators with developer/localization developer/ports developer/base + developer/rpi developer/distributions developer/acknowledgements developer/contact From 29c118d4a90cb5e44b5b3dc8c0d2d55de2dd7bc3 Mon Sep 17 00:00:00 2001 From: probonopd Date: Fri, 16 Apr 2021 19:00:55 +0200 Subject: [PATCH 332/592] Update rpi.md --- developer/rpi.md | 40 ++++++++++++++++++++++++++++++---------- 1 file changed, 30 insertions(+), 10 deletions(-) diff --git a/developer/rpi.md b/developer/rpi.md index 70e861b0..e2f06621 100644 --- a/developer/rpi.md +++ b/developer/rpi.md @@ -1,8 +1,12 @@ # Raspberry Pi +![](https://pbs.twimg.com/media/EzHBt3WXEAMq1Un?format=jpg&name=small) + Although we are currently not providing installation images for Raspberry Pi, we are investigating whether doing so would be feasible and beneficial. -__NOTE:__ This page is intended for technically advanced users and developers, not for end users. This page is work in progress. Instructions are brief and assume prior knowledge with the subject +``` .. note:: + This page is intended for technically advanced users and developers, not for end users. This page is work in progress. Instructions are brief and assume prior knowledge with the subject. +``` This page describes how to run the main components of helloSystem (referred to collectively as helloDesktop) on Raspberry Pi 3 and Raspberry Pi 4 devices, starting with the official FreeBSD 13 image that does not even contain Xorg. @@ -32,7 +36,9 @@ framebuffer_height=1080 disable_overscan=1 ``` -__NOTE:__ Please let us know if you know how to get screen resolution autodetection working on FreeBSD with Raspberry Pi +``` .. note:: + Please let us know if you know how to get screen resolution autodetection working on FreeBSD with Raspberry Pi +``` ## Booting into the system @@ -108,7 +114,9 @@ ln -s /usr/local/bin/filer-qt /usr/local/bin/Filer # Workaround for the 'launch' cd ../../ ``` -__NOTE:__ It seems like Filer refuses to start if D-Bus is missing. We should change it so that it can also work without D-Bus and at prints a clear warning if D-Bus is missing. Currently all you see if D-Bus is missing is the following: `** (process:3691): WARNING **: The directory '~/Templates' doesn't exist, ignoring it`, and then Filer exits +``` .. note:: + It seems like Filer refuses to start if D-Bus is missing. We should change it so that it can also work without D-Bus and at prints a clear warning if D-Bus is missing. Currently all you see if D-Bus is missing is the following: '** (process:3691): WARNING **: The directory '~/Templates' doesn't exist, ignoring it', and then Filer exits. +``` ### Dock @@ -176,7 +184,9 @@ Proceed similarly for the cursor theme, wallpaper, applications from the helloSy Install every package that is not commented out in https://raw.githubusercontent.com/helloSystem/ISO/experimental/settings/packages.hello that are installable. -__NOTE:__ Not every package will be installable. This probably means that the package in question has not been compiled for the `aarch64` architecture on FreeBSD 13 yet. +``` .. note:: + Not every package will be installable. This probably means that the package in question has not been compiled for the `aarch64` architecture on FreeBSD 13 yet. +``` To enable `automount`, run `service devd restart`. @@ -190,11 +200,13 @@ cp -Rfv ISO/overlays/uzip/openbox-theme/files/ / cp -Rfv ISO/overlays/uzip/mountarchive/files/ / ``` -__NOTE:__ If we provided the temporary packages that are used in the helloSystem ISO build process for download, then one could just install those instead of having to do the above +``` .. note:: + If we provided the temporary packages that are used in the helloSystem ISO build process for download, then one could just install those instead of having to do the above +``` ### Editing start-hello -Edit the `start-hello` script +Edit the `start-hello` script to use the `launch` command instead of hardcoding `/Applications/...`. ``` ################################# @@ -222,7 +234,9 @@ cp -r /home/user/.config/* .config/ ## Known issues -__NOTE:__ Any help in improving the situation is appreciated. +``` .. note:: + Any help in improving the situation is appreciated. +``` ### Missing login window @@ -232,7 +246,9 @@ The `slim` package is missing, hence we don't have a login window at the moment. We could not get drop shadows to work yet. -__NOTE:__ Please let us know if you know how to enable compositing on FreeBSD on the Raspberry Pi +``` .. note:: + Please let us know if you know how to enable compositing on FreeBSD on the Raspberry Pi. +``` ### Lacking functionality due to missing packages @@ -262,6 +278,10 @@ What is supposed to provide `/var/run/dbus/system_bus_socket` and why are we mis The Falkon browser can be launched on a Raspberry Pi 4 with 512 MB RAM, but trying to load more than the most basic web pages such as http://frogfind.com/ leads to an instant crash, presumably due to a lack of memory. -__NOTE:__ Please let us know the results with Raspberry Pi models that have more memory +``` .. note:: + Please let us know the results with Raspberry Pi models that have more memory. +``` -__NOTE:__ Please let us know if you know how to use RAM compression on FreeBSD +``` .. note:: + Please let us know if you know how to use RAM compression on FreeBSD. +``` From 0a847b3136190971d62be13f719fd22a363ca2ec Mon Sep 17 00:00:00 2001 From: probonopd Date: Fri, 16 Apr 2021 19:13:36 +0200 Subject: [PATCH 333/592] Update rpi.md --- developer/rpi.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/developer/rpi.md b/developer/rpi.md index e2f06621..6cc655d3 100644 --- a/developer/rpi.md +++ b/developer/rpi.md @@ -1,6 +1,6 @@ # Raspberry Pi -![](https://pbs.twimg.com/media/EzHBt3WXEAMq1Un?format=jpg&name=small) +![](https://camo.githubusercontent.com/9e96cf15fbd387092abc4fd6ede84e29cee79892d4d912d0a44b63ca7fe8cb5e/68747470733a2f2f7062732e7477696d672e636f6d2f6d656469612f457a48427433575845414d7131556e3f666f726d61743d6a7067266e616d653d736d616c6c) Although we are currently not providing installation images for Raspberry Pi, we are investigating whether doing so would be feasible and beneficial. From d725590d2848eee7e1a92b8014ee56baeea8c726 Mon Sep 17 00:00:00 2001 From: probonopd Date: Fri, 16 Apr 2021 20:07:38 +0200 Subject: [PATCH 334/592] Update rpi.md --- developer/rpi.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/developer/rpi.md b/developer/rpi.md index 6cc655d3..b7143642 100644 --- a/developer/rpi.md +++ b/developer/rpi.md @@ -282,6 +282,8 @@ The Falkon browser can be launched on a Raspberry Pi 4 with 512 MB RAM, but tryi Please let us know the results with Raspberry Pi models that have more memory. ``` +How do projects like https://github.com/TOLDOTECHNIK/buildroot-webkit manage to do web browsing and video playing in a browser on the Raspberry Pi? + ``` .. note:: Please let us know if you know how to use RAM compression on FreeBSD. ``` From 86339fb5bf16053208a6badef25effbc1021bed0 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 17 Apr 2021 08:08:14 +0200 Subject: [PATCH 335/592] Update rpi.md --- developer/rpi.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/developer/rpi.md b/developer/rpi.md index b7143642..c6fa92a2 100644 --- a/developer/rpi.md +++ b/developer/rpi.md @@ -276,7 +276,7 @@ What is supposed to provide `/var/run/dbus/system_bus_socket` and why are we mis ### Web browser -The Falkon browser can be launched on a Raspberry Pi 4 with 512 MB RAM, but trying to load more than the most basic web pages such as http://frogfind.com/ leads to an instant crash, presumably due to a lack of memory. +The Falkon browser can be launched on a Raspberry Pi 4 with 1 GB RAM, but trying to load more than the most basic web pages such as http://frogfind.com/ leads to an instant crash, presumably due to a lack of memory. ``` .. note:: Please let us know the results with Raspberry Pi models that have more memory. From 129ffda328726d950df928268a85f1f9a628b912 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 17 Apr 2021 08:30:47 +0200 Subject: [PATCH 336/592] Update rpi.md --- developer/rpi.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/developer/rpi.md b/developer/rpi.md index c6fa92a2..d912b535 100644 --- a/developer/rpi.md +++ b/developer/rpi.md @@ -238,6 +238,18 @@ cp -r /home/user/.config/* .config/ Any help in improving the situation is appreciated. ``` +### No 3D graphics and video acceleration + +* Very low FPS video +* No drop shadows rendered by a compositor +* No 3D acceleration + +Not sure whether `vc4-kms-v3d` is usable with FreeBSD. + +``` .. note:: + Any help in improving Raspberry Pi graphics on FreeBSD appreciated. +``` + ### Missing login window The `slim` package is missing, hence we don't have a login window at the moment. From 70d6bc898c96a3a362f965d191b29d474e53bd1f Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 17 Apr 2021 08:42:59 +0200 Subject: [PATCH 337/592] Update rpi.md --- developer/rpi.md | 1 - 1 file changed, 1 deletion(-) diff --git a/developer/rpi.md b/developer/rpi.md index d912b535..b243b052 100644 --- a/developer/rpi.md +++ b/developer/rpi.md @@ -241,7 +241,6 @@ cp -r /home/user/.config/* .config/ ### No 3D graphics and video acceleration * Very low FPS video -* No drop shadows rendered by a compositor * No 3D acceleration Not sure whether `vc4-kms-v3d` is usable with FreeBSD. From 7a6a167c8606c96b8bd015663dcee9203d540887 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 17 Apr 2021 09:18:12 +0200 Subject: [PATCH 338/592] Update rpi.md --- developer/rpi.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/developer/rpi.md b/developer/rpi.md index b243b052..15dd10e4 100644 --- a/developer/rpi.md +++ b/developer/rpi.md @@ -249,6 +249,8 @@ Not sure whether `vc4-kms-v3d` is usable with FreeBSD. Any help in improving Raspberry Pi graphics on FreeBSD appreciated. ``` +Also see: https://papers.freebsd.org/2019/bsdcan/vadot-adventure_in_drmland/ + ### Missing login window The `slim` package is missing, hence we don't have a login window at the moment. From 203225cf04f212bbb86c0a8067b710c541fce908 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 17 Apr 2021 09:56:20 +0200 Subject: [PATCH 339/592] Update rpi.md --- developer/rpi.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/developer/rpi.md b/developer/rpi.md index 15dd10e4..312b6464 100644 --- a/developer/rpi.md +++ b/developer/rpi.md @@ -295,7 +295,9 @@ The Falkon browser can be launched on a Raspberry Pi 4 with 1 GB RAM, but trying Please let us know the results with Raspberry Pi models that have more memory. ``` -How do projects like https://github.com/TOLDOTECHNIK/buildroot-webkit manage to do web browsing and video playing in a browser on the Raspberry Pi? +How do projects like the official Raspberry Pi OS (Debian based desktop) manage to do web browsing and video playing in a browser on the Raspberry Pi? + +On Linux, there is also __zram__ which is enabled by default on Android and Chromium OS. Did anything ever come out of https://wiki.freebsd.org/SummerOfCode2019Projects/VirtualMemoryCompression? ``` .. note:: Please let us know if you know how to use RAM compression on FreeBSD. From 1bddd01b12479939f854504504a32227a36411ae Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 17 Apr 2021 09:58:31 +0200 Subject: [PATCH 340/592] Update rpi.md --- developer/rpi.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/developer/rpi.md b/developer/rpi.md index 312b6464..a7daa00c 100644 --- a/developer/rpi.md +++ b/developer/rpi.md @@ -299,6 +299,8 @@ How do projects like the official Raspberry Pi OS (Debian based desktop) manage On Linux, there is also __zram__ which is enabled by default on Android and Chromium OS. Did anything ever come out of https://wiki.freebsd.org/SummerOfCode2019Projects/VirtualMemoryCompression? +macOS also does RAM compression when memory is getting low: https://www.lifewire.com/understanding-compressed-memory-os-x-2260327 + ``` .. note:: Please let us know if you know how to use RAM compression on FreeBSD. ``` From 91bd5392b1ae5ffeedeb09b1c7a2f09d29c34dc5 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 17 Apr 2021 09:59:17 +0200 Subject: [PATCH 341/592] Update rpi.md --- developer/rpi.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/developer/rpi.md b/developer/rpi.md index a7daa00c..8b93ff1d 100644 --- a/developer/rpi.md +++ b/developer/rpi.md @@ -299,7 +299,9 @@ How do projects like the official Raspberry Pi OS (Debian based desktop) manage On Linux, there is also __zram__ which is enabled by default on Android and Chromium OS. Did anything ever come out of https://wiki.freebsd.org/SummerOfCode2019Projects/VirtualMemoryCompression? -macOS also does RAM compression when memory is getting low: https://www.lifewire.com/understanding-compressed-memory-os-x-2260327 +macOS also does RAM compression when memory is getting low: https://www.lifewire.com/understanding-compressed-memory-os-x-2260327. + +Windows also does RAM compression: https://www.tenforums.com/windows-10-news/17993-windows-10-memory-compression.html. ``` .. note:: Please let us know if you know how to use RAM compression on FreeBSD. From 34e2d5a290e4b00e273edf027d3833ed5793001c Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 17 Apr 2021 10:02:31 +0200 Subject: [PATCH 342/592] Update rpi.md --- developer/rpi.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/developer/rpi.md b/developer/rpi.md index 8b93ff1d..f4a9ce96 100644 --- a/developer/rpi.md +++ b/developer/rpi.md @@ -303,6 +303,15 @@ macOS also does RAM compression when memory is getting low: https://www.lifewire Windows also does RAM compression: https://www.tenforums.com/windows-10-news/17993-windows-10-memory-compression.html. +Will this work? + +``` +mdconfig -a -t malloc -o compress -o reserve -s 512m -u 7 +swapon /dev/md7 +``` + +If yes, then we should do something like this as early in the boot process as possible with as much RAM as possible. + ``` .. note:: Please let us know if you know how to use RAM compression on FreeBSD. ``` From 5df0027be64045adb171ac7693139b872c76014c Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 17 Apr 2021 10:04:17 +0200 Subject: [PATCH 343/592] Update rpi.md --- developer/rpi.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/developer/rpi.md b/developer/rpi.md index f4a9ce96..42d7c550 100644 --- a/developer/rpi.md +++ b/developer/rpi.md @@ -315,3 +315,7 @@ If yes, then we should do something like this as early in the boot process as po ``` .. note:: Please let us know if you know how to use RAM compression on FreeBSD. ``` + +``` .. note:: + Do not use ZFS on memory-constrained machines. +``` From 3b0562eaa7207a33ed42142d6856085a900e9b02 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 17 Apr 2021 10:05:05 +0200 Subject: [PATCH 344/592] Update rpi.md --- developer/rpi.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/developer/rpi.md b/developer/rpi.md index 42d7c550..e679a9d4 100644 --- a/developer/rpi.md +++ b/developer/rpi.md @@ -297,6 +297,8 @@ The Falkon browser can be launched on a Raspberry Pi 4 with 1 GB RAM, but trying How do projects like the official Raspberry Pi OS (Debian based desktop) manage to do web browsing and video playing in a browser on the Raspberry Pi? +### RAM compression + On Linux, there is also __zram__ which is enabled by default on Android and Chromium OS. Did anything ever come out of https://wiki.freebsd.org/SummerOfCode2019Projects/VirtualMemoryCompression? macOS also does RAM compression when memory is getting low: https://www.lifewire.com/understanding-compressed-memory-os-x-2260327. From 6b826bfd1ec8c74be1a216aae5cd5063ae17321f Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 17 Apr 2021 10:26:21 +0200 Subject: [PATCH 345/592] Update rpi.md --- developer/rpi.md | 14 +++++++++++++- 1 file changed, 13 insertions(+), 1 deletion(-) diff --git a/developer/rpi.md b/developer/rpi.md index e679a9d4..805195e2 100644 --- a/developer/rpi.md +++ b/developer/rpi.md @@ -289,7 +289,19 @@ What is supposed to provide `/var/run/dbus/system_bus_socket` and why are we mis ### Web browser -The Falkon browser can be launched on a Raspberry Pi 4 with 1 GB RAM, but trying to load more than the most basic web pages such as http://frogfind.com/ leads to an instant crash, presumably due to a lack of memory. +The Falkon browser can be launched on a Raspberry Pi 4 with 1 GB RAM, but trying to load more than the most basic web pages such as http://frogfind.com/ leads to an instant crash, possibly due to a lack of memory: + +``` +# cat /root/.config/falkon/crashlog/Crash-2021-04-17T10:21:20.txt +Time: Sa. Apr. 17 10:21:20 2021 +Qt version: 5.15.2 (compiled with 5.15.2) +Falkon version: 3.1.0 +Rendering engine: QtWebEngine + +============== BACKTRACE ============== +#0: 0x213810 at /usr/local/bin/falkon +#1: 0x499b4994 <_pthread_sigmask+0x524> at /lib/libthr.so.3 +``` ``` .. note:: Please let us know the results with Raspberry Pi models that have more memory. From 2ddfe8178f6083661098b071b333093ea1c4dc15 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 17 Apr 2021 10:31:01 +0200 Subject: [PATCH 346/592] Update rpi.md --- developer/rpi.md | 8 ++------ 1 file changed, 2 insertions(+), 6 deletions(-) diff --git a/developer/rpi.md b/developer/rpi.md index 805195e2..35e51bac 100644 --- a/developer/rpi.md +++ b/developer/rpi.md @@ -255,13 +255,9 @@ Also see: https://papers.freebsd.org/2019/bsdcan/vadot-adventure_in_drmland/ The `slim` package is missing, hence we don't have a login window at the moment. -### Missing drop shadows +### Missing Zeroconf -We could not get drop shadows to work yet. - -``` .. note:: - Please let us know if you know how to enable compositing on FreeBSD on the Raspberry Pi. -``` +`avahi-daemon` seems not to be available for `aarch64` yet, preventing services from being announced and being browsed. ### Lacking functionality due to missing packages From 59028c8498182dd3716339749cdd00e9c614f656 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 17 Apr 2021 10:34:41 +0200 Subject: [PATCH 347/592] Update rpi.md --- developer/rpi.md | 12 +++++------- 1 file changed, 5 insertions(+), 7 deletions(-) diff --git a/developer/rpi.md b/developer/rpi.md index 35e51bac..cd5c27f8 100644 --- a/developer/rpi.md +++ b/developer/rpi.md @@ -257,13 +257,7 @@ The `slim` package is missing, hence we don't have a login window at the moment. ### Missing Zeroconf -`avahi-daemon` seems not to be available for `aarch64` yet, preventing services from being announced and being browsed. - -### Lacking functionality due to missing packages - -Due to missing packages in FreeBSD for `aarch64`, some functionality is currently unavailable, including: -* Global keyboard shortcuts -* Screenshots +`avahi-daemon` seems not to run due to the D-Bus issue below. ### D-Bus issues @@ -283,6 +277,10 @@ avahi-daemon 0.8 exiting. D-Bus is so complicated. What is supposed to provide `/var/run/dbus/system_bus_socket` and why are we missing it? +``` .. note:: + Please let us know if you know how to get D-Bus working properly. +``` + ### Web browser The Falkon browser can be launched on a Raspberry Pi 4 with 1 GB RAM, but trying to load more than the most basic web pages such as http://frogfind.com/ leads to an instant crash, possibly due to a lack of memory: From dee58d77429783fabe3d600c2f14dacceae18e66 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 17 Apr 2021 10:57:33 +0200 Subject: [PATCH 348/592] Update rpi.md --- developer/rpi.md | 19 +++---------------- 1 file changed, 3 insertions(+), 16 deletions(-) diff --git a/developer/rpi.md b/developer/rpi.md index cd5c27f8..7ce06d1a 100644 --- a/developer/rpi.md +++ b/developer/rpi.md @@ -257,29 +257,16 @@ The `slim` package is missing, hence we don't have a login window at the moment. ### Missing Zeroconf -`avahi-daemon` seems not to run due to the D-Bus issue below. - -### D-Bus issues - -Something is not quite right: +`avahi-daemon` does not run if `/usr/local/bin/dbus-daemon --system` is not running, due to ``` -root@generic:~ # /usr/local/sbin/avahi-daemon -Found user 'avahi' (UID 558) and group 'avahi' (GID 558). -Successfully dropped root privileges. -avahi-daemon 0.8 starting up. -WARNING: No NSS support for mDNS detected, consider installing nss-mdns! dbus_bus_get_private(): Failed to connect to socket /var/run/dbus/system_bus_socket: No such file or directory WARNING: Failed to contact D-Bus daemon. avahi-daemon 0.8 exiting. ``` -D-Bus is so complicated. -What is supposed to provide `/var/run/dbus/system_bus_socket` and why are we missing it? - -``` .. note:: - Please let us know if you know how to get D-Bus working properly. -``` +Something (what?) is supposed to start `/usr/local/bin/dbus-daemon --system` as root, which in turn creates `/var/run/dbus/system_bus_socket`. +D-Bus is so complicated and undocumented (when not used with `systemd`). ### Web browser From 43122caa523f9edaa70a4bcd6eb5a75f4b7cee80 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 17 Apr 2021 10:58:01 +0200 Subject: [PATCH 349/592] Update rpi.md --- developer/rpi.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/developer/rpi.md b/developer/rpi.md index 7ce06d1a..bdf6f98c 100644 --- a/developer/rpi.md +++ b/developer/rpi.md @@ -255,7 +255,7 @@ Also see: https://papers.freebsd.org/2019/bsdcan/vadot-adventure_in_drmland/ The `slim` package is missing, hence we don't have a login window at the moment. -### Missing Zeroconf +### Zeroconf may need some work `avahi-daemon` does not run if `/usr/local/bin/dbus-daemon --system` is not running, due to From fd1473d3951c3fe63f707bf03c1343199b56c4bc Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 17 Apr 2021 11:00:52 +0200 Subject: [PATCH 350/592] Update rpi.md --- developer/rpi.md | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) diff --git a/developer/rpi.md b/developer/rpi.md index bdf6f98c..cebe37a1 100644 --- a/developer/rpi.md +++ b/developer/rpi.md @@ -265,8 +265,13 @@ WARNING: Failed to contact D-Bus daemon. avahi-daemon 0.8 exiting. ``` -Something (what?) is supposed to start `/usr/local/bin/dbus-daemon --system` as root, which in turn creates `/var/run/dbus/system_bus_socket`. -D-Bus is so complicated and undocumented (when not used with `systemd`). +Something (most likely `/usr/local/etc/rc.d/dbus`) is supposed to start `/usr/local/bin/dbus-daemon --system` as root, which in turn creates `/var/run/dbus/system_bus_socket`. + +Add the following lines to `/etc/rc.conf' to enable it: + +``` +dbus_enable="YES" +``` ### Web browser From 734191a2b035d03ce9498141a40a85aaa1699514 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 17 Apr 2021 11:14:26 +0200 Subject: [PATCH 351/592] Update rpi.md --- developer/rpi.md | 8 +++----- 1 file changed, 3 insertions(+), 5 deletions(-) diff --git a/developer/rpi.md b/developer/rpi.md index cebe37a1..46f03096 100644 --- a/developer/rpi.md +++ b/developer/rpi.md @@ -303,17 +303,15 @@ macOS also does RAM compression when memory is getting low: https://www.lifewire Windows also does RAM compression: https://www.tenforums.com/windows-10-news/17993-windows-10-memory-compression.html. -Will this work? +The following seems to "work" but can make the Raspberry Pi unacceptably slow: ``` -mdconfig -a -t malloc -o compress -o reserve -s 512m -u 7 +mdconfig -a -t malloc -o compress -o reserve -s 700m -u 7 swapon /dev/md7 ``` -If yes, then we should do something like this as early in the boot process as possible with as much RAM as possible. - ``` .. note:: - Please let us know if you know how to use RAM compression on FreeBSD. + Please let us know if you know how to properly use RAM compression on FreeBSD. ``` ``` .. note:: From 6634db3a9fe11e34a2f71fc20d822031b94dacb9 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 17 Apr 2021 11:16:17 +0200 Subject: [PATCH 352/592] Update rpi.md --- developer/rpi.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/developer/rpi.md b/developer/rpi.md index 46f03096..fcb98598 100644 --- a/developer/rpi.md +++ b/developer/rpi.md @@ -221,7 +221,9 @@ echo start-hello > ~/.xinitrc killall Xorg ``` -Type `startx` to start an Xorg session; it should now load a helloDesktop session +Type `startx` to start an Xorg session; it should now load a helloDesktop session. + +Sometimes it does not load all the way, in this case it is necessary to start xterm (right-click the desktop) and invoke `start-hello` from there again. The reason for this is unknown. ### Adding a user From 87be6f8d3af5c0e2d3fed81aaf4def2ead26b02a Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 17 Apr 2021 11:18:33 +0200 Subject: [PATCH 353/592] Update rpi.md --- developer/rpi.md | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) diff --git a/developer/rpi.md b/developer/rpi.md index fcb98598..27728233 100644 --- a/developer/rpi.md +++ b/developer/rpi.md @@ -201,9 +201,19 @@ cp -Rfv ISO/overlays/uzip/mountarchive/files/ / ``` ``` .. note:: - If we provided the temporary packages that are used in the helloSystem ISO build process for download, then one could just install those instead of having to do the above + If we provided the temporary packages that are used in the helloSystem ISO build process for download, then one could just install those instead of having to do the above. ``` +## Adjusting fstab + +Edit `/etc/fstab` to look like this: + +``` +/dev/mmcsd0s2a / ufs rw 0 0 +``` + +Otherwise the root device may not be found upon reboot. + ### Editing start-hello Edit the `start-hello` script to use the `launch` command instead of hardcoding `/Applications/...`. From 6a2a327b19c81ec55227725930c4dc3f79e8cbb2 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 17 Apr 2021 11:40:50 +0200 Subject: [PATCH 354/592] Update rpi.md --- developer/rpi.md | 27 +++++++++------------------ 1 file changed, 9 insertions(+), 18 deletions(-) diff --git a/developer/rpi.md b/developer/rpi.md index 27728233..856b8910 100644 --- a/developer/rpi.md +++ b/developer/rpi.md @@ -214,6 +214,15 @@ Edit `/etc/fstab` to look like this: Otherwise the root device may not be found upon reboot. +### Enabling D-Bus and Avahi + +Zeroconf does not work if `/usr/local/bin/dbus-daemon --system` is not running. hence add the following lines to `/etc/rc.conf' to enable it: + +``` +dbus_enable="YES" +avahi_enable="YES" +``` + ### Editing start-hello Edit the `start-hello` script to use the `launch` command instead of hardcoding `/Applications/...`. @@ -267,24 +276,6 @@ Also see: https://papers.freebsd.org/2019/bsdcan/vadot-adventure_in_drmland/ The `slim` package is missing, hence we don't have a login window at the moment. -### Zeroconf may need some work - -`avahi-daemon` does not run if `/usr/local/bin/dbus-daemon --system` is not running, due to - -``` -dbus_bus_get_private(): Failed to connect to socket /var/run/dbus/system_bus_socket: No such file or directory -WARNING: Failed to contact D-Bus daemon. -avahi-daemon 0.8 exiting. -``` - -Something (most likely `/usr/local/etc/rc.d/dbus`) is supposed to start `/usr/local/bin/dbus-daemon --system` as root, which in turn creates `/var/run/dbus/system_bus_socket`. - -Add the following lines to `/etc/rc.conf' to enable it: - -``` -dbus_enable="YES" -``` - ### Web browser The Falkon browser can be launched on a Raspberry Pi 4 with 1 GB RAM, but trying to load more than the most basic web pages such as http://frogfind.com/ leads to an instant crash, possibly due to a lack of memory: From 0b0c4365f199d3d04c304318739b9303674b4ada Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 18 Apr 2021 16:58:44 +0200 Subject: [PATCH 355/592] @moochris: Added menus to the desktop --- developer/acknowledgements.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/developer/acknowledgements.md b/developer/acknowledgements.md index deb7dd74..2800a70c 100644 --- a/developer/acknowledgements.md +++ b/developer/acknowledgements.md @@ -91,12 +91,12 @@ __[PreyK](https://github.com/PreyK)__ __[moochris](https://github.com/moochris)__ * Improved Filer: Added initial 'spatial mode' option (folders open in a new window) and made already-open windows come to the front rather than opening the same window multiple times * Made volumes show up on the desktop +* Added menus to the desktop ## Weblate [hosted.weblate.org](https://hosted.weblate.org/projects/hellosystem) * Providing infrastructure for crowd-sourced translations - ## Chris Rees __[crees](https://github.com/__crees)__ * Made it possible to use a fixed Intel GPU driver for FreeBSD 12.2 from a private package From 325ebc040bd1908311e4f34e62805052e189828a Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 24 Apr 2021 08:32:46 +0200 Subject: [PATCH 356/592] Update rpi.md --- developer/rpi.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/developer/rpi.md b/developer/rpi.md index 856b8910..5dab3de4 100644 --- a/developer/rpi.md +++ b/developer/rpi.md @@ -87,7 +87,7 @@ cd ../../ ### Menu ``` -pkg install -y git-lite cmake pkgconf qt5-qmake qt5-buildtools kf5-kdbusaddons kf5-kwindowsystem libdbusmenu-qt5 +pkg install -y git-lite cmake pkgconf qt5-qmake qt5-buildtools kf5-kdbusaddons kf5-kwindowsystem libdbusmenu-qt5 qt5-concurrent qt5-quickcontrols2 git clone https://github.com/helloSystem/Menu cd Menu mkdir build From 99004a8838cc10d4dc10be7d0a3b385b74e253e0 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 25 Apr 2021 11:28:28 +0200 Subject: [PATCH 357/592] pine64 rockpro64_rk3399 --- developer/rpi.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/developer/rpi.md b/developer/rpi.md index 5dab3de4..7441d7f7 100644 --- a/developer/rpi.md +++ b/developer/rpi.md @@ -4,6 +4,8 @@ Although we are currently not providing installation images for Raspberry Pi, we are investigating whether doing so would be feasible and beneficial. +The same insructions are roughly applicable to other aarch64 based systems such as rk3399 ones like the PineBook Pro and the [pine64 rockpro64_rk3399](https://bsd-hardware.info/?id=board:pine64-pinebook-pro-rk3399) as well. + ``` .. note:: This page is intended for technically advanced users and developers, not for end users. This page is work in progress. Instructions are brief and assume prior knowledge with the subject. ``` @@ -278,7 +280,7 @@ The `slim` package is missing, hence we don't have a login window at the moment. ### Web browser -The Falkon browser can be launched on a Raspberry Pi 4 with 1 GB RAM, but trying to load more than the most basic web pages such as http://frogfind.com/ leads to an instant crash, possibly due to a lack of memory: +The Falkon browser can be launched, but trying to load more than the most basic web pages such as http://frogfind.com/ leads to an instant crash: ``` # cat /root/.config/falkon/crashlog/Crash-2021-04-17T10:21:20.txt @@ -293,7 +295,7 @@ Rendering engine: QtWebEngine ``` ``` .. note:: - Please let us know the results with Raspberry Pi models that have more memory. + The exact same crash also happens on a RockPro64 with 4GB of RAM. ``` How do projects like the official Raspberry Pi OS (Debian based desktop) manage to do web browsing and video playing in a browser on the Raspberry Pi? From 52472313c664b2102fd6cc2a3a4562699163378c Mon Sep 17 00:00:00 2001 From: Roman Zaynetdinov <627197+zaynetro@users.noreply.github.com> Date: Sun, 25 Apr 2021 20:10:18 +0300 Subject: [PATCH 358/592] Update Raspberry Pi instructions based on rockpro64 experience (#26) --- developer/rpi.md | 35 ++++++++++++++++++++++++++++------- 1 file changed, 28 insertions(+), 7 deletions(-) diff --git a/developer/rpi.md b/developer/rpi.md index 7441d7f7..a47f50d2 100644 --- a/developer/rpi.md +++ b/developer/rpi.md @@ -53,7 +53,7 @@ We will be doing all subsequent steps on the Raspberry Pi system itself since we * Power on the Raspberry Pi * After some time you should land in a login screen * Log in with `root`, password `root` -* Install some basic software with `pkg install -y xorg xterm nano openbox fluxbox` +* Install some basic software with `pkg install -y xorg xterm nano openbox fluxbox git-lite` __NOTE:__ `fluxbox` is not strictly needed and can be removed later on, but it gives us a graphical desktop session while we are working on installing helloDesktop @@ -89,7 +89,7 @@ cd ../../ ### Menu ``` -pkg install -y git-lite cmake pkgconf qt5-qmake qt5-buildtools kf5-kdbusaddons kf5-kwindowsystem libdbusmenu-qt5 qt5-concurrent qt5-quickcontrols2 +pkg install -y cmake pkgconf qt5-qmake qt5-buildtools kf5-kdbusaddons kf5-kwindowsystem libdbusmenu-qt5 qt5-concurrent qt5-quickcontrols2 git clone https://github.com/helloSystem/Menu cd Menu mkdir build @@ -131,7 +131,8 @@ cd build cmake .. make -j4 make install -ln -s /usr/local/bin/cyber-dock /usr/local/bin/Dock # Workaround for the 'launch' command to find it +# Currently Dock is installed to /usr/bin/cyber-dock. In the future is should be in /usr/local/bin/. +ln -s /usr/bin/cyber-dock /usr/local/bin/Dock # Workaround for the 'launch' command to find it cd ../../ ``` @@ -146,13 +147,13 @@ pkg install -y libqtxdg cmake .. make -j4 make install -cp stylesheet.qss /usr/local/etc/xdg/ +cp ../stylesheet.qss /usr/local/etc/xdg/ cd ../../ ``` ### Icons and other assets -Install icons and other helloSystem assets that are not packaged as FreeBSD packages (yet). It is easiest to run `bash`, then `export uzip=/`, and then run the corresponding sections of https://raw.githubusercontent.com/helloSystem/ISO/experimental/settings/script.hello. Here are some examples. +Install icons and other helloSystem assets that are not packaged as FreeBSD packages (yet). It is easiest to run `bash`, then `export uzip=/`, and then run the corresponding sections of [script.hello](https://raw.githubusercontent.com/helloSystem/ISO/experimental/settings/script.hello). Here are some examples. For the system icons: @@ -184,12 +185,21 @@ Proceed similarly for the cursor theme, wallpaper, applications from the helloSy ### Installing required packages -Install every package that is not commented out in https://raw.githubusercontent.com/helloSystem/ISO/experimental/settings/packages.hello that are installable. +Install every package that is not commented out in [packages.hello](https://raw.githubusercontent.com/helloSystem/ISO/experimental/settings/packages.hello) that are installable. ``` .. note:: Not every package will be installable. This probably means that the package in question has not been compiled for the `aarch64` architecture on FreeBSD 13 yet. ``` +You can use this script to automatically install all listed packages: + +```sh +url="https://raw.githubusercontent.com/helloSystem/ISO/experimental/settings/packages.hello" +curl -fsS $url | egrep -v '^#' | while read line ; do + pkg install -y -U $line || echo "[error] $line cannot be installed" +done +``` + To enable `automount`, run `service devd restart`. ### Installing overlays @@ -225,13 +235,16 @@ dbus_enable="YES" avahi_enable="YES" ``` +and then start it `service dbus start`. + ### Editing start-hello Edit the `start-hello` script to use the `launch` command instead of hardcoding `/Applications/...`. ``` ################################# -# Details to be inserted here +# Details to be inserted here. +# This script is work in progress. ################################# ``` @@ -322,3 +335,11 @@ swapon /dev/md7 ``` .. note:: Do not use ZFS on memory-constrained machines. ``` + +### Missing icons + +Set `QT_QPA_PLATFORMTHEME` env variable before staring Xorg session. + +``` +setenv QT_QPA_PLATFORMTHEME panda +``` From 3a997b28bbf086fecd89e5821995b61fc95becf2 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 2 May 2021 10:06:55 +0200 Subject: [PATCH 359/592] Create geom_rowr.md --- developer/geom_rowr.md | 109 +++++++++++++++++++++++++++++++++++++++++ 1 file changed, 109 insertions(+) create mode 100644 developer/geom_rowr.md diff --git a/developer/geom_rowr.md b/developer/geom_rowr.md new file mode 100644 index 00000000..a180559b --- /dev/null +++ b/developer/geom_rowr.md @@ -0,0 +1,109 @@ +# geom_rowr kernel module + +The `geom_rowr` kernel module for FreeBSD makes a read-only device writable by combining it with a read-write device. + +## Use case + +When creating a Live ISO, we want to use a read-only filesystem (that can reside on a medium that is physically read-only, such as a DVD) but make it appear to the system as if it was read-write (since some parts of the system may not work on a read-only system). + +## Theory of operation + +`geom_rowr` is a FreeBSD kernel module using the [GEOM Modular Disk Transformation Framework](https://docs.freebsd.org/en/books/handbook/geom.html). It allows you to take a read-only device (e.g. a DVD) and combine it with a read-write device (e.g., a swap-backed `md` memory disk) to get a new device that contains the data from the read-only device but is writable. + +It is designed to work with any filesystem, including ZFS. It is compatible with `geom_uzip` so the read-only filesystem can be compressed with uzip. + +The principle of operation is as follows: + +* Reading a sector from the combined device reads it from the read-only device. Writing a sector writes it to the read-write device +* After a sector is written, future reads of that sector are satisfied from the read-write device as it contains the latest version of the sector's contents + +As a result, immediately after creating the combined device, it appears to contain all the data from the read-only device. This means zero wait time for the user. + +## Test + +Execute the following commands as root: + +``` +# Prepare filesystem image +dd if=/dev/zero of=test.img bs=1M count=512 +mdconfig -a -t vnode -f test.img -u 9 +newfs /dev/md9 +mount /dev/md9 /mnt +# Populate the filesystem +cp -R /boot/ /mnt +umount /mnt +mdconfig -d -u 9 + +# Load kernel module +kldload ./geom_rowr.ko +# prepare the read-only device md0 +mdconfig -a -t vnode -o readonly -f test.img -u 0 +# prepare the read-write device md1 +mdconfig -a -t swap -s 512M -u 1 +# Make sure the geom(8) tool will find the .so +cp geom_rowr.so /lib/geom +# Create the new device that combines md0 and md1 +geom rowr create rowr0 md0 md1 +mount /dev/rowr0 /mnt + +# See that the files are already there +ls /mnt +# make changes to the filesystem to see that it is read-write +mv /mnt/*.4th /mnt/lua; rm /mnt/pxeboot +``` + +## Use in the Live ISO boot process + +This can be used for a Live ISO like this: + +* On the ISO, there is a small `ramdisk.ufs` that contains the logic to mount the main filesystem using `geom_rowr` +* On the ISO, there is also the main filesystem `system.ufs` which is a UFS image compressed with `geom_uzip` +* At boot time, the code in the ramdisk creates a r/w swap-backed `md` device with the same size as the main r/o filesystem, mounts it together with the main filesystem using `geom_rowr`, and chroots into the combined r/w filesystem. From there, the boot process continues as usual + +## Caveats + +### Device size + +* The r/o device must have as much free space as you would like to have on the combined device (The free space can be compressed very efficiently by `geom_uzip`) +* The r/o and the r/w image need to be the exact same size in bytes + +You can have an [md(4)](https://www.freebsd.org/cgi/man.cgi?md%284%29) device be of size 3GB without it consuming 3GB of RAM. +This is valid for vnode-backed md devices, swap-backed md devices and malloc-backed when the `reserve` option to [mdconfig(8)](https://www.freebsd.org/cgi/man.cgi?mdconfig(8)) isn't used. + +A swap-backed `md` device consumes close to zero memory when created and grows its memory use the more you write to it. + +### Reroot + +Because `reroot` cannot be made to work with `geom_rowr` at this time, we need to use `chroot`. + +When using `chroot`, some kernel modules that load firmware (e.g., for Intel WLAN drivers) fail to load the firmware if the places where kernel modules are located - `/boot/kernel` and `/boot/modules` - will look differently inside vs. outside the chroot. + +This can be fixed. + +Recommended way (to be tested): + +Provided that `ramdisk.ufs` does not contain `/boot`, create a symlink on `ramdisk.ufs` from `/boot` to `/sysroot/boot`. The symlink can be made at image creation time or by a script that runs at runtime. This combined with the *default* `kern.module_path` should be enough to create a common view between the kernel and chrooted userland utilities. The places where kernel modules are located - `/boot/kernel` and `/boot/modules` - will look the same inside and outside of the chroot. + +Alternative way (known to work): + +``` +mkdir -p /sysroot/sysroot/boot # Needed? +mount -t nullfs /sysroot/boot /sysroot/sysroot/boot # Needed? + +echo "==> Set kernel module path for chroot" +sysctl kern.module_path=/sysroot/boot/kernel +``` + +### ZFS + +With ZFS there is a problem unrelated to the `geom_uzip` code. When ZFS performs discovery of devices which are part of a zpool, the read-only device could be found before the combined rowr device which leads to inability to import the pool read-write. + +(TODO: Insert tested workaround here) + +## License + +``` +geom_rowr.ko, geom_rowr.so: Copyright (c) 2021, Jordan Gordeev +``` + +The author states that once the code reaches a certain level of maturity, it will be published under the license used by the FreeBSD project. From cd8dc0751892ddb4b6d82307dd7765918c052563 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 2 May 2021 10:08:05 +0200 Subject: [PATCH 360/592] Update acknowledgements.md --- developer/acknowledgements.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/developer/acknowledgements.md b/developer/acknowledgements.md index 2800a70c..e07c4662 100644 --- a/developer/acknowledgements.md +++ b/developer/acknowledgements.md @@ -102,3 +102,6 @@ __[crees](https://github.com/__crees)__ * Made it possible to use a fixed Intel GPU driver for FreeBSD 12.2 from a private package * Created a package for the Falkon browser that does not pull in many KDE dependencies * Updated required FreeBSD ports and helped writing new ports + +## Jordan Gordeev +* Wrote `geom_rowr` FreeBSD kernel module to combine a read-only with a read-write device From 54341cae64a1f154ab1ee26758e82d5bebb047a2 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 2 May 2021 10:08:53 +0200 Subject: [PATCH 361/592] geom_rowr --- index.md | 1 + 1 file changed, 1 insertion(+) diff --git a/index.md b/index.md index 46e9e971..7017b2ef 100644 --- a/index.md +++ b/index.md @@ -37,6 +37,7 @@ __hello__ (also known as __helloSystem__) is a desktop system for creators with developer/ux-guidelines developer/architecture developer/boot + developer/geom_rowr developer/graphics developer/binary-compatibility developer/applications From dcc1f88912c82f0634ac936029e9d01b8ee443a0 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 2 May 2021 10:56:05 +0200 Subject: [PATCH 362/592] Update geom_rowr.md --- developer/geom_rowr.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/developer/geom_rowr.md b/developer/geom_rowr.md index a180559b..85a2f003 100644 --- a/developer/geom_rowr.md +++ b/developer/geom_rowr.md @@ -2,6 +2,10 @@ The `geom_rowr` kernel module for FreeBSD makes a read-only device writable by combining it with a read-write device. +``` .. note:: + The `geom_rowr` kernel module is currently under development and is being tested for adoption in helloSystem. +``` + ## Use case When creating a Live ISO, we want to use a read-only filesystem (that can reside on a medium that is physically read-only, such as a DVD) but make it appear to the system as if it was read-write (since some parts of the system may not work on a read-only system). From 6acbb7732679df7e5e14f3314e3faa7f110a5bde Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 2 May 2021 10:56:31 +0200 Subject: [PATCH 363/592] Update geom_rowr.md --- developer/geom_rowr.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/developer/geom_rowr.md b/developer/geom_rowr.md index 85a2f003..5e142a72 100644 --- a/developer/geom_rowr.md +++ b/developer/geom_rowr.md @@ -3,7 +3,7 @@ The `geom_rowr` kernel module for FreeBSD makes a read-only device writable by combining it with a read-write device. ``` .. note:: - The `geom_rowr` kernel module is currently under development and is being tested for adoption in helloSystem. + This kernel module is currently under development and is being tested for adoption in helloSystem. ``` ## Use case From befe7207bf60d07b5076e3fbc0b5350d5e287be3 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 2 May 2021 11:08:09 +0200 Subject: [PATCH 364/592] Update geom_rowr.md --- developer/geom_rowr.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/developer/geom_rowr.md b/developer/geom_rowr.md index 5e142a72..e12b4a04 100644 --- a/developer/geom_rowr.md +++ b/developer/geom_rowr.md @@ -68,8 +68,9 @@ This can be used for a Live ISO like this: ### Device size -* The r/o device must have as much free space as you would like to have on the combined device (The free space can be compressed very efficiently by `geom_uzip`) -* The r/o and the r/w image need to be the exact same size in bytes +* The r/o device must have as much free space as you would like to have on the combined device. This can be achieved, e.g., like this: `makefs -b 20% -f 20% /usr/local/furybsd/cdroot/data/system.ufs /usr/local/furybsd/uzip` which will add an extra 20% of free space to the main filesystem image +* The free space is compressed very efficiently when the image is compressed with `geom_uzip`. This can be achieved, e.g., like this: `mkuzip -o /usr/local/furybsd/cdroot/data/system.uzip /usr/local/furybsd/cdroot/data/system.ufs` +* The uncompressed r/o image and the r/w image need to be the exact same size in bytes You can have an [md(4)](https://www.freebsd.org/cgi/man.cgi?md%284%29) device be of size 3GB without it consuming 3GB of RAM. This is valid for vnode-backed md devices, swap-backed md devices and malloc-backed when the `reserve` option to [mdconfig(8)](https://www.freebsd.org/cgi/man.cgi?mdconfig(8)) isn't used. From ad9c2237f1d56629e52275a296b861fb070f9714 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 2 May 2021 15:48:59 +0200 Subject: [PATCH 365/592] geom_rowr --- developer/geom_rowr.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/developer/geom_rowr.md b/developer/geom_rowr.md index e12b4a04..683f2b84 100644 --- a/developer/geom_rowr.md +++ b/developer/geom_rowr.md @@ -101,14 +101,14 @@ sysctl kern.module_path=/sysroot/boot/kernel ### ZFS -With ZFS there is a problem unrelated to the `geom_uzip` code. When ZFS performs discovery of devices which are part of a zpool, the read-only device could be found before the combined rowr device which leads to inability to import the pool read-write. +With ZFS there is a problem unrelated to the `geom_rowr` code. When ZFS performs discovery of devices which are part of a zpool, the read-only device could be found before the combined rowr device which leads to inability to import the pool read-write. (TODO: Insert tested workaround here) ## License ``` -geom_rowr.ko, geom_rowr.so: Copyright (c) 2021, Jordan Gordeev +geom_rowr.ko, geom_rowr.so: Copyright (c) 2021, Jordan Gordeev ``` The author states that once the code reaches a certain level of maturity, it will be published under the license used by the FreeBSD project. From 12db2676942fdb8f1078f6055b78d0ea690d4ad8 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 2 May 2021 18:50:26 +0200 Subject: [PATCH 366/592] Update geom_rowr.md --- developer/geom_rowr.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/developer/geom_rowr.md b/developer/geom_rowr.md index 683f2b84..2f1c4ac0 100644 --- a/developer/geom_rowr.md +++ b/developer/geom_rowr.md @@ -62,15 +62,15 @@ This can be used for a Live ISO like this: * On the ISO, there is a small `ramdisk.ufs` that contains the logic to mount the main filesystem using `geom_rowr` * On the ISO, there is also the main filesystem `system.ufs` which is a UFS image compressed with `geom_uzip` -* At boot time, the code in the ramdisk creates a r/w swap-backed `md` device with the same size as the main r/o filesystem, mounts it together with the main filesystem using `geom_rowr`, and chroots into the combined r/w filesystem. From there, the boot process continues as usual +* At boot time, the code in the ramdisk creates a r/w swap-backed `md` device with the same size as the main r/o filesystem image, mounts it together with the main filesystem using `geom_rowr`, and chroots into the combined r/w filesystem. From there, the boot process continues as usual ## Caveats ### Device size -* The r/o device must have as much free space as you would like to have on the combined device. This can be achieved, e.g., like this: `makefs -b 20% -f 20% /usr/local/furybsd/cdroot/data/system.ufs /usr/local/furybsd/uzip` which will add an extra 20% of free space to the main filesystem image +* The r/o image must have as much free space as you would like to have on the combined device. This can be achieved, e.g., like this: `makefs -b 20% -f 20% /usr/local/furybsd/cdroot/data/system.ufs /usr/local/furybsd/uzip` which will add an extra 20% of free space to the main filesystem image * The free space is compressed very efficiently when the image is compressed with `geom_uzip`. This can be achieved, e.g., like this: `mkuzip -o /usr/local/furybsd/cdroot/data/system.uzip /usr/local/furybsd/cdroot/data/system.ufs` -* The uncompressed r/o image and the r/w image need to be the exact same size in bytes +* The uncompressed r/o image and the r/w device need to be the exact same size in bytes. Assuming variable `${x}` holds the size of the uncompressed r/o image in bytes, a matching r/w device with the same size in bytes can be created using `mdconfig -a -t swap -s ${x}b -u 2` (note the `b` suffix to the `-s` option) You can have an [md(4)](https://www.freebsd.org/cgi/man.cgi?md%284%29) device be of size 3GB without it consuming 3GB of RAM. This is valid for vnode-backed md devices, swap-backed md devices and malloc-backed when the `reserve` option to [mdconfig(8)](https://www.freebsd.org/cgi/man.cgi?mdconfig(8)) isn't used. From 1b06c61ca99279e4aa2ed7b847b6c8598cd6f4b8 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 2 May 2021 18:54:10 +0200 Subject: [PATCH 367/592] Update geom_rowr.md --- developer/geom_rowr.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/developer/geom_rowr.md b/developer/geom_rowr.md index 2f1c4ac0..7c90c0b5 100644 --- a/developer/geom_rowr.md +++ b/developer/geom_rowr.md @@ -70,7 +70,7 @@ This can be used for a Live ISO like this: * The r/o image must have as much free space as you would like to have on the combined device. This can be achieved, e.g., like this: `makefs -b 20% -f 20% /usr/local/furybsd/cdroot/data/system.ufs /usr/local/furybsd/uzip` which will add an extra 20% of free space to the main filesystem image * The free space is compressed very efficiently when the image is compressed with `geom_uzip`. This can be achieved, e.g., like this: `mkuzip -o /usr/local/furybsd/cdroot/data/system.uzip /usr/local/furybsd/cdroot/data/system.ufs` -* The uncompressed r/o image and the r/w device need to be the exact same size in bytes. Assuming variable `${x}` holds the size of the uncompressed r/o image in bytes, a matching r/w device with the same size in bytes can be created using `mdconfig -a -t swap -s ${x}b -u 2` (note the `b` suffix to the `-s` option) +* The uncompressed r/o image and the r/w device need to be the exact same size in bytes. Assuming variable `${x}` holds the size of the uncompressed r/o image in bytes, a matching r/w device with the same size in bytes can be created using `mdconfig -a -t swap -s ${x}b -u 2` (note the `b` suffix to the `-s` option). If this is not done correctly, we get the `geom: mediasize mismatch` error You can have an [md(4)](https://www.freebsd.org/cgi/man.cgi?md%284%29) device be of size 3GB without it consuming 3GB of RAM. This is valid for vnode-backed md devices, swap-backed md devices and malloc-backed when the `reserve` option to [mdconfig(8)](https://www.freebsd.org/cgi/man.cgi?mdconfig(8)) isn't used. From c65c22f2dc23ba9ec7994515f82f42305a6216ca Mon Sep 17 00:00:00 2001 From: probonopd Date: Fri, 21 May 2021 22:16:44 +0200 Subject: [PATCH 368/592] Update getting-started.md --- user/getting-started.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/user/getting-started.md b/user/getting-started.md index 0f8988e7..a2304cd6 100644 --- a/user/getting-started.md +++ b/user/getting-started.md @@ -114,6 +114,18 @@ Then add these two `qemu-system-x86_64` options: ![Screenshot](https://docs.01.org/clearlinux/latest/zh_CN/_images/parallels-07.png) +#### Proxmox VE + +* Memory: 4GB (not ballooned) +* Processors: 2 (1 socket 2 cores) +* BIOS: OVMF (UEFI) +* Display: VMWare Compatible (vmware) [seems to be limited to 800x600 pixels resolution] +* Machine: Default (i440fx) +* SCSI Controller: VirtIO SCSI +* CD Drive: helloSystem ISO +* Hard Disk: At least 8GB Raw +* Network Device: vmxnet3 + ## Downloading Pre-alpha ISO images are available for download [here](https://github.com/helloSystem/ISO/releases/). From 8140873e812fff0d50ed0956db07e5262da7a2b2 Mon Sep 17 00:00:00 2001 From: probonopd Date: Fri, 21 May 2021 22:18:21 +0200 Subject: [PATCH 369/592] Note on Pre-Release builds --- user/getting-started.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/user/getting-started.md b/user/getting-started.md index a2304cd6..e4352046 100644 --- a/user/getting-started.md +++ b/user/getting-started.md @@ -128,8 +128,8 @@ Then add these two `qemu-system-x86_64` options: ## Downloading -Pre-alpha ISO images are available for download [here](https://github.com/helloSystem/ISO/releases/). +ISO images are available for download [here](https://github.com/helloSystem/ISO/releases/). ```eval_rst -important:: Images get built automatically whenever source code is committed. Not every build is tested. +important:: Images get built automatically whenever source code is committed. Not every build is tested. Builds marked as "Pre-Release" are strictly for developers, may be broken and may not even boot. ``` From f621d120735688df04b76d4629c2b13f7cb98807 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 23 May 2021 18:27:23 +0200 Subject: [PATCH 370/592] Airyx DBusKit --- developer/menu.md | 1 + 1 file changed, 1 insertion(+) diff --git a/developer/menu.md b/developer/menu.md index 9955bd70..f9523806 100644 --- a/developer/menu.md +++ b/developer/menu.md @@ -44,6 +44,7 @@ Those may or may not be used in helloSystem, they are mentioned here to give an * [__libappindicator__](https://wiki.ubuntu.com/DesktopExperienceTeam/ApplicationIndicators#Software_Architecture): Library by Canonical to register icons and menus and internally uses dbusmenu to publish context menus over dbus. Needed for some applications (e.g., screenkey) to show icons in the upper right hand corner of the menu (system tray/notification area). The same as [`indicator-application`](https://launchpad.net/indicator-application)? * [__MenuModel__](): Used by Gtk * [__JAyatana__](): Supposedly allows for displaying global menus in Java Swing applications (such as Netbeans and the JetBrains suite of IDEs) +* [DBusKit](https://github.com/mszoek/airyx/tree/main/DBusKit): Airyx DBusKit implements a subset of D-Bus needed to support sending menus of AppKit applications to the global menu bar ## Libraries involved From d8c8e14b281003e940ff5a1b8f5ebc65f61d6e9e Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 23 May 2021 18:28:10 +0200 Subject: [PATCH 371/592] Airyx DBusKit --- developer/menu.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/developer/menu.md b/developer/menu.md index f9523806..e5764bda 100644 --- a/developer/menu.md +++ b/developer/menu.md @@ -44,7 +44,7 @@ Those may or may not be used in helloSystem, they are mentioned here to give an * [__libappindicator__](https://wiki.ubuntu.com/DesktopExperienceTeam/ApplicationIndicators#Software_Architecture): Library by Canonical to register icons and menus and internally uses dbusmenu to publish context menus over dbus. Needed for some applications (e.g., screenkey) to show icons in the upper right hand corner of the menu (system tray/notification area). The same as [`indicator-application`](https://launchpad.net/indicator-application)? * [__MenuModel__](): Used by Gtk * [__JAyatana__](): Supposedly allows for displaying global menus in Java Swing applications (such as Netbeans and the JetBrains suite of IDEs) -* [DBusKit](https://github.com/mszoek/airyx/tree/main/DBusKit): Airyx DBusKit implements a subset of D-Bus needed to support sending menus of AppKit applications to the global menu bar +* [__Airyx DBusKit__](https://github.com/mszoek/airyx/tree/main/DBusKit): Airyx DBusKit implements a subset of D-Bus needed to support sending menus of **AppKit** applications to the global menu bar ## Libraries involved From 6bd76bc1043bd7887ae51aef7aaea50502f40327 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 23 May 2021 20:19:34 +0200 Subject: [PATCH 372/592] CutefishOS --- developer/acknowledgements.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/developer/acknowledgements.md b/developer/acknowledgements.md index e07c4662..135ea50b 100644 --- a/developer/acknowledgements.md +++ b/developer/acknowledgements.md @@ -41,9 +41,9 @@ __[vermaden](https://github.com/vermaden)__ * Provided helpful feedback and configuration advice * Configuration for tap to click and two-finger scrolling for Synaptics and Elan touchpads -## Reven Martin +## Reven Martin ([CutefishOS](https://cutefishos.com/)) __[rekols](https://github.com/rekols)__ -@revenmartin on twitter +@revenmartin on twitter, @cutefishos on twitter * Originally wrote Panda Status Bar, which the hello Menu is based on * Originally wrote Cyber Dock, which the hello Dock is based on From 2bb0f6a26b1e08705c6025fade70e7a775f86882 Mon Sep 17 00:00:00 2001 From: probonopd Date: Wed, 26 May 2021 21:14:54 +0200 Subject: [PATCH 373/592] libera.chat --- developer/contact.md | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/developer/contact.md b/developer/contact.md index bf656ad1..b8627da8 100644 --- a/developer/contact.md +++ b/developer/contact.md @@ -1,7 +1,5 @@ # Contact -You can meet other helloSystem users and developers in the `#helloSystem` [Internet Relay Chat](https://en.wikipedia.org/wiki/Internet_Relay_Chat) channel at `irc.freenode.net`. - -Alternatively, you can [`#helloSystem:matrix.org`](https://matrix.to/#/#helloSystem:matrix.org) from any Matrix client (such as the Element web-based Matrix client). This Matrix channel is [bridged](https://matrix.org/blog/2015/06/22/the-matrix-org-irc-bridge-now-bridges-all-of-freenode) to the IRC channel. Joining via Matrix has the advantage that you will see responses that you may have received while you were offline. So after asking a question, you can come back in a day or so to see if there were any responses. +You can meet other helloSystem users and developers at [`#helloSystem:matrix.org`](https://matrix.to/#/#helloSystem:matrix.org) from any Matrix client (such as the Element web-based Matrix client). This Matrix channel is [bridged](https://matrix.org/blog/2015/06/22/the-matrix-org-irc-bridge-now-bridges-all-of-freenode) to the IRC channel (which we intend to move from freenode to libera.chat). Joining via Matrix has the advantage that you will see responses that you may have received while you were offline. So after asking a question, you can come back in a day or so to see if there were any responses. In any case, please stay in the channel for a few days and do not expect to receive answers immediately, since we are all volunteers. From d3ced95055cdaea4634eb335c1730e9f6e53d424 Mon Sep 17 00:00:00 2001 From: probonopd Date: Tue, 1 Jun 2021 18:49:53 +0200 Subject: [PATCH 374/592] Remove freenode [ci skip] --- developer/acknowledgements.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/developer/acknowledgements.md b/developer/acknowledgements.md index 135ea50b..b0cc46e0 100644 --- a/developer/acknowledgements.md +++ b/developer/acknowledgements.md @@ -20,7 +20,7 @@ __[probonopd](https://github.com/probonopd)__ ## Joe Maloney __[pkgdemon](https://github.com/pkgdemon)__ -malco2001 on irc.freenode.net (#FuryBSD) +malco2001 on irc (#FuryBSD) * Originally wrote the tools to create Live ISOs for FuryBSD ## Cirrus CI From ea9b359e4354046bed37080911e31f46b3c76d37 Mon Sep 17 00:00:00 2001 From: probonopd Date: Tue, 1 Jun 2021 18:50:55 +0200 Subject: [PATCH 375/592] libera [ci skip] --- developer/contact.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/developer/contact.md b/developer/contact.md index b8627da8..642c8b65 100644 --- a/developer/contact.md +++ b/developer/contact.md @@ -1,5 +1,5 @@ # Contact -You can meet other helloSystem users and developers at [`#helloSystem:matrix.org`](https://matrix.to/#/#helloSystem:matrix.org) from any Matrix client (such as the Element web-based Matrix client). This Matrix channel is [bridged](https://matrix.org/blog/2015/06/22/the-matrix-org-irc-bridge-now-bridges-all-of-freenode) to the IRC channel (which we intend to move from freenode to libera.chat). Joining via Matrix has the advantage that you will see responses that you may have received while you were offline. So after asking a question, you can come back in a day or so to see if there were any responses. +You can meet other helloSystem users and developers at [`#helloSystem:matrix.org`](https://matrix.to/#/#helloSystem:matrix.org) from any Matrix client (such as the Element web-based Matrix client). This Matrix channel is bridged to the IRC channel #helloSystem on irc.libera.chat. Joining via Matrix has the advantage that you will see responses that you may have received while you were offline. So after asking a question, you can come back in a day or so to see if there were any responses. In any case, please stay in the channel for a few days and do not expect to receive answers immediately, since we are all volunteers. From cfe8b0b5f5b34fe4ea7e04363dbdc9a5fba69519 Mon Sep 17 00:00:00 2001 From: probonopd Date: Tue, 1 Jun 2021 18:51:36 +0200 Subject: [PATCH 376/592] #helloSystem on irc.libera.chat --- user/feedback.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/user/feedback.md b/user/feedback.md index 8b7fb0e6..e59042ac 100644 --- a/user/feedback.md +++ b/user/feedback.md @@ -12,6 +12,6 @@ Please check [https://github.com/helloSystem/hello](https://github.com/helloSyst You can meet other helloSystem users and developers in the `#helloSystem` [Internet Relay Chat](https://en.wikipedia.org/wiki/Internet_Relay_Chat) channel at `irc.freenode.net`. -Alternatively, you can [`#helloSystem:matrix.org`](https://matrix.to/#/#helloSystem:matrix.org) from any Matrix client (such as the Element web-based Matrix client). This Matrix channel is [bridged](https://matrix.org/blog/2015/06/22/the-matrix-org-irc-bridge-now-bridges-all-of-freenode) to the IRC channel. Joining via Matrix has the advantage that you will see responses that you may have received while you were offline. So after asking a question, you can come back in a day or so to see if there were any responses. +Alternatively, you can [`#helloSystem:matrix.org`](https://matrix.to/#/#helloSystem:matrix.org) from any Matrix client (such as the Element web-based Matrix client). This Matrix channel is bridged to the IRC channel #helloSystem on irc.libera.chat. Joining via Matrix has the advantage that you will see responses that you may have received while you were offline. So after asking a question, you can come back in a day or so to see if there were any responses. In any case, please stay in the channel for a few days and do not expect to receive answers immediately, since we are all volunteers. From 2a5d027d59bf2bc28e8a17588250be5f97c96ea8 Mon Sep 17 00:00:00 2001 From: probonopd Date: Tue, 1 Jun 2021 19:09:27 +0200 Subject: [PATCH 377/592] irc.libera.chat --- user/feedback.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/user/feedback.md b/user/feedback.md index e59042ac..6e6526f3 100644 --- a/user/feedback.md +++ b/user/feedback.md @@ -10,8 +10,8 @@ Please check [https://github.com/helloSystem/hello](https://github.com/helloSyst ## Chat -You can meet other helloSystem users and developers in the `#helloSystem` [Internet Relay Chat](https://en.wikipedia.org/wiki/Internet_Relay_Chat) channel at `irc.freenode.net`. +You can meet other helloSystem users and developers in the `#helloSystem` [Internet Relay Chat](https://en.wikipedia.org/wiki/Internet_Relay_Chat) channel at `irc.libera.chat`. -Alternatively, you can [`#helloSystem:matrix.org`](https://matrix.to/#/#helloSystem:matrix.org) from any Matrix client (such as the Element web-based Matrix client). This Matrix channel is bridged to the IRC channel #helloSystem on irc.libera.chat. Joining via Matrix has the advantage that you will see responses that you may have received while you were offline. So after asking a question, you can come back in a day or so to see if there were any responses. +Alternatively, you can [`#helloSystem:matrix.org`](https://matrix.to/#/#helloSystem:matrix.org) from any Matrix client (such as the Element web-based Matrix client). This Matrix channel is bridged to the IRC channel. Joining via Matrix has the advantage that you will see responses that you may have received while you were offline. So after asking a question, you can come back in a day or so to see if there were any responses. In any case, please stay in the channel for a few days and do not expect to receive answers immediately, since we are all volunteers. From c850c978cb1ef93a4ada0e48cce8db458b882ede Mon Sep 17 00:00:00 2001 From: probonopd Date: Thu, 3 Jun 2021 12:56:22 +0200 Subject: [PATCH 378/592] Update index.md --- index.md | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/index.md b/index.md index 7017b2ef..062f018c 100644 --- a/index.md +++ b/index.md @@ -8,9 +8,7 @@ .. centered:: Willkommen • Welcome • Bienvenue • Benvenuto • Bienvenido • ようこそ • Mabuhay • Välkommen • Добро пожаловать • Merhaba • Bonvenon • 歡迎 ``` -# hello - -__hello__ (also known as __helloSystem__) is a desktop system for creators with a focus on simplicity, elegance, and usability. Its design follows the "Less, but better" philosophy. It is intended as a system for "mere mortals", welcoming to switchers from the Mac. [FreeBSD](https://www.freebsd.org/) is used as the core operating system. Please refer to [https://github.com/helloSystem/hello](https://github.com/helloSystem/hello) if you would like to learn more about the ideas and principles behind hello. +__helloSystem__ is a desktop system for creators with a focus on simplicity, elegance, and usability. Its design follows the "Less, but better" philosophy. It is intended as a system for "mere mortals", welcoming to switchers from the Mac. [FreeBSD](https://www.freebsd.org/) is used as the core operating system. Please refer to [https://github.com/helloSystem/hello](https://github.com/helloSystem/hello) if you would like to learn more about the ideas and principles behind hello. ![Screenshot](https://github.com/helloSystem/hello/blob/master/screenshots/20210210-desktop-0.4.png?raw=true) From ce1a53a6e6f355abd7d14b4225bb259cad85909a Mon Sep 17 00:00:00 2001 From: probonopd Date: Thu, 3 Jun 2021 13:00:03 +0200 Subject: [PATCH 379/592] Update index.md --- index.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/index.md b/index.md index 062f018c..5df255bf 100644 --- a/index.md +++ b/index.md @@ -8,6 +8,8 @@ .. centered:: Willkommen • Welcome • Bienvenue • Benvenuto • Bienvenido • ようこそ • Mabuhay • Välkommen • Добро пожаловать • Merhaba • Bonvenon • 歡迎 ``` +# hello + __helloSystem__ is a desktop system for creators with a focus on simplicity, elegance, and usability. Its design follows the "Less, but better" philosophy. It is intended as a system for "mere mortals", welcoming to switchers from the Mac. [FreeBSD](https://www.freebsd.org/) is used as the core operating system. Please refer to [https://github.com/helloSystem/hello](https://github.com/helloSystem/hello) if you would like to learn more about the ideas and principles behind hello. ![Screenshot](https://github.com/helloSystem/hello/blob/master/screenshots/20210210-desktop-0.4.png?raw=true) From 6dbc5fcd5a5664a31d63807a6aef06e62e3b33b9 Mon Sep 17 00:00:00 2001 From: probonopd Date: Thu, 3 Jun 2021 13:00:39 +0200 Subject: [PATCH 380/592] Update conf.py --- conf.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/conf.py b/conf.py index aeed091f..0e4843b2 100644 --- a/conf.py +++ b/conf.py @@ -27,7 +27,7 @@ author = 'probono' # The full version, including alpha/beta/rc tags -release = 'experimental' +release = '' # 'experimental' # We don't want this in the HTML title # -- General configuration --------------------------------------------------- From 4160560690c7955174cd96c7d332e9d81092c8ff Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 6 Jun 2021 14:28:00 +0200 Subject: [PATCH 381/592] Update ports.md --- developer/ports.md | 21 ++++++++------------- 1 file changed, 8 insertions(+), 13 deletions(-) diff --git a/developer/ports.md b/developer/ports.md index e6c2431e..875e5972 100644 --- a/developer/ports.md +++ b/developer/ports.md @@ -68,9 +68,8 @@ sudo cp work/qtermwidget-*/lib/TerminalDisplay.cpp work/qtermwidget-*/lib/Termin # Make the change in the library sudo nano work/qtermwidget-*/lib/TerminalDisplay.cpp - dropText += QLatin1Char('\''); - dropText += urlText; - dropText += QLatin1Char('\''); + QChar q(QLatin1Char('\'')); + dropText += q + QString(urlText).replace(q, QLatin1String("'\\''")) + q; dropText += QLatin1Char(' '); # Make a patch @@ -90,21 +89,17 @@ As a result we have a patch: % cat files/patch-lib_TerminalDisplay.cpp --- lib/TerminalDisplay.cpp.orig 2020-11-03 08:19:26 UTC +++ lib/TerminalDisplay.cpp -@@ -3099,10 +3099,10 @@ void TerminalDisplay::dropEvent(QDropEvent* event) +@@ -3099,7 +3099,9 @@ void TerminalDisplay::dropEvent(QDropEvent* event) // without quoting them (this only affects paths with spaces in) //urlText = KShell::quoteArg(urlText); - dropText += urlText; -- -- if ( i != urls.count()-1 ) -- dropText += QLatin1Char(' '); -+ dropText += QLatin1Char('\''); -+ dropText += urlText; -+ dropText += QLatin1Char('\''); ++ QChar q(QLatin1Char('\'')); ++ dropText += q + QString(urlText).replace(q, QLatin1String("'\\''")) + q; + dropText += QLatin1Char(' '); - } - } - else + + if ( i != urls.count()-1 ) + dropText += QLatin1Char(' '); ``` ## Making packages From 77563e9602915ab339b62d9de19ff91e50c65289 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 12 Jun 2021 10:44:56 +0200 Subject: [PATCH 382/592] 0.5.0 --- user/getting-started.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/user/getting-started.md b/user/getting-started.md index e4352046..a64827b8 100644 --- a/user/getting-started.md +++ b/user/getting-started.md @@ -128,8 +128,10 @@ Then add these two `qemu-system-x86_64` options: ## Downloading -ISO images are available for download [here](https://github.com/helloSystem/ISO/releases/). +The **helloSystem 0.5.0 ** ISO image is available for download [here](https://github.com/helloSystem/ISO/releases/tag/r0.5.0). + +Experimental and pre-release images are available for download [here](https://github.com/helloSystem/ISO/releases). ```eval_rst -important:: Images get built automatically whenever source code is committed. Not every build is tested. Builds marked as "Pre-Release" are strictly for developers, may be broken and may not even boot. +important:: Experimental images get built automatically whenever source code is committed. Not every build is tested. Builds marked as "Pre-Release" are strictly for developers, may be broken and may not even boot. ``` From d0dafe7ad6009175a4420993d4d4cc6d0b0685c3 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 12 Jun 2021 10:52:58 +0200 Subject: [PATCH 383/592] Update getting-started.md --- user/getting-started.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/user/getting-started.md b/user/getting-started.md index a64827b8..a6239459 100644 --- a/user/getting-started.md +++ b/user/getting-started.md @@ -128,10 +128,10 @@ Then add these two `qemu-system-x86_64` options: ## Downloading -The **helloSystem 0.5.0 ** ISO image is available for download [here](https://github.com/helloSystem/ISO/releases/tag/r0.5.0). +The **helloSystem 0.5.0** ISO image is available for download [here](https://github.com/helloSystem/ISO/releases/tag/r0.5.0). Experimental and pre-release images are available for download [here](https://github.com/helloSystem/ISO/releases). -```eval_rst -important:: Experimental images get built automatically whenever source code is committed. Not every build is tested. Builds marked as "Pre-Release" are strictly for developers, may be broken and may not even boot. +``` .. important:: + Experimental images get built automatically whenever source code is committed. Not every build is tested. Builds marked as "Pre-Release" are strictly for developers, may be broken and may not even boot. ``` From 4217787bddf2fe2af67ee5600f7a3daf48ea8aaa Mon Sep 17 00:00:00 2001 From: probonopd Date: Wed, 16 Jun 2021 20:44:28 +0200 Subject: [PATCH 384/592] Update ux-guidelines.md --- developer/ux-guidelines.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/developer/ux-guidelines.md b/developer/ux-guidelines.md index 1afe5b26..89b4192c 100644 --- a/developer/ux-guidelines.md +++ b/developer/ux-guidelines.md @@ -15,7 +15,7 @@ Source: [Apple Computer, Inc., 1992, Macintosh Human Interface Guidelines, First Referred to in the Macintosh Human Interface Guidelines with highest praise: > A seminal paper on why pull-down menus are superior to any other kind. -> Everyone who designs for the screen must read this paper. Everyone who designs for the screen must read this paper. +> Everyone who designs for the screen must read this paper. This paper provides empirical evidence on the superiority of global menus. From 6b346379984ab9b467a66b73b8060eb7979020ec Mon Sep 17 00:00:00 2001 From: probonopd Date: Wed, 16 Jun 2021 20:49:02 +0200 Subject: [PATCH 385/592] Implementations for other desktop systems --- developer/menu.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/developer/menu.md b/developer/menu.md index e5764bda..76dfa08c 100644 --- a/developer/menu.md +++ b/developer/menu.md @@ -346,3 +346,8 @@ Applications running as root currently cannot show global menus due to the D-Bus Please consider contributing ideas and code if you are interested in this topic. ``` + +## Implementations for other desktop systems + +* [Fildem](https://github.com/gonzaarcr/Fildem) for GNOME +* [CutefishOS](https://twitter.com/cutefishos/status/1401420887568441345) From 475e41a0352d9615909738db417f33afc9780ecc Mon Sep 17 00:00:00 2001 From: probonopd Date: Wed, 16 Jun 2021 20:54:26 +0200 Subject: [PATCH 386/592] Update ux-guidelines.md --- developer/ux-guidelines.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/developer/ux-guidelines.md b/developer/ux-guidelines.md index 89b4192c..638f1bbd 100644 --- a/developer/ux-guidelines.md +++ b/developer/ux-guidelines.md @@ -23,7 +23,7 @@ This paper provides empirical evidence on the superiority of global menus. advantage over other menu systems. > > In this experiment the initial movement to the pull-down menus was larger that -average distance required to reach the top of a 19 inch diagonal screen, yet the p&downs still significantly outperformed the walking menus. Therefore, it may be +average distance required to reach the top of a 19 inch diagonal screen, yet the pull-downs still significantly outperformed the walking menus. Therefore, it may be more efficient to place menus at the top of the window Source: Walker, N & Smelcer, JB 1990, A comparison of selection times from walking and pull-down menus. in JC Chew & J Whiteside (eds), Proceedings of the SIGCHI Conference on Human Factors in Computing Systems, CHI 1990. Association for Computing Machinery, pp. 221-225, 1990 SIGCHI Conference on Human Factors in Computing Systems, CHI 1990, Seattle, United States, 4/1/90. https://dl.acm.org/doi/pdf/10.1145/97243.97277 From e6c2ca9b83135b16b62f8301a59a6f58180bf2a9 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 21 Jun 2021 19:45:22 +0200 Subject: [PATCH 387/592] Update applications.md --- user/components/applications.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/user/components/applications.md b/user/components/applications.md index 1f02b224..b3a43290 100644 --- a/user/components/applications.md +++ b/user/components/applications.md @@ -4,7 +4,9 @@ Most applications in helloSystem come in the form of __application bundles__. An ![Viewing the contents of an application bundle](https://pbs.twimg.com/media/EoK9u7vXUAAJFPn?format=png) -helloSystem comes with the following applications, each of which are described in this section: +helloSystem comes with some applications out of the box, and some applications need to be downloaded before they can be used. + +You find the applications in the menu under "System -> Applications", and in the `/Applications` folder on your hard disk, although they can also be placed in other locations if you so desire. ```eval_rst .. toctree:: From f27e27ec53f53f6e900a0a6e38d7ad84f217611d Mon Sep 17 00:00:00 2001 From: tuskpot <30544466+tuskpot@users.noreply.github.com> Date: Mon, 21 Jun 2021 13:57:22 -0500 Subject: [PATCH 388/592] Fix a typo (#28) --- user/components/preferences/desktop.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/user/components/preferences/desktop.md b/user/components/preferences/desktop.md index b65a55bf..39b34e0e 100644 --- a/user/components/preferences/desktop.md +++ b/user/components/preferences/desktop.md @@ -1,6 +1,6 @@ # Desktop -The __Desktop__ preferences application allows you do customize the behavior of your computer's desktop. +The __Desktop__ preferences application allows you to customize the behavior of your computer's desktop. ## Background From 5d4eb32ccb60446418821db7372c22ef66ad269b Mon Sep 17 00:00:00 2001 From: tuskpot <30544466+tuskpot@users.noreply.github.com> Date: Wed, 23 Jun 2021 12:09:58 -0500 Subject: [PATCH 389/592] Fix typos (#30) --- user/feedback.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/user/feedback.md b/user/feedback.md index 6e6526f3..3ab7cc78 100644 --- a/user/feedback.md +++ b/user/feedback.md @@ -6,12 +6,12 @@ If you would share your experience with helloSystem on twitter, use the [`#hello ## Discussing ideas and wishlist items -Please check [https://github.com/helloSystem/hello](https://github.com/helloSystem/hello) fist, including the [wiki](https://github.com/helloSystem/hello/wiki). Feel free to discuss ideas and wishlist items at [https://github.com/helloSystem/hello/issues](https://github.com/helloSystem/hello/issues), but please do keep in mind that in order to achieve the intended goal of simplicity, the team needs to say "no" to most wishlist items that do not further that goal. +Please check [https://github.com/helloSystem/hello](https://github.com/helloSystem/hello) first, including the [wiki](https://github.com/helloSystem/hello/wiki). Feel free to discuss ideas and wishlist items at [https://github.com/helloSystem/hello/issues](https://github.com/helloSystem/hello/issues), but please do keep in mind that in order to achieve the intended goal of simplicity, the team needs to say "no" to most wishlist items that do not further that goal. ## Chat You can meet other helloSystem users and developers in the `#helloSystem` [Internet Relay Chat](https://en.wikipedia.org/wiki/Internet_Relay_Chat) channel at `irc.libera.chat`. -Alternatively, you can [`#helloSystem:matrix.org`](https://matrix.to/#/#helloSystem:matrix.org) from any Matrix client (such as the Element web-based Matrix client). This Matrix channel is bridged to the IRC channel. Joining via Matrix has the advantage that you will see responses that you may have received while you were offline. So after asking a question, you can come back in a day or so to see if there were any responses. +Alternatively, you can join [`#helloSystem:matrix.org`](https://matrix.to/#/#helloSystem:matrix.org) from any Matrix client (such as the Element web-based Matrix client). This Matrix channel is bridged to the IRC channel. Joining via Matrix has the advantage that you will see responses that you may have received while you were offline. So after asking a question, you can come back in a day or so to see if there were any responses. In any case, please stay in the channel for a few days and do not expect to receive answers immediately, since we are all volunteers. From c95aeada596c10ab804ab0389110575400e9f7cb Mon Sep 17 00:00:00 2001 From: tuskpot <30544466+tuskpot@users.noreply.github.com> Date: Wed, 23 Jun 2021 12:10:52 -0500 Subject: [PATCH 390/592] Clean up note formatting (#29) --- user/components/utilities/hardware-probe.md | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/user/components/utilities/hardware-probe.md b/user/components/utilities/hardware-probe.md index f0712a93..6925ef96 100644 --- a/user/components/utilities/hardware-probe.md +++ b/user/components/utilities/hardware-probe.md @@ -15,9 +15,7 @@ Private information (including the username, machine's hostname, IP addresses, M The tool uploads 32-byte prefix of salted SHA512 hash of MAC addresses/UUIDs and serial numbers to properly identify unique computers and hard drives. All the data is uploaded securely via HTTPS. ``` .. note:: - By using this utility to upload your hardware probe, you agree that -information about your hardware will be uploaded -to a publicly visible database. + By using this utility to upload your hardware probe, you agree that information about your hardware will be uploaded to a publicly visible database. Do not use this utility if you do not agree with this. ``` From 280113ded4561ac3c2a18e75898c6cbe0cd78847 Mon Sep 17 00:00:00 2001 From: probonopd Date: Wed, 30 Jun 2021 00:51:31 +0200 Subject: [PATCH 391/592] Update acknowledgements.md --- developer/acknowledgements.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/developer/acknowledgements.md b/developer/acknowledgements.md index b0cc46e0..68b127f9 100644 --- a/developer/acknowledgements.md +++ b/developer/acknowledgements.md @@ -98,10 +98,14 @@ __[moochris](https://github.com/moochris)__ * Providing infrastructure for crowd-sourced translations ## Chris Rees -__[crees](https://github.com/__crees)__ +__[crees](https://github.com/crees)__ * Made it possible to use a fixed Intel GPU driver for FreeBSD 12.2 from a private package * Created a package for the Falkon browser that does not pull in many KDE dependencies * Updated required FreeBSD ports and helped writing new ports ## Jordan Gordeev * Wrote `geom_rowr` FreeBSD kernel module to combine a read-only with a read-write device + +## Jesper Schmitz Mouridsen +__[jsm222](https://github.com/jsm222)__ +* Packaging helloDesktop components for FreeBSD Ports From c2e38e9bdc25f3ce3072ce266f8d607e1565b13d Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 18 Jul 2021 20:53:39 +0200 Subject: [PATCH 392/592] Update distributions.md --- developer/distributions.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/developer/distributions.md b/developer/distributions.md index 11e429a2..4b8685a3 100644 --- a/developer/distributions.md +++ b/developer/distributions.md @@ -8,4 +8,9 @@ __Please do not try to include helloSystem in third-party distributions.__ While __Please do not call your derivatives "hello" or "helloSystem"__. In order to keep support and maintenance burden low, please give clearly distinguishable names to your derivatives. +You may want to include the desktop components of helloSystem, the helloDesktop "Desktop Environment" (collection of individual components, really). + +For example, work is being done to bring the helloDesktop components to FreeBSD: +https://wiki.freebsd.org/helloDesktop + Please do not hesitate to contact the team if you have questions regarding this policy. From 59663fda51514ead95bfe061d812ebb9409029b9 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 18 Jul 2021 20:54:03 +0200 Subject: [PATCH 393/592] helloDesktop --- developer/distributions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/developer/distributions.md b/developer/distributions.md index 4b8685a3..9c97148e 100644 --- a/developer/distributions.md +++ b/developer/distributions.md @@ -8,7 +8,7 @@ __Please do not try to include helloSystem in third-party distributions.__ While __Please do not call your derivatives "hello" or "helloSystem"__. In order to keep support and maintenance burden low, please give clearly distinguishable names to your derivatives. -You may want to include the desktop components of helloSystem, the helloDesktop "Desktop Environment" (collection of individual components, really). +You may want to include the desktop components of helloSystem, the **helloDesktop** "Desktop Environment" (collection of individual components, really). For example, work is being done to bring the helloDesktop components to FreeBSD: https://wiki.freebsd.org/helloDesktop From caaad64f86effa91478fb23fa285734f44dfe75e Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 18 Jul 2021 20:54:48 +0200 Subject: [PATCH 394/592] Update distributions.md --- developer/distributions.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/developer/distributions.md b/developer/distributions.md index 9c97148e..17da185d 100644 --- a/developer/distributions.md +++ b/developer/distributions.md @@ -10,7 +10,6 @@ __Please do not call your derivatives "hello" or "helloSystem"__. In order to ke You may want to include the desktop components of helloSystem, the **helloDesktop** "Desktop Environment" (collection of individual components, really). -For example, work is being done to bring the helloDesktop components to FreeBSD: -https://wiki.freebsd.org/helloDesktop +For example, work is being done to bring the helloDesktop components to FreeBSD: https://wiki.freebsd.org/helloDesktop. But please note that "FreeBSD with helloDesktop" is not the same as helloSystem. Please do not hesitate to contact the team if you have questions regarding this policy. From 13bd77111f863cfd65aa0ecbbc267b61176206cf Mon Sep 17 00:00:00 2001 From: kokakoda <5194429+kokakoda@users.noreply.github.com> Date: Wed, 11 Aug 2021 20:39:15 +0100 Subject: [PATCH 395/592] Update getting-started.md (#31) Resolutions over 800x600 available, added instructions. For all other options, I'd suggest using the same settings as QEMU above for consistency since Proxmox *is* QEMU under the hood. Machine type > q35 Network > VirtIO Display > Default (VGA) --- user/getting-started.md | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/user/getting-started.md b/user/getting-started.md index a6239459..9dd5cdb3 100644 --- a/user/getting-started.md +++ b/user/getting-started.md @@ -119,12 +119,14 @@ Then add these two `qemu-system-x86_64` options: * Memory: 4GB (not ballooned) * Processors: 2 (1 socket 2 cores) * BIOS: OVMF (UEFI) -* Display: VMWare Compatible (vmware) [seems to be limited to 800x600 pixels resolution] -* Machine: Default (i440fx) +* Display: Default (VGA) +* Machine: q35 * SCSI Controller: VirtIO SCSI * CD Drive: helloSystem ISO * Hard Disk: At least 8GB Raw -* Network Device: vmxnet3 +* Network Device: VirtIO + +To set resolution, press F2 at boot to access OVMF settings. Select 'Device Manager > OVMF Platform Configuration > Change Preferred', save and reboot. ## Downloading From cbee876fb29ac46fd9ab06bdf430ad1967532c26 Mon Sep 17 00:00:00 2001 From: probonopd Date: Tue, 14 Sep 2021 21:18:39 +0200 Subject: [PATCH 396/592] Update screenshot to 0.5 --- index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.md b/index.md index 5df255bf..2c1b29f9 100644 --- a/index.md +++ b/index.md @@ -12,7 +12,7 @@ __helloSystem__ is a desktop system for creators with a focus on simplicity, elegance, and usability. Its design follows the "Less, but better" philosophy. It is intended as a system for "mere mortals", welcoming to switchers from the Mac. [FreeBSD](https://www.freebsd.org/) is used as the core operating system. Please refer to [https://github.com/helloSystem/hello](https://github.com/helloSystem/hello) if you would like to learn more about the ideas and principles behind hello. -![Screenshot](https://github.com/helloSystem/hello/blob/master/screenshots/20210210-desktop-0.4.png?raw=true) +![Screenshot](https://github.com/helloSystem/hello/blob/master/screenshots/20210611-desktop-0.5.png?raw=true) ```eval_rst .. toctree:: From 6c2d6d48063db3d4281a4f0710c40e65228fc78a Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 19 Sep 2021 12:00:50 +0200 Subject: [PATCH 397/592] Update acknowledgements.md --- developer/acknowledgements.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/developer/acknowledgements.md b/developer/acknowledgements.md index 68b127f9..22d5ea60 100644 --- a/developer/acknowledgements.md +++ b/developer/acknowledgements.md @@ -109,3 +109,8 @@ __[crees](https://github.com/crees)__ ## Jesper Schmitz Mouridsen __[jsm222](https://github.com/jsm222)__ * Packaging helloDesktop components for FreeBSD Ports + +## Sergey Tyuryukanovc +__[s199p.wa1k9k](https://github.com/s199pwa1k9r)__ +@S199pWa1k9r on twitter +* Packaging helloDesktop components for FreeBSD Ports on aarch64 From 30918c802cf8d85d6091f1cc359fba5ce71371b9 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 19 Sep 2021 12:01:03 +0200 Subject: [PATCH 398/592] Update acknowledgements.md --- developer/acknowledgements.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/developer/acknowledgements.md b/developer/acknowledgements.md index 22d5ea60..02f03c3d 100644 --- a/developer/acknowledgements.md +++ b/developer/acknowledgements.md @@ -110,7 +110,7 @@ __[crees](https://github.com/crees)__ __[jsm222](https://github.com/jsm222)__ * Packaging helloDesktop components for FreeBSD Ports -## Sergey Tyuryukanovc +## Sergey Tyuryukanov __[s199p.wa1k9k](https://github.com/s199pwa1k9r)__ @S199pWa1k9r on twitter * Packaging helloDesktop components for FreeBSD Ports on aarch64 From caaf1fac2f39802f14abd19669092bb83e998f21 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 19 Sep 2021 13:38:38 +0200 Subject: [PATCH 399/592] Update rpi.md --- developer/rpi.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/developer/rpi.md b/developer/rpi.md index a47f50d2..c63cfb3c 100644 --- a/developer/rpi.md +++ b/developer/rpi.md @@ -228,7 +228,7 @@ Otherwise the root device may not be found upon reboot. ### Enabling D-Bus and Avahi -Zeroconf does not work if `/usr/local/bin/dbus-daemon --system` is not running. hence add the following lines to `/etc/rc.conf' to enable it: +Filer does not launch and Zeroconf does not work if `/usr/local/bin/dbus-daemon --system` is not running. Hence add the following lines to `/etc/rc.conf' to enable it: ``` dbus_enable="YES" From 41e0761149f09f43ba1a5c6439a9308a8d5aaabf Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 19 Sep 2021 18:37:48 +0200 Subject: [PATCH 400/592] =?UTF-8?q?Zo=C3=AB=20Knox?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- developer/acknowledgements.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/developer/acknowledgements.md b/developer/acknowledgements.md index 02f03c3d..8aeac00e 100644 --- a/developer/acknowledgements.md +++ b/developer/acknowledgements.md @@ -114,3 +114,8 @@ __[jsm222](https://github.com/jsm222)__ __[s199p.wa1k9k](https://github.com/s199pwa1k9r)__ @S199pWa1k9r on twitter * Packaging helloDesktop components for FreeBSD Ports on aarch64 + +## Zoë Knox +__[mszoek](https://github.com/mszoek)__ +@thatzoek on twitter +* Implemented `org.freedesktop.FileManager1` API in Filer From 8ccfdcd4d87daaaca11b481129e2fa180ad8bc38 Mon Sep 17 00:00:00 2001 From: probonopd Date: Tue, 21 Sep 2021 18:37:03 +0200 Subject: [PATCH 401/592] Use SATA instead of SCSI https://github.com/helloSystem/hello/issues/205 --- user/getting-started.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/user/getting-started.md b/user/getting-started.md index 9dd5cdb3..039501e4 100644 --- a/user/getting-started.md +++ b/user/getting-started.md @@ -121,7 +121,7 @@ Then add these two `qemu-system-x86_64` options: * BIOS: OVMF (UEFI) * Display: Default (VGA) * Machine: q35 -* SCSI Controller: VirtIO SCSI +* SATA Controller: VirtIO SATA for attaching virtual disk to (to install the system on) * CD Drive: helloSystem ISO * Hard Disk: At least 8GB Raw * Network Device: VirtIO From 9be9c4c24f509ade10d4fe55d8d177f0a4f934f7 Mon Sep 17 00:00:00 2001 From: probonopd Date: Fri, 1 Oct 2021 11:51:02 +0200 Subject: [PATCH 402/592] Update menu.md --- developer/menu.md | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff --git a/developer/menu.md b/developer/menu.md index 76dfa08c..cd31093a 100644 --- a/developer/menu.md +++ b/developer/menu.md @@ -284,13 +284,11 @@ _To be written._ ## Patches needed for Firefox and Thunderbird -It seems that one would need to apply these two patches from [firefox-appmenu in AUR](https://aur.archlinux.org/packages/firefox-appmenu/,https://aur.archlinux.org/cgit/aur.git/tree/unity-menubar.patch?h=firefox-appmenu): +Firefox and Thunderbird need substantial source code patches to make global menus work: -* https://aur.archlinux.org/cgit/aur.git/tree/unity-menubar.patch?h=firefox-appmenu +* https://aur.archlinux.org/cgit/aur.git/tree/unity-menubar.patch?h=firefox-appmenu. See https://github.com/airyxos/Firefox_app for a FreeBSD implementation * https://aur.archlinux.org/cgit/aur.git/tree/0001-Use-remoting-name-for-GDK-application-names.patch?h=firefox-appmenu -_To be verified._ - ### GMenu-DBusMenu-Proxy ``` From 9c5c328116b1282ae62bc81be10a674c13d4e6c5 Mon Sep 17 00:00:00 2001 From: probonopd Date: Thu, 7 Oct 2021 21:46:58 +0200 Subject: [PATCH 403/592] Update localization.md --- developer/localization.md | 34 ++++++++++++++++++++++++++++++++-- 1 file changed, 32 insertions(+), 2 deletions(-) diff --git a/developer/localization.md b/developer/localization.md index f479765e..91fe3e30 100644 --- a/developer/localization.md +++ b/developer/localization.md @@ -1,5 +1,35 @@ # Localization -helloSystem is localized at https://hosted.weblate.org/projects/hellosystem/. +helloSystem is localized on [Hosted Weblate](https://hosted.weblate.org/projects/hellosystem/). -Further details will be added here. + +Translation status + + +## Contributing translations + +helloSystem is translated into many languages by volunteers all over the world. + +Translation happens on [Weblate](https://hosted.weblate.org/engage/hellosystem/). Everyone can contribute! Be sure to use the "Automatic suggestions" button which suggests translations from Deepl, Google Translate, Microsoft Translator, and various open source projects. This reduces the work to picking the most appropriate translation in many cases. + +## Making strings available for translation + +### Python + +To make new strings available for translation, a developer runs in the respective application directory: + +``` +cd Resources/ +mkdir -p i18n + +# Create/update .ts file for English +pylupdate5 -noobsolete *.{py,ui} -ts i18n/en.ts + +# Remove unneeded location tags +xml ed -L -d '//location' i18n/en.ts + +# Remove translations from en, since en is not to be further translated +xml ed -L -d '//translation' i18n/en.ts +``` + +Translators do not need to do this. From 9f6f56ce49e65c1c0de8cf2dbb7692b5a0bbdbcd Mon Sep 17 00:00:00 2001 From: probonopd Date: Thu, 7 Oct 2021 21:50:14 +0200 Subject: [PATCH 404/592] Update localization.md --- developer/localization.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/developer/localization.md b/developer/localization.md index 91fe3e30..54e93277 100644 --- a/developer/localization.md +++ b/developer/localization.md @@ -14,6 +14,10 @@ Translation happens on [Weblate](https://hosted.weblate.org/engage/hellosystem/) ## Making strings available for translation +### Qt + +Follow the best practices for internationalization of Qt projects. To be documented. + ### Python To make new strings available for translation, a developer runs in the respective application directory: From 131141e980148829df91b11ca515fa3af4342af3 Mon Sep 17 00:00:00 2001 From: probonopd Date: Thu, 7 Oct 2021 21:53:34 +0200 Subject: [PATCH 405/592] Update localization.md --- developer/localization.md | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) diff --git a/developer/localization.md b/developer/localization.md index 54e93277..2fcdfa3d 100644 --- a/developer/localization.md +++ b/developer/localization.md @@ -20,6 +20,29 @@ Follow the best practices for internationalization of Qt projects. To be documen ### Python +helloSystem uses `tstranslator.py` to translate applications using Qt `.ts` files without the need for compilation. To achieve this, import and set up tstranslator as follows: + +``` +# Translate this application using Qt .ts files without the need for compilation +import tstranslator +tstr = tstranslator.TsTranslator(os.path.dirname(__file__) + "/i18n", "") +def tr(input): + return tstr.tr(input) +``` + +In the class that defines your MainWindow or Wizard, do the following: + +``` +class Wizard(QtWidgets.QWizard, object): + def __init__(self): + (...) + # Translate the widgets in the UI objects in the Wizard + self.setWindowTitle(tr(self.windowTitle())) + for e in self.findChildren(QtCore.QObject, None, QtCore.Qt.FindChildrenRecursively): + if hasattr(e, 'text') and hasattr(e, 'setText'): + e.setText(tr(e.text())) +``` + To make new strings available for translation, a developer runs in the respective application directory: ``` From a4f1ffe21674009c5e62e47f263aae130711c031 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 10 Oct 2021 18:10:39 +0200 Subject: [PATCH 406/592] Update troubleshooting.md --- user/troubleshooting.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/user/troubleshooting.md b/user/troubleshooting.md index 3105e8e9..8c2c5156 100644 --- a/user/troubleshooting.md +++ b/user/troubleshooting.md @@ -45,4 +45,4 @@ If your issue is not already reported, you can create a new one. ## Getting help -Please [contact us](https://hellosystem.github.io/docs/developer/contact.html). +Please participate in our [discussion forum](https://github.com/helloSystem/hello/discussions) or [contact us](https://hellosystem.github.io/docs/developer/contact.html). From 565081cc3e177df5dfee322191b129e0e02a4942 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 10 Oct 2021 18:12:40 +0200 Subject: [PATCH 407/592] Update feedback.md --- user/feedback.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/user/feedback.md b/user/feedback.md index 3ab7cc78..7de1a1cd 100644 --- a/user/feedback.md +++ b/user/feedback.md @@ -8,6 +8,10 @@ If you would share your experience with helloSystem on twitter, use the [`#hello Please check [https://github.com/helloSystem/hello](https://github.com/helloSystem/hello) first, including the [wiki](https://github.com/helloSystem/hello/wiki). Feel free to discuss ideas and wishlist items at [https://github.com/helloSystem/hello/issues](https://github.com/helloSystem/hello/issues), but please do keep in mind that in order to achieve the intended goal of simplicity, the team needs to say "no" to most wishlist items that do not further that goal. +## Discussion forum + +Please see our [GitHub Discussions](https://github.com/helloSystem/hello/discussions) and do not hesitate to post your ideas, questions, and show us what you are doing with helloSystem in th "Show&Tell" category. + ## Chat You can meet other helloSystem users and developers in the `#helloSystem` [Internet Relay Chat](https://en.wikipedia.org/wiki/Internet_Relay_Chat) channel at `irc.libera.chat`. From a7e16670614d51c7958dd8d8d1d263e16694337f Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 10 Oct 2021 18:57:47 +0200 Subject: [PATCH 408/592] Update screenshot --- index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.md b/index.md index 2c1b29f9..188590f6 100644 --- a/index.md +++ b/index.md @@ -12,7 +12,7 @@ __helloSystem__ is a desktop system for creators with a focus on simplicity, elegance, and usability. Its design follows the "Less, but better" philosophy. It is intended as a system for "mere mortals", welcoming to switchers from the Mac. [FreeBSD](https://www.freebsd.org/) is used as the core operating system. Please refer to [https://github.com/helloSystem/hello](https://github.com/helloSystem/hello) if you would like to learn more about the ideas and principles behind hello. -![Screenshot](https://github.com/helloSystem/hello/blob/master/screenshots/20210611-desktop-0.5.png?raw=true) +![Screenshot](https://raw.githubusercontent.com/helloSystem/hello/1db268eb69c8c45909d1dc0f642395b5f948a338/screenshots/20211002-desktop-0.6.png) ```eval_rst .. toctree:: From 6a04a19e7f92d06550852ff45fcb38e550fe3df4 Mon Sep 17 00:00:00 2001 From: mr-grooms Date: Sat, 16 Oct 2021 13:34:44 -0500 Subject: [PATCH 409/592] Updating most to most recent build (#32) Updating to the most recent build. --- user/getting-started.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/user/getting-started.md b/user/getting-started.md index 039501e4..b04b6532 100644 --- a/user/getting-started.md +++ b/user/getting-started.md @@ -130,7 +130,7 @@ To set resolution, press F2 at boot to access OVMF settings. Select 'Device Mana ## Downloading -The **helloSystem 0.5.0** ISO image is available for download [here](https://github.com/helloSystem/ISO/releases/tag/r0.5.0). +The **helloSystem 0.6.0** ISO image is available for download [here](https://github.com/helloSystem/ISO/releases/tag/r0.6.0). Experimental and pre-release images are available for download [here](https://github.com/helloSystem/ISO/releases). From 29bc233068c079230b8248d8aae95291623b68d7 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 17 Oct 2021 20:08:31 +0200 Subject: [PATCH 410/592] Create update.md --- user/components/utilities/update.md | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) create mode 100644 user/components/utilities/update.md diff --git a/user/components/utilities/update.md b/user/components/utilities/update.md new file mode 100644 index 00000000..ca4304bd --- /dev/null +++ b/user/components/utilities/update.md @@ -0,0 +1,21 @@ +# Update + +Once you have installed the system to the hard disk in your computer, or an externally attached storage device, you may want to keep it recent by running the __Update__ utility from time to time. + +``` .. note:: + This utility is currently in **Developer Preview** status and is intended for developers and testers. Only use it if you have a backup of your system or if you are running on a test system that you can set up from scratch if needed. +``` + +## Testing + +Please follow this exact procedure when testing the Update utility: + +* Install a helloSystem 0.7.0 pre-release build to hard disk. +* Open QTerminal and run `sudo pkg lock --yes automount slim gvfs dejavu liberation-fonts-ttf`. This step is __important__ because otherwise the update will overwrite carefully crafted helloSystem customizations. (There may be more packages that need to be locked as well.) +* Run the __Boot Environments__ preferences application and create a new boot environment that you can switch back to in the case you are not satisfied with the updated system. __This is not a replacement for a backup.__ +* Run the __Update__ utility and follow the on-screen instructions. +* Once the update has completed, restart your computer to make full use of the updated software. + +Please submit any problems you might be running into to [this issue](https://github.com/helloSystem/Utilities/issues/33). + +Thanks for testing the Update utility. From 03bd70eecf2845a79335f1b16867c1b749a37c4f Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 17 Oct 2021 20:16:38 +0200 Subject: [PATCH 411/592] Update update.md --- user/components/utilities/update.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/user/components/utilities/update.md b/user/components/utilities/update.md index ca4304bd..ce6a8c4e 100644 --- a/user/components/utilities/update.md +++ b/user/components/utilities/update.md @@ -6,6 +6,13 @@ Once you have installed the system to the hard disk in your computer, or an exte This utility is currently in **Developer Preview** status and is intended for developers and testers. Only use it if you have a backup of your system or if you are running on a test system that you can set up from scratch if needed. ``` +This utility +* Updates the FreeBSD operating system components (kernel and userland) +* Updates all FreeBSD Packages +* Currently does _not_ update any applications that came with helloSystem as native application bundles + +![](https://user-images.githubusercontent.com/2480569/137626617-ffa339e5-5633-4fa4-84a5-9dd9c7f4b966.png) + ## Testing Please follow this exact procedure when testing the Update utility: From ead2ab6e1ad4b818a2bf5c38614939a9af08135e Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 17 Oct 2021 21:39:04 +0200 Subject: [PATCH 412/592] Update acknowledgements.md --- developer/acknowledgements.md | 1 + 1 file changed, 1 insertion(+) diff --git a/developer/acknowledgements.md b/developer/acknowledgements.md index 8aeac00e..df1fdce8 100644 --- a/developer/acknowledgements.md +++ b/developer/acknowledgements.md @@ -69,6 +69,7 @@ __[keshavbhatt](https://github.com/keshavbhatt)__ ## TheAssassin __[TheAssassin](https://github.com/TheAssassin)__ * Improved documentation by providing Sphinx evangelism and ReStructuredText help +* Helped with CMake and Qt translations ## Leodanis Pozo Ramos __[lpozo](https://github.com/lpozo)__ From eb58612ef90bf4d74760dce77b8470a04a0435d0 Mon Sep 17 00:00:00 2001 From: Josh Soref <2119212+jsoref@users.noreply.github.com> Date: Mon, 18 Oct 2021 03:01:03 -0400 Subject: [PATCH 413/592] Spelling (#33) * spelling: acceptable Signed-off-by: Josh Soref * spelling: actually Signed-off-by: Josh Soref * spelling: addressed Signed-off-by: Josh Soref * spelling: advertising Signed-off-by: Josh Soref * spelling: agreement Signed-off-by: Josh Soref * spelling: algorithm Signed-off-by: Josh Soref * spelling: application Signed-off-by: Josh Soref * spelling: clipboard Signed-off-by: Josh Soref * spelling: compatibility Signed-off-by: Josh Soref * spelling: consists Signed-off-by: Josh Soref * spelling: contributions Signed-off-by: Josh Soref * spelling: environment Signed-off-by: Josh Soref * spelling: examples Signed-off-by: Josh Soref * spelling: exercise Signed-off-by: Josh Soref * spelling: fallback Signed-off-by: Josh Soref * spelling: from Signed-off-by: Josh Soref * spelling: happens Signed-off-by: Josh Soref * spelling: implementation Signed-off-by: Josh Soref * spelling: implementer Signed-off-by: Josh Soref * spelling: increase Signed-off-by: Josh Soref * spelling: inherited Signed-off-by: Josh Soref * spelling: instructions Signed-off-by: Josh Soref * spelling: interfaces Signed-off-by: Josh Soref * spelling: laid out Signed-off-by: Josh Soref * spelling: libraries Signed-off-by: Josh Soref * spelling: logged Signed-off-by: Josh Soref * spelling: outputted Signed-off-by: Josh Soref * spelling: password Signed-off-by: Josh Soref * spelling: regarding Signed-off-by: Josh Soref * spelling: relocatable Signed-off-by: Josh Soref * spelling: responsibility Signed-off-by: Josh Soref * spelling: restarted Signed-off-by: Josh Soref * spelling: specify Signed-off-by: Josh Soref * spelling: useful Signed-off-by: Josh Soref * spelling: virtualized Signed-off-by: Josh Soref * spelling: you Signed-off-by: Josh Soref Co-authored-by: Josh Soref --- _static/theme_overrides.css | 2 +- developer/application-bundles.md | 8 +++---- developer/applications.md | 2 +- developer/architecture.md | 2 +- developer/binary-compatibility.md | 2 +- developer/boot.md | 2 +- developer/contributing.md | 2 +- developer/distributions.md | 2 +- developer/filer-context-menus.md | 24 +++++++++---------- developer/menu.md | 2 +- developer/rpi.md | 2 +- user/components.md | 2 +- user/components/applications/chromium.md | 4 ++-- .../preferences/boot-environments.md | 4 ++-- user/components/system/launch.md | 2 +- .../components/utilities/create-live-media.md | 2 +- user/components/utilities/install.md | 4 ++-- .../components/utilities/remote-assistance.md | 2 +- user/getting-started.md | 2 +- user/troubleshooting.md | 2 +- 20 files changed, 37 insertions(+), 37 deletions(-) diff --git a/_static/theme_overrides.css b/_static/theme_overrides.css index 470997ee..fc1beed1 100644 --- a/_static/theme_overrides.css +++ b/_static/theme_overrides.css @@ -53,7 +53,7 @@ div[class^="highlight"] pre { line-height: normal; } -/* Keep fields from being strangely far apart due to inheirited table CSS. */ +/* Keep fields from being strangely far apart due to inherited table CSS. */ .rst-content table.field-list th.field-name { padding-top: 1px; padding-bottom: 1px; diff --git a/developer/application-bundles.md b/developer/application-bundles.md index cf1bcfc9..d074f795 100644 --- a/developer/application-bundles.md +++ b/developer/application-bundles.md @@ -75,11 +75,11 @@ ln -s usr/local/lib . rm usr/local/bin/falkon-e ``` -This works because by coincidence the string `/usr/local/lib` has the exact same length as `$ORIGIN/../lib`. If this was not the case, one would need to either specifiy the rpath at compilation time, or use a tool such as `patchelf`. +This works because by coincidence the string `/usr/local/lib` has the exact same length as `$ORIGIN/../lib`. If this was not the case, one would need to either specify the rpath at compilation time, or use a tool such as `patchelf`. ### Avoiding absolute paths -For an application to be fully relocateable in the filesystem, one must take care that no absolute paths to data files (e.g., those in `/usr/share/` get compiled in. +For an application to be fully relocatable in the filesystem, one must take care that no absolute paths to data files (e.g., those in `/usr/share/` get compiled in. In Qt applications, void [`QStringList QStandardPaths::standardLocations(QStandardPaths::AppDataLocation);`](http://doc.qt.io/qt-5/qstandardpaths.html). According to the [Qt documentation](http://doc.qt.io/qt-5/qstandardpaths.html), this resolves to `"~/.local/share/", "/usr/local/share/", "/usr/share/"` but clearly `/usr` is not where these things are located in an `.app` bundle. @@ -92,7 +92,7 @@ https://github.com/KaidanIM/Kaidan/commit/da38011b55a1aa5d17764647ecd699deb4be43 Many desktop environments use XDG-style `.desktop` files to figure out which application a given window belongs to but since helloSystem is using `.app` bundles and `.AppDir` application directories this approach is not sufficient since such applications normally do not install XDG-style `.desktop` files in central locations. -Docks (and other similar applciations) can find the icon that belongs to a window on the screen by the following procedure: +Docks (and other similar applications) can find the icon that belongs to a window on the screen by the following procedure: 1. Get the Window IDs of the windows on the screen from Xorg (to simulate this, you can use the `xprop` tool) 1. Get the process ID (PID) that has launched the window with this ID from the `_NET_WM_PID` property of the Xorg window @@ -108,7 +108,7 @@ A rudimentary implementation of this logic is in place in Dock in the `Utils::re ## Credits -Application directories and applciation bundles have been used by many desktop-oriented operating systems, including RISC OS, NeXTStep/OPENSTEP, Mac OS X, and various other systems. Classic Macintosh System used single-file applications that kept resources in the Resource Fork. +Application directories and application bundles have been used by many desktop-oriented operating systems, including RISC OS, NeXTStep/OPENSTEP, Mac OS X, and various other systems. Classic Macintosh System used single-file applications that kept resources in the Resource Fork. * https://en.wikipedia.org/wiki/Application_directory * http://rox.sourceforge.net/desktop/AppDirs.html diff --git a/developer/applications.md b/developer/applications.md index 5cd6aae1..3af10fe5 100644 --- a/developer/applications.md +++ b/developer/applications.md @@ -17,7 +17,7 @@ For an introduction to [Creating GUI applications with Python & Qt5](https://www ## Using .ui files in PyQt -Using Qt Creator, you can also create and edit graphical user inferfaces for __Python__ based applications using `.ui` files. These can be used in PyQt like this: +Using Qt Creator, you can also create and edit graphical user interfaces for __Python__ based applications using `.ui` files. These can be used in PyQt like this: ``` #!/usr/bin/env python3 diff --git a/developer/architecture.md b/developer/architecture.md index 658558e1..8a6de876 100644 --- a/developer/architecture.md +++ b/developer/architecture.md @@ -57,4 +57,4 @@ The system should come with some commonly used utilities, such as a Terminal app ### Preferences -The system should come with some commonly used preference panels, such as for configuring the system language, OpenZFS Boot Environments, etc. These are just regular applications inside a 'Preferences' subdirectory. These should be super simple, "minimal viable" applications. It is expected that many will need to be written from scratch, but it is accaptable to re-use pre-existing applications, preferably written in Qt. +The system should come with some commonly used preference panels, such as for configuring the system language, OpenZFS Boot Environments, etc. These are just regular applications inside a 'Preferences' subdirectory. These should be super simple, "minimal viable" applications. It is expected that many will need to be written from scratch, but it is acceptable to re-use pre-existing applications, preferably written in Qt. diff --git a/developer/binary-compatibility.md b/developer/binary-compatibility.md index 952471ac..494d032a 100644 --- a/developer/binary-compatibility.md +++ b/developer/binary-compatibility.md @@ -11,7 +11,7 @@ Binary compatibility is an important concept in software engineering. It allows The Application Binary Interface (ABI) defines which applications can run on which systems. The two main factors in determining application compatibility are the FreeBSD version (e.g., `12.x`) and the version of packages (e.g., `quarterly`). * Applications compiled on one major version of FreeBSD are expected to run on subsequent minor versions of the same major version of FreeBSD if the packages of the dependencies on the target system are no older than on the build system. __Example:__ An application compiled on FreeBSD 12.0 is expected to run on FreeBSD 12.1 and 12.2 if the packages of the dependencies on the target system are no older than on the build system - * Applications compiled on one major version of FreeBSD are expected to run on subsequent major versions of FreeBSD if compatiblity libraries are installed. __Example:__ An application compiled on FreeBSD 3.2 is expected to run on FreeBSD 14 if compatibility libraries are installed. __But__ this is what happens when you try to `pkg-static add` a package built on FreeBSD 12 on a FreeBSD 13 machine: `pkg-static: wrong architecture: FreeBSD:12:amd64 instead of FreeBSD:13:amd64` - apparently `pkg-static add` does not make use of the combatibility assumption but this can be worked around by exporting, e.g., `ABI=freebsd:12:amd64`; `pkg install` does not seem to have this issue. + * Applications compiled on one major version of FreeBSD are expected to run on subsequent major versions of FreeBSD if compatibility libraries are installed. __Example:__ An application compiled on FreeBSD 3.2 is expected to run on FreeBSD 14 if compatibility libraries are installed. __But__ this is what happens when you try to `pkg-static add` a package built on FreeBSD 12 on a FreeBSD 13 machine: `pkg-static: wrong architecture: FreeBSD:12:amd64 instead of FreeBSD:13:amd64` - apparently `pkg-static add` does not make use of the compatibility assumption but this can be worked around by exporting, e.g., `ABI=freebsd:12:amd64`; `pkg install` does not seem to have this issue. ### Recommendation for building binary compatible applications diff --git a/developer/boot.md b/developer/boot.md index 8694f57e..e99e7928 100644 --- a/developer/boot.md +++ b/developer/boot.md @@ -19,7 +19,7 @@ This is a simplified description of the boot process. There may be additional as 1. From here on, the boot process is the regular FreeBSD boot process with the following particularities: 1. `/etc/rc.d/initgfx` detects the GPU and loads the appropriate drivers 3. `/usr/local/etc/rc.d/localize` runs `/usr/local/sbin/localize` which tries to determine the language of the keyboard, and by proxy, of the system. This currently supports the official Raspberry Pi keyboard and Apple computers which store the keyboard and system language in the `prev-lang:kbd` EFI variable -4. The `slim` session manager (login window) is started; when the user is loggen in, it starts the script `/usr/local/bin/start-hello` which starts the desktop session and sets the keyboard and system language based on the information provided by `localize` in an earlier step +4. The `slim` session manager (login window) is started; when the user is logged in, it starts the script `/usr/local/bin/start-hello` which starts the desktop session and sets the keyboard and system language based on the information provided by `localize` in an earlier step ### Troubleshooting the Live system early boot process diff --git a/developer/contributing.md b/developer/contributing.md index a105c778..7e6a8930 100644 --- a/developer/contributing.md +++ b/developer/contributing.md @@ -11,7 +11,7 @@ This is a small, purely volunteer-driven project, so your contributions are _hig * Download an experimental live ISO from https://github.com/helloSystem/ISO/releases * Look through the GitHub Issues sections of the projects within https://github.com/helloSystem/ * A great way to get started is to comment on some GitHub issues. Also feel free to open new ones. We use GitHub Issues as a means of discussion and keeping track of everything, so don't hesitate to use them. General topics not related to any particular component go to https://github.com/helloSystem/hello/issues -* Especially have a look at issues marked with ![](https://user-images.githubusercontent.com/2480569/97901371-64b8ad80-1d3c-11eb-8282-0bfdcd3fe512.png). Here your contributions would be especially helpful, but of course your contibutions to other tickets are more than welcome, too +* Especially have a look at issues marked with ![](https://user-images.githubusercontent.com/2480569/97901371-64b8ad80-1d3c-11eb-8282-0bfdcd3fe512.png). Here your contributions would be especially helpful, but of course your contributions to other tickets are more than welcome, too * There is a liberal amount of `FIXME` and `TODO` in the source code. Reducing the number of those is always highly welcome ## Our project values diff --git a/developer/distributions.md b/developer/distributions.md index 17da185d..e7142136 100644 --- a/developer/distributions.md +++ b/developer/distributions.md @@ -4,7 +4,7 @@ helloSystem is designed, developed, and tested as an integrated operating system Focusing on building one coherent operating system greatly simplifies the code, the development and testing process, and ultimately increases quality. -__Please do not try to include helloSystem in third-party distributions.__ While you are free to use components from helloSystem for your own projects as far as their respective licenses permit, please be aware that we may not always be interested in contributions that increase portability, especially if they would incrase complexity significantly. +__Please do not try to include helloSystem in third-party distributions.__ While you are free to use components from helloSystem for your own projects as far as their respective licenses permit, please be aware that we may not always be interested in contributions that increase portability, especially if they would increase complexity significantly. __Please do not call your derivatives "hello" or "helloSystem"__. In order to keep support and maintenance burden low, please give clearly distinguishable names to your derivatives. diff --git a/developer/filer-context-menus.md b/developer/filer-context-menus.md index fa8f66a2..63a102fa 100644 --- a/developer/filer-context-menus.md +++ b/developer/filer-context-menus.md @@ -106,7 +106,7 @@ This specification also defines how these actions may be gathered and ordered in A menu is defined by: * its displayable part: label, tooltip, icon -* conditions which are to be met in order the menu, and recursively all of its subitems, be actuelly displayed in the Filer context menu +* conditions which are to be met in order the menu, and recursively all of its subitems, be actually displayed in the Filer context menu * the ordered list of the items in the menu. #### Conditions @@ -487,7 +487,7 @@ But, where an action is intended to eventually execute a command, a menu is just In order to be valid, a menu must have a non-empty name, and include at least one valid subitem. -It is the responsability of the implementation to ensure that the displayed menus are relevant, _i.e._ not empty, with no separator at the begin or the end of the menu, with no double separator, etc. +It is the responsibility of the implementation to ensure that the displayed menus are relevant, _i.e._ not empty, with no separator at the begin or the end of the menu, with no double separator, etc. As stated @@ -697,7 +697,7 @@ Defaults to show anywhere. `TryExec` -Fromn [DES](http://standards.freedesktop.org/desktop-entry-spec/desktop-entry-spec-latest.html): path to an executable file on disk used to determine if some program is actually installed. If the path is not an absolute path, the file is looked up in the $PATH environment variable. If the file is not found or is not executable, this condition evals to `false`. +From [DES](http://standards.freedesktop.org/desktop-entry-spec/desktop-entry-spec-latest.html): path to an executable file on disk used to determine if some program is actually installed. If the path is not an absolute path, the file is looked up in the $PATH environment variable. If the file is not found or is not executable, this condition evals to `false`. Defaults to successful. string @@ -743,7 +743,7 @@ Defaults to successful. `ShowIfTrue` A command which, when executed, should output a string on stdout. -The item will be candidate if the outputed string is equal to `true`. +The item will be candidate if the outputted string is equal to `true`. Example: `[ -r %d/.svn/entries ] && echo \"true\` Defaults to successful. @@ -803,7 +803,7 @@ Some of well-known mimetypes include: * when used alone as in `*;`, _i.e._ when used as a group wildcard without subgroup, * when used as the subgroup wildcard, after the `/` character, as in `image/*`. -Defaults to `*;`, which happends to be exactly equivalent to `all/all` or to `all/*`. +Defaults to `*;`, which happens to be exactly equivalent to `all/all` or to `all/*`. @@ -879,7 +879,7 @@ Defaults to `>0`. ## Building the whole hierarchy -The processus described here is only a sort of meta-algorythm, whose only goal is to better specify how the menus and actions should be layouted in the final hierarchy. +The processus described here is only a sort of meta-algorithm, whose only goal is to better specify how the menus and actions should be laid out in the final hierarchy. -The implementor might take advantage of preparing once the whole hierarchy of the menus and actions: +The implementer might take advantage of preparing once the whole hierarchy of the menus and actions: * to minimize the time spent in the parsing of all files; * to identify and eliminate duplicate _desktop_file_id_s, * to eliminate invalid menus and actions. -1. as described in desktop_file_ids and invalid `.desktop` files; implentation so obtains a flat list of menus or actions; +1. as described in desktop_file_ids and invalid `.desktop` files; implementation so obtains a flat list of menus or actions; 2. recursively build the hierarchy; this merely consists in the build of the hierarchy as a tree of menus and actions, where each _desktop_file_id_ addressed as the subitem of a menu consumes this same id from the flat list * if the level-zero order (which is not specified here, but see desktop_file_id addressed in the level zero consumes this same id from the flat list; @@ -1399,7 +1399,7 @@ After this built phase, the resultant tree only contains valid (before runtime p So, menus or actions may appear at the level zero of the whole hierarchy for only two reasons: 1. because they are explicitly addressed by the level-zero configuration, if the implementation defines it; this may concern menus and actions; -2. because these items were not adressed by any menu (but this may only concern actions). +2. because these items were not addressed by any menu (but this may only concern actions). ## The level-zero case diff --git a/developer/menu.md b/developer/menu.md index cd31093a..f18cbd8d 100644 --- a/developer/menu.md +++ b/developer/menu.md @@ -7,7 +7,7 @@ To provide this unified user experience, it is crucial that all applications can ## Terminology ``` .. note:: - Consistent, up-to-date documentation reagarding the subject of global menus is hard to find. + Consistent, up-to-date documentation regarding the subject of global menus is hard to find. Please consider submitting issues and pull requests if you can contribute to this subject. ``` diff --git a/developer/rpi.md b/developer/rpi.md index c63cfb3c..94f861ad 100644 --- a/developer/rpi.md +++ b/developer/rpi.md @@ -4,7 +4,7 @@ Although we are currently not providing installation images for Raspberry Pi, we are investigating whether doing so would be feasible and beneficial. -The same insructions are roughly applicable to other aarch64 based systems such as rk3399 ones like the PineBook Pro and the [pine64 rockpro64_rk3399](https://bsd-hardware.info/?id=board:pine64-pinebook-pro-rk3399) as well. +The same instructions are roughly applicable to other aarch64 based systems such as rk3399 ones like the PineBook Pro and the [pine64 rockpro64_rk3399](https://bsd-hardware.info/?id=board:pine64-pinebook-pro-rk3399) as well. ``` .. note:: This page is intended for technically advanced users and developers, not for end users. This page is work in progress. Instructions are brief and assume prior knowledge with the subject. diff --git a/user/components.md b/user/components.md index 1b389a1f..cc7b88db 100644 --- a/user/components.md +++ b/user/components.md @@ -1,6 +1,6 @@ # Getting to know the system -helloSystem conststs of the following key components, each of which are described in this section: +helloSystem consists of the following key components, each of which are described in this section: ```eval_rst .. toctree:: diff --git a/user/components/applications/chromium.md b/user/components/applications/chromium.md index f4f0e5f3..71fde99a 100644 --- a/user/components/applications/chromium.md +++ b/user/components/applications/chromium.md @@ -5,8 +5,8 @@ __Chromium__ is an optional web browser that can be used on helloSystem. Upon first start of the Chromium browser, the following extensions are automatically installed from [https://chrome.google.com/webstore/](https://chrome.google.com/webstore/) to increase privacy and convenience: * __I don't care about cookies__: Tries to remove annoying cookie popups automatically. Visit [https://www.i-dont-care-about-cookies.eu](https://www.i-dont-care-about-cookies.eu) to learn more about this extension. Deactivate or uninstall this extension if you would like to see cookie popups -* __uBlock Origin__: Tries to block unwanted adversising and tracking. Visit [https://github.com/gorhill/uBlock](https://github.com/gorhill/uBlock) to learn more about this extension. Deactivate or uninstall this extension if you would like to see adversising and allow trackers to track you. +* __uBlock Origin__: Tries to block unwanted advertising and tracking. Visit [https://github.com/gorhill/uBlock](https://github.com/gorhill/uBlock) to learn more about this extension. Deactivate or uninstall this extension if you would like to see advertising and allow trackers to track you. You can uninstall those extensions at any time from within Chromium. -If wou would like Chromium not to install those extensions from the Chrome Web Store in the first place, remove the files in `/usr/local/share/chromium/extensions/*.json` prior to launching Chromium for the first time. +If you would like Chromium not to install those extensions from the Chrome Web Store in the first place, remove the files in `/usr/local/share/chromium/extensions/*.json` prior to launching Chromium for the first time. diff --git a/user/components/preferences/boot-environments.md b/user/components/preferences/boot-environments.md index 2378845f..4f3de5f2 100644 --- a/user/components/preferences/boot-environments.md +++ b/user/components/preferences/boot-environments.md @@ -1,8 +1,8 @@ # Boot Environments -_Boot Environments_ are bootable clones of snapshots of the working system. Boot Environments allow you to create a safe failback Boot Environmnent before upgrading or making major changes to the system. +_Boot Environments_ are bootable clones of snapshots of the working system. Boot Environments allow you to create a safe fallback Boot Environment before upgrading or making major changes to the system. -Other applications may create Boot Environmnents automatically before performing critical operations such as major operating system upgrades. +Other applications may create Boot Environments automatically before performing critical operations such as major operating system upgrades. ``` .. warning:: Boot Environments by default do not cover all locations, such as `/home` where your personal data is usually stored. diff --git a/user/components/system/launch.md b/user/components/system/launch.md index ca7f9fe9..83590ace 100644 --- a/user/components/system/launch.md +++ b/user/components/system/launch.md @@ -22,7 +22,7 @@ Many graphical desktop environments use `.desktop` files to integrate applications with the system. While this has traditionally worked well for installed applications, it does not work well for dynamically changing applications that are moved in the filesystem, such as `.app` bundles or `.AppDir` directories. Also, it does not handle multiple versions of the same application gracefully. Hence, helloSystem uses the `launch` command to launch graphical applications. This has the following advantages: - * You do not need to know the path to the application to be launched, even if the applciation is not on the `$PATH` + * You do not need to know the path to the application to be launched, even if the application is not on the `$PATH` * If multiple versions of an application are available on the system, the most recent one will be launched automatically (unless specified otherwise by the user) __(to be implemented)__ * If something goes wrong and the application cannot be launched, then a graphical error message will be shown on the screen diff --git a/user/components/utilities/create-live-media.md b/user/components/utilities/create-live-media.md index 70ce68eb..dbbd0d26 100644 --- a/user/components/utilities/create-live-media.md +++ b/user/components/utilities/create-live-media.md @@ -1,6 +1,6 @@ # Create Live Media -A __Live Medium__ is a storage device that can be used to start your computer with the helloSystem without having to install helloSystem to the internal storage of the computer. It allows you to try out helloSystem without making any changes to the software installed on your computer. Almost all functionality of helloSystem is available in Live mode, with very few exceptions. Changes being made, including files created, will be discarded when the system is shut down or retarted. +A __Live Medium__ is a storage device that can be used to start your computer with the helloSystem without having to install helloSystem to the internal storage of the computer. It allows you to try out helloSystem without making any changes to the software installed on your computer. Almost all functionality of helloSystem is available in Live mode, with very few exceptions. Changes being made, including files created, will be discarded when the system is shut down or restarted. The __Create Live Media__ utility provides an easy and convenient way to create bootable Live Media on devices such as USB sticks. It downloads and writes Live ISOs to devices in one go. diff --git a/user/components/utilities/install.md b/user/components/utilities/install.md index 3eaae8c5..67d076f6 100644 --- a/user/components/utilities/install.md +++ b/user/components/utilities/install.md @@ -22,7 +22,7 @@ When you install helloSystem using the __Install FreeBSD__ utility, the installe Start your computer from a helloSystem Live Medium. Open the __Install FreeBSD__ utility and follow the instructions on screen. -The installer starts by presenting a summary of FreeBSD. Click on "Continue". To install the software, you must agree to the terms of the software license agreemement. Click on "Continue" to proceed. Click on a destination disk on which the operating system should be installed. A warning will inform you that the entire disk will be erased. Confirm whether you want to do this by clicking on the appropriate button. +The installer starts by presenting a summary of FreeBSD. Click on "Continue". To install the software, you must agree to the terms of the software license agreement. Click on "Continue" to proceed. Click on a destination disk on which the operating system should be installed. A warning will inform you that the entire disk will be erased. Confirm whether you want to do this by clicking on the appropriate button. ``` .. warning:: The **Install FreeBSD** utility will overwrite the entire contents of the selected device, including all of its pre-existing partitions. Take extra caution when selecting the target device. @@ -38,7 +38,7 @@ In the next step, you will create an account for the main user of the computer. * The field __Username__ will be automatically populated with a suggested username. It must not contain any special characters such as blanks. You can override the suggested default if you like. Example: `jdoe` * Enter a password into the __Password__ field. Repeat the same password in the __Retype Password__ field. These fields can be left blank if you prefer not to use a password, but this will mean that anyone with access to your computer will be able to log in, and you will not be able to log in over the network * The field __Computer Name__ will be automatically populated with a suggested computer name (hostname). This name will be used to identify your computer on the local area network. It must not contain any special characters such as blanks. You can override the suggested default if you like. Example: `Johns-TravelMate-B117-M` -* Check the checkbox __Enable users to log in over the network (ssh)__ if you would like to allow accessing the computer remotely. By default, this requires a passwort to be set for the computer account +* Check the checkbox __Enable users to log in over the network (ssh)__ if you would like to allow accessing the computer remotely. By default, this requires a password to be set for the computer account * Check the checkbox __Set time zone based on current location__ if you would like timezone on the installed system to be set automatically. This feature requires an active internet connection Click "Continue" to proceed. The system will be installed to the selected disk. This process typically takes a couple of minutes depending on your system configuration, during which a progress bar will be shown. diff --git a/user/components/utilities/remote-assistance.md b/user/components/utilities/remote-assistance.md index 8ae09b31..d14c9dab 100644 --- a/user/components/utilities/remote-assistance.md +++ b/user/components/utilities/remote-assistance.md @@ -8,7 +8,7 @@ The __Remote Assistance__ utility allows a peer on the Internet to access and co ## Receiving Remote Assistance -To get help form a peer, open the Remote Assistance utility. Once a connection has been made, a long string (the ID) is shown on the screen. This string has also been copied to the clipbord. Give that string to your remote peer, e.g., by pasting it into a mail or chat window. +To get help form a peer, open the Remote Assistance utility. Once a connection has been made, a long string (the ID) is shown on the screen. This string has also been copied to the clipboard. Give that string to your remote peer, e.g., by pasting it into a mail or chat window. Once your peer has successfully connected, they will be able to see and operate anything on your screen, and to connect to any ports that may be open on your machine. diff --git a/user/getting-started.md b/user/getting-started.md index b04b6532..3895d510 100644 --- a/user/getting-started.md +++ b/user/getting-started.md @@ -7,7 +7,7 @@ hello is currently being developed. It is not yet available for general use, but ## System requirements * 2 GHz dual core Intel/ARM 64-bit processor -* 4 GiB RAM (system memory for physical and viritualized installs) +* 4 GiB RAM (system memory for physical and virtualized installs) * VGA capable of 1024x768 screen resolution * Either a CD/DVD drive or a USB port for booting the installer media * On non-Macintosh hardware, a [Raspberry Pi keyboard](https://static.raspberrypi.org/files/product-briefs/210108_Product_Brief_Keyboard_and_Mouse.pdf) is recommended as it allows the keyboard and system language to be detected automatically if it is attached while the system is starting up. On Macintosh hardware, the `prev-lang:kbd` EFI variable is usually set and is used to detect the keyboard and system language. Note that the key left to the space bar is used as the Command key (Alt key on PC keyboards, Apple key on Apple keyboards). diff --git a/user/troubleshooting.md b/user/troubleshooting.md index 8c2c5156..3a64f16a 100644 --- a/user/troubleshooting.md +++ b/user/troubleshooting.md @@ -24,7 +24,7 @@ This affects some computers with some (~ out of 10) builds of the ISO. If you en ## Debugging application issues -When debugging application issues, it can be helpful to see what an application is actually doing. For example, if we are interested in which libaries with "menu" in their name `firefox` is loading, we can run +When debugging application issues, it can be helpful to see what an application is actually doing. For example, if we are interested in which libraries with "menu" in their name `firefox` is loading, we can run ``` LD_DEBUG=libs firefox 2>&1 | grep -i menu From 704a08a7a23a41278e9b225d57e9b500635c5a93 Mon Sep 17 00:00:00 2001 From: probonopd Date: Wed, 27 Oct 2021 20:23:32 +0200 Subject: [PATCH 414/592] Chromium, Chrome --- developer/menu.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/developer/menu.md b/developer/menu.md index f18cbd8d..3ac18932 100644 --- a/developer/menu.md +++ b/developer/menu.md @@ -282,6 +282,12 @@ Changing this to `"1"` does not make any difference for Cura, though. _To be written._ +## Chromium, Chrome + +https://github.com/chromium/chromium/blob/master/chrome/browser/ui/views/frame/dbus_appmenu.cc suggests that there is global menu support in the Chromium source code. + +https://github.com/chromium/chromium/blob/72ceeed2ebcd505b8d8205ed7354e862b871995e/chrome/browser/ui/views/frame/browser_desktop_window_tree_host_linux.cc#L32-L47 seems to suggest that it can be activated by enabling `USE_DBUS_MENU` in the FreeBSD Ports [Makefile](https://github.com/freebsd/freebsd-ports/blob/main/www/chromium/Makefile). + ## Patches needed for Firefox and Thunderbird Firefox and Thunderbird need substantial source code patches to make global menus work: From 076bb8274d20b6629d9c9bc1789605da5917eeb5 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 1 Nov 2021 20:02:33 +0100 Subject: [PATCH 415/592] Install all build-time dependencies from packages --- developer/ports.md | 13 +++++++++++-- 1 file changed, 11 insertions(+), 2 deletions(-) diff --git a/developer/ports.md b/developer/ports.md index 875e5972..26654862 100644 --- a/developer/ports.md +++ b/developer/ports.md @@ -38,14 +38,23 @@ setenv ALLOW_UNSUPPORTED_SYSTEM YES Build the port without changes first to ensure it builds and works as expected. ``` +cd /usr/ports/x11-toolkits/qtermwidget/ + +# Install all build-time dependencies from packages +make build-depends-list | cut -c 12- | xargs pkg install -y + # Build the library # NOTE: Applications that have a library that is used by nothing but that application are just # annoying because now you have to deal with two entities rather than one -cd /usr/ports/x11-toolkits/qtermwidget/ MAKE_JOBS_UNSAFE=yes sudo -E make -j4 -# Build the application +# Now, the application itself cd /usr/ports/x11/qterminal + +# Install all build-time dependencies from packages +make build-depends-list | cut -c 12- | xargs pkg install -y + +# Build the application QTermWidget5_DIR=/usr/ports/x11-toolkits/qtermwidget/work/stage/usr/local/lib/cmake/qtermwidget5/ MAKE_JOBS_UNSAFE=yes sudo -E make -j4 # Run the application with the changed library From 04ac4c10d3a51ebc63107215946deb10a3ecaf16 Mon Sep 17 00:00:00 2001 From: probonopd Date: Tue, 2 Nov 2021 08:59:43 +0100 Subject: [PATCH 416/592] Update update.md --- user/components/utilities/update.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/user/components/utilities/update.md b/user/components/utilities/update.md index ce6a8c4e..d2fb45a2 100644 --- a/user/components/utilities/update.md +++ b/user/components/utilities/update.md @@ -7,6 +7,7 @@ Once you have installed the system to the hard disk in your computer, or an exte ``` This utility +* Creates a new Boot Environment (bootable partial snapshot). __This is not a replacement for a backup.__ * Updates the FreeBSD operating system components (kernel and userland) * Updates all FreeBSD Packages * Currently does _not_ update any applications that came with helloSystem as native application bundles @@ -19,9 +20,9 @@ Please follow this exact procedure when testing the Update utility: * Install a helloSystem 0.7.0 pre-release build to hard disk. * Open QTerminal and run `sudo pkg lock --yes automount slim gvfs dejavu liberation-fonts-ttf`. This step is __important__ because otherwise the update will overwrite carefully crafted helloSystem customizations. (There may be more packages that need to be locked as well.) -* Run the __Boot Environments__ preferences application and create a new boot environment that you can switch back to in the case you are not satisfied with the updated system. __This is not a replacement for a backup.__ * Run the __Update__ utility and follow the on-screen instructions. * Once the update has completed, restart your computer to make full use of the updated software. +* Run the __Boot Environments__ preferences application and check that there is a boot environment that you can switch back to in the case you are not satisfied with the updated system. Please submit any problems you might be running into to [this issue](https://github.com/helloSystem/Utilities/issues/33). From 01f108901d5139d08521d3db05cf8e43ea00fb48 Mon Sep 17 00:00:00 2001 From: probonopd Date: Tue, 2 Nov 2021 09:00:23 +0100 Subject: [PATCH 417/592] Update update.md --- user/components/utilities/update.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/user/components/utilities/update.md b/user/components/utilities/update.md index d2fb45a2..f4048b53 100644 --- a/user/components/utilities/update.md +++ b/user/components/utilities/update.md @@ -7,7 +7,7 @@ Once you have installed the system to the hard disk in your computer, or an exte ``` This utility -* Creates a new Boot Environment (bootable partial snapshot). __This is not a replacement for a backup.__ +* Creates a new Boot Environment (bootable partial snapshot). __This is not a full replacement for a backup__ but should allow you to roll back to the state before the update, should something go wrong * Updates the FreeBSD operating system components (kernel and userland) * Updates all FreeBSD Packages * Currently does _not_ update any applications that came with helloSystem as native application bundles From b6bbb455f6e1b24f59da87b86e33f29bc5ea3e6f Mon Sep 17 00:00:00 2001 From: probonopd Date: Tue, 2 Nov 2021 18:55:23 +0100 Subject: [PATCH 418/592] Update filer.md --- user/components/system/filer.md | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) diff --git a/user/components/system/filer.md b/user/components/system/filer.md index 8cbdb097..d652fe44 100644 --- a/user/components/system/filer.md +++ b/user/components/system/filer.md @@ -14,7 +14,7 @@ In helloSystem, many tasks are done in the Filer that would require extra tools ## Launching applications -To launch an application, double-click it in Filer. In case you double-click on a binary that is lacking the execute permission, a dialog will ask you whether you would like to make the binary executable. +To launch an application, double-click it in Filer (you can also use the `⌘O` shortcut to open an application, or press `⌘↓`). In case you double-click on a binary that is lacking the execute permission, a dialog will ask you whether you would like to make the binary executable. ## Making applications available to the system @@ -31,3 +31,13 @@ To remove an application from the system, move it to the Trash. Computers on the local area network that are offering access via SFTP are automatically discovered and are shown in the "Network" area of Filer. Double-click on a network directory to access it. You will be asked to provide valid credentials (username, password) of an account on the remote computer. For this to work, computers need to provide SFTP services and announce them over dns-sd (Zeroconf, Bonjour). It is also possible to access files on computers that are not on the local area network. To do so, enter `sftp://hostname.tld` in the address bar of Filer and press the Enter key. + +## Keyboard shortcuts + +In addition to the shortcuts documented in the menus, the following shortcuts exist when Filer is running in Spatial Mode (which is the default on helloSystem): + +* `⌘↓`: Open the selected application, file, or folder +* `⌘↑`: Go up one folder +* `⌘⇧O`: Open the selected application, file, or folder, and close the current window +* `⌘⇧↓`: Open the selected application, file, or folder, and close the current window +* `⌘⇧↑`: Go up one folder, and close the current window From 7bc1130ab66910b4c9d673ed56bbfbb52d76c604 Mon Sep 17 00:00:00 2001 From: probonopd Date: Tue, 2 Nov 2021 19:04:51 +0100 Subject: [PATCH 419/592] Update shortcuts.md --- user/components/preferences/shortcuts.md | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/user/components/preferences/shortcuts.md b/user/components/preferences/shortcuts.md index c994a94b..9c521597 100644 --- a/user/components/preferences/shortcuts.md +++ b/user/components/preferences/shortcuts.md @@ -18,7 +18,7 @@ A __shortcut__ is a key or key combination you can press to invoke a defined act The ⌘ key, also known as Command, is the key left to the spacebar on helloSystem, unless you have configured your system differently. ``` .. note:: - The software may refer to the Command key as "Ctrl". This is a known cosmetic issue. + Non-native software may refer to the Command key as "Ctrl". This is a known cosmetic issue. ``` ## Default shortcuts @@ -27,14 +27,14 @@ Open the __Shortcut Keys__ preferences application to view the default system-wi Notable default shortcuts include: -* Press __⌘+Space__ to __search in the Menu__ (e.g., to launch applications or to execute commands in the frontmost application) -* Press __Ctrl+⌘+Esc__ and click on an application window to __forcefully quit an application__ that is malfunctioning -* Press __⌘+Shift+3__ or the __PrtScn__ key on your keyboard to __take a screenshot__ -* Press __Ctrl-⌘-H__ to go to the Home folder -* Press __Ctrl-⌘-A__ to go to the Applications folder -* Press __Ctrl-⌘-A__ to go to the Utilities folder -* Press __Ctrl-⌘-T__ to go open a terminal -* Press __Ctrl-⌘-I__ to open the internet browser +* Press `⌘Space` to __search in the Menu__ (e.g., to launch applications or to execute commands in the frontmost application) +* Press `Ctrl⌘Esc` and click on an application window to __forcefully quit an application__ that is malfunctioning +* Press `⌘⇧3` or the __PrtScn__ key on your keyboard to __take a screenshot__ +* Press `⌘⇧H` to go to the Home folder +* Press `⌘⇧A` to go to the Applications folder +* Press `⌘⇧U` to go to the Utilities folder +* Press `Ctrl⌘T` to open a Terminal +* Press `Ctrl⌘I` to open the internet browser This list is not exhaustive. From b65ecf1bdc43a4066ebf7f11ed397aba2a7ba33f Mon Sep 17 00:00:00 2001 From: probonopd Date: Wed, 3 Nov 2021 19:57:34 +0100 Subject: [PATCH 420/592] com.canonical.AppMenu.Registrar.xml --- developer/menu.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/developer/menu.md b/developer/menu.md index 3ac18932..585eb7bc 100644 --- a/developer/menu.md +++ b/developer/menu.md @@ -242,6 +242,10 @@ information to be displayed to users of the application through the interface sh * Issues: Requires the (undocumented?) `UBUNTU_MENUPROXY` environment variable not to be set to `0` or `` * Installed by package: `wx31-gtk3` +## Files involved + +`/usr/local/share/dbus-1/interfaces/com.canonical.AppMenu.Registrar.xml` (comes with the `plasma5-plasma-workspace` package). Unclear whether it is needed for the correct functioning of Global Menus (or for some applications to detect that they are running on a system that is capable of displaying them). Unclear what it is needed for. Unclear how multiple packages could provide this file (if more than one package is installed on the system that contains an application that can display the Global Menu). + ## Environment variables involved ### GTK_MODULES=appmenu-gtk-module From 0ede4cad139786217b6db40888ce8abecf3ae572 Mon Sep 17 00:00:00 2001 From: probonopd Date: Wed, 3 Nov 2021 22:04:50 +0100 Subject: [PATCH 421/592] com.canonical.dbusmenu.xml --- developer/menu.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/developer/menu.md b/developer/menu.md index 585eb7bc..419c1e9c 100644 --- a/developer/menu.md +++ b/developer/menu.md @@ -244,7 +244,8 @@ information to be displayed to users of the application through the interface sh ## Files involved -`/usr/local/share/dbus-1/interfaces/com.canonical.AppMenu.Registrar.xml` (comes with the `plasma5-plasma-workspace` package). Unclear whether it is needed for the correct functioning of Global Menus (or for some applications to detect that they are running on a system that is capable of displaying them). Unclear what it is needed for. Unclear how multiple packages could provide this file (if more than one package is installed on the system that contains an application that can display the Global Menu). +* `/usr/local/share/dbus-1/interfaces/com.canonical.AppMenu.Registrar.xml` (comes with the `plasma5-plasma-workspace` package). Unclear whether it is needed for the correct functioning of Global Menus (or for some applications to detect that they are running on a system that is capable of displaying them). Unclear what it is needed for. Unclear how multiple packages could provide this file (if more than one package is installed on the system that contains an application that can display the Global Menu). +* `com.canonical.dbusmenu.xml` (Is it needed? What for?) ## Environment variables involved @@ -286,13 +287,13 @@ Changing this to `"1"` does not make any difference for Cura, though. _To be written._ -## Chromium, Chrome +### Chromium, Chrome https://github.com/chromium/chromium/blob/master/chrome/browser/ui/views/frame/dbus_appmenu.cc suggests that there is global menu support in the Chromium source code. https://github.com/chromium/chromium/blob/72ceeed2ebcd505b8d8205ed7354e862b871995e/chrome/browser/ui/views/frame/browser_desktop_window_tree_host_linux.cc#L32-L47 seems to suggest that it can be activated by enabling `USE_DBUS_MENU` in the FreeBSD Ports [Makefile](https://github.com/freebsd/freebsd-ports/blob/main/www/chromium/Makefile). -## Patches needed for Firefox and Thunderbird +### Patches needed for Firefox and Thunderbird Firefox and Thunderbird need substantial source code patches to make global menus work: From 9bd328ed9f2637b864fd5ab8668e9e53a5a2123a Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 7 Nov 2021 17:29:17 +0100 Subject: [PATCH 422/592] WIP fix for Chrome and Firefox, thanks Jesper Schmitz Mouridsen (jsmdk) --- developer/menu.md | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/developer/menu.md b/developer/menu.md index 419c1e9c..6c1456c8 100644 --- a/developer/menu.md +++ b/developer/menu.md @@ -90,7 +90,7 @@ Desktop Environment, but it lives on as part of the Vala project. programs, converts to them MenuModel and send to them AppMenu (sometimes called a global menu bar). `unity-gtk-module` is used as a backend, and thus must also be installed * Status: active -* Issues: Only if `GTK_MODULES=appmenu-gtk-module` is exported the menus in e.g. Audacity get shown in the global menu bar. Supposedly used by Firefox and Chrome but those applications are not functional with Menu in helloSystem yet. Upstream documentation [advises](https://github.com/rilian-la-te/vala-panel-appmenu#post-build-instructions) "Install `libdbusmenu-glib libdbusmenu-gtk3 libdbusmenu-gtk2` to get Chromium/Google Chrome to work" +* Issues: Only if `GTK_MODULES=appmenu-gtk-module` is exported the menus in e.g. Audacity get shown in the global menu bar. Supposedly used by Firefox and Chrome. Upstream documentation [advises](https://github.com/rilian-la-te/vala-panel-appmenu#post-build-instructions) "Install `libdbusmenu-glib libdbusmenu-gtk3 libdbusmenu-gtk2` to get Chromium/Google Chrome to work" * Installed by package: `appmenu-gtk-module` ### unity-gtk-module @@ -289,9 +289,9 @@ _To be written._ ### Chromium, Chrome -https://github.com/chromium/chromium/blob/master/chrome/browser/ui/views/frame/dbus_appmenu.cc suggests that there is global menu support in the Chromium source code. +WIP fix for Chrome and Firefox, thanks Jesper Schmitz Mouridsen (jsmdk): -https://github.com/chromium/chromium/blob/72ceeed2ebcd505b8d8205ed7354e862b871995e/chrome/browser/ui/views/frame/browser_desktop_window_tree_host_linux.cc#L32-L47 seems to suggest that it can be activated by enabling `USE_DBUS_MENU` in the FreeBSD Ports [Makefile](https://github.com/freebsd/freebsd-ports/blob/main/www/chromium/Makefile). +https://github.com/helloSystem/Menu/commit/999bf5d976b1c403159863ffc4af830b0d6a5669#diff-a048e15ab96b177a59f13528cad22fa877f6e175730b7fad7fed6f6a4e8a5e7b ### Patches needed for Firefox and Thunderbird @@ -300,6 +300,8 @@ Firefox and Thunderbird need substantial source code patches to make global menu * https://aur.archlinux.org/cgit/aur.git/tree/unity-menubar.patch?h=firefox-appmenu. See https://github.com/airyxos/Firefox_app for a FreeBSD implementation * https://aur.archlinux.org/cgit/aur.git/tree/0001-Use-remoting-name-for-GDK-application-names.patch?h=firefox-appmenu +The above fix is also needed. + ### GMenu-DBusMenu-Proxy ``` From 273e9a02ad6f8f37257f20af028e83abc8e2b002 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 7 Nov 2021 17:30:50 +0100 Subject: [PATCH 423/592] Fix for the Global Menu in Chrome and Firefox --- developer/acknowledgements.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/developer/acknowledgements.md b/developer/acknowledgements.md index df1fdce8..a9a04167 100644 --- a/developer/acknowledgements.md +++ b/developer/acknowledgements.md @@ -107,9 +107,10 @@ __[crees](https://github.com/crees)__ ## Jordan Gordeev * Wrote `geom_rowr` FreeBSD kernel module to combine a read-only with a read-write device -## Jesper Schmitz Mouridsen +## Jesper Schmitz Mouridsen (jsmdk) __[jsm222](https://github.com/jsm222)__ * Packaging helloDesktop components for FreeBSD Ports +* Fix for the Global Menu in Chrome and Firefox ## Sergey Tyuryukanov __[s199p.wa1k9k](https://github.com/s199pwa1k9r)__ From 12853becbd370da13ac58257dcfa919a20ed54c9 Mon Sep 17 00:00:00 2001 From: probonopd Date: Fri, 12 Nov 2021 19:19:02 +0100 Subject: [PATCH 424/592] Document build dependencies --- developer/building.md | 1 + 1 file changed, 1 insertion(+) diff --git a/developer/building.md b/developer/building.md index cc8c6286..3719e65b 100644 --- a/developer/building.md +++ b/developer/building.md @@ -22,6 +22,7 @@ However, it is also possible to build the ISO locally, which is especially handy ## Building the Live ISO ``` +sudo pkg install -y pkg git-lite zsync wget sha bash zip devel/py-xdg librsvg2 ca_root_nss git clone https://github.com/helloSystem/ISO cd ISO sudo ./build.sh hello From 238ab5a36059d199fca9795622a533c642592868 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 13 Nov 2021 12:54:52 +0100 Subject: [PATCH 425/592] Update graphics.md --- developer/graphics.md | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) diff --git a/developer/graphics.md b/developer/graphics.md index 7136b227..1d7abeb6 100644 --- a/developer/graphics.md +++ b/developer/graphics.md @@ -27,6 +27,18 @@ driver depending on whether the system was booted via BIOS or EFI. [Source](https://github.com/nomadbsd/NomadBSD/commit/a346f134aaca1cdc164346f63808abdb4d8919e3) +If everything goes well, then after running `sudo sysctl initgfx start` you should have (example: Nvidia): + +``` +% cat /usr/local/etc/X11/xorg.conf.d/00-video-initgfx.conf +Section "Device" + Identifier "NVIDIA CARD" + VendorName "NVIDIA Corporation" + Driver "nvidia" + BusID "PCI:1:0:0" +EndSection +``` + ## Disabling the graphics driver menu If you want to disable the graphics driver menu, add @@ -47,3 +59,14 @@ If you would like to temporarily disable the automatic graphics driver setup and ## Troubleshooting If applications that are using OpenGL crash on Nvidia systems, then it may be that the Nvidia driver was correctly loaded but the wrong Xorg configuration has been loaded, not actually using the Nvidia driver. This can happen when initgfx writes the dynamically generated Xorg configuration to `path_xorg_cfg_dir` (which points to `/usr/local/etc/X11/xorg.conf.d/` by default) but other files have been placed by other packages or the user into, e.g., `/etc/X11/xorg.conf.d`. You can verify which Xorg configuration directory was used by Xorg with `cat /var/log/Xorg.0.log | grep Using.config`. Seemingly Xorg cannot combine configuration stored in multiple `xorg.conf.d` directories. + +## Nvidia drivers + +Different versions of the Nvidia drivers exist. Unfortunately the latest version does not support all the earlier GPUs, so multiple versions of the Nvidia drivers are shipped with helloSystem to cover both new and older Nvidia GPUs. `initgfx` should automatically select a version suitable for the hardware in the computer. + +To check this: + +``` +% cat /etc/rc.conf | grep initgfx_kmods +initgfx_kmods="/usr/local/nvidia/390/boot/modules/nvidia.ko /usr/local/nvidia/390/boot/modules/nvidia-modeset.ko" +``` From 7d27bd1ddd64b826e771799f60a7149a5f9d1d21 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 13 Nov 2021 19:02:55 +0100 Subject: [PATCH 426/592] Update boot.md --- developer/boot.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/developer/boot.md b/developer/boot.md index e99e7928..0ab79384 100644 --- a/developer/boot.md +++ b/developer/boot.md @@ -1,5 +1,9 @@ # Boot process +``` .. note:: + This page describes helloSystem boot process up to 0.6.0. Starting with version 0.7.0, helloSystem will use a completely different live system boot process. This page needs to be updated accordingly. +``` + ## Live system early boot process The ISO contains a compressed Live system filesystem image in uzip format. This filesystem image contains the filesystem used when running the ISO. During the Live system boot process, the image needs to get mounted and needs to get turned into a read-write filesystem so that one can make changes to the running system. From 7d1b508d04291ec87fbae9e2160e1dc459101a93 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 13 Nov 2021 19:14:15 +0100 Subject: [PATCH 427/592] Update getting-started.md --- user/getting-started.md | 38 ++++++++++++++++++++++++++------------ 1 file changed, 26 insertions(+), 12 deletions(-) diff --git a/user/getting-started.md b/user/getting-started.md index 3895d510..4e790543 100644 --- a/user/getting-started.md +++ b/user/getting-started.md @@ -16,7 +16,31 @@ In the future, there may also be builds for other processor architectures. We wo Please refer to [FreeBSD Hardware Compatibility](https://www.freebsd.org/doc/en_US.ISO8859-1/books/faq/hardware.html) for more information on individual components. -### Tested hardware +## Downloading + +The **helloSystem 0.6.0** ISO image is available for download [here](https://github.com/helloSystem/ISO/releases/tag/r0.6.0). + +Experimental and pre-release images are available for download [here](https://github.com/helloSystem/ISO/releases). + +``` .. important:: + Experimental images get built automatically whenever source code is committed. Not every build is tested. Builds marked as "Pre-Release" are strictly for developers, may be broken and may not even boot. +``` + +## Creating Live Media + +The ISO file needs to be written to a device, e.g., to a USB stick, in order to a computer being able to start from it. This will overwrite and destroy all data on that device. + +helloSystem comes with a __Create Live Media__ utility that allows to write ISO files to a device easily. + +If you are not running helloSystem yet or would like to use the command line, the following command should work on all BSD flavors: + +``` +sudo dd if= of=/dev/daX bs=4m status=progress +``` + +On GNU-style systems (e.g., most Linux distributions), `status=progress` does not work and can be left away. + +## Tested hardware hello is known to boot to a graphical desktop on the following machines. Auxiliary functionality such as wireless networking, sound over HDMI, sleep, graphics acceleration, etc. has not yet been tested systematically. @@ -36,7 +60,7 @@ Not all networking devices may be supported by FreeBSD yet. In those cases, you * [USB 802.11n WLAN Adapters based on `ID 0bda:8176 Realtek Semiconductor Corp. RTL8188CUS`](https://vermaden.wordpress.com/2020/10/30/realtek-usb-wifi-review/) * [USB Wired Ethernet Adapters based on `ID 0b95:772b ASIX Electronics Corp. AX88772B`](https://www.freebsd.org/cgi/man.cgi?query=axe) -### Virtualization environments +## Virtualization environments ``` .. note:: We recommend running helloSystem on real hardware ("bare metal") if possible. This should give you the best possible performance and hardware support. @@ -127,13 +151,3 @@ Then add these two `qemu-system-x86_64` options: * Network Device: VirtIO To set resolution, press F2 at boot to access OVMF settings. Select 'Device Manager > OVMF Platform Configuration > Change Preferred', save and reboot. - -## Downloading - -The **helloSystem 0.6.0** ISO image is available for download [here](https://github.com/helloSystem/ISO/releases/tag/r0.6.0). - -Experimental and pre-release images are available for download [here](https://github.com/helloSystem/ISO/releases). - -``` .. important:: - Experimental images get built automatically whenever source code is committed. Not every build is tested. Builds marked as "Pre-Release" are strictly for developers, may be broken and may not even boot. -``` From 6d97de316b2fd0bd256e6e0bf1c7aad177ba16b4 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 14 Nov 2021 07:31:34 +0100 Subject: [PATCH 428/592] Document Firefox and Thunderbird, build.schmitz.computer repository Thanks @jsm222 --- developer/menu.md | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/developer/menu.md b/developer/menu.md index 6c1456c8..82976e38 100644 --- a/developer/menu.md +++ b/developer/menu.md @@ -289,9 +289,7 @@ _To be written._ ### Chromium, Chrome -WIP fix for Chrome and Firefox, thanks Jesper Schmitz Mouridsen (jsmdk): - -https://github.com/helloSystem/Menu/commit/999bf5d976b1c403159863ffc4af830b0d6a5669#diff-a048e15ab96b177a59f13528cad22fa877f6e175730b7fad7fed6f6a4e8a5e7b +Starting with version 0.7.0 of helloSystem, Menu can handle Chrome and (patched) Firefox and Thunderbird, thanks Jesper Schmitz Mouridsen ([__jsm222__](https://github.com/jsm222/)). ### Patches needed for Firefox and Thunderbird @@ -300,7 +298,11 @@ Firefox and Thunderbird need substantial source code patches to make global menu * https://aur.archlinux.org/cgit/aur.git/tree/unity-menubar.patch?h=firefox-appmenu. See https://github.com/airyxos/Firefox_app for a FreeBSD implementation * https://aur.archlinux.org/cgit/aur.git/tree/0001-Use-remoting-name-for-GDK-application-names.patch?h=firefox-appmenu -The above fix is also needed. +FreeBSD Ports files by thanks Jesper Schmitz Mouridsen ([__jsm222__](https://github.com/jsm222/)) are available at +* https://github.com/jsm222/helloDesktop/tree/main/www/firefox +* https://github.com/jsm222/helloDesktop/tree/main/mail/thunderbird + +Packages are available at http://build.schmitz.computer/packages/122amd64-quarterly (see https://wiki.freebsd.org/helloDesktop for details). ### GMenu-DBusMenu-Proxy From 618c3603c0675c063a9ec5765043bd33ee1533c0 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 14 Nov 2021 07:32:29 +0100 Subject: [PATCH 429/592] Update menu.md --- developer/menu.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/developer/menu.md b/developer/menu.md index 82976e38..c4840260 100644 --- a/developer/menu.md +++ b/developer/menu.md @@ -298,11 +298,11 @@ Firefox and Thunderbird need substantial source code patches to make global menu * https://aur.archlinux.org/cgit/aur.git/tree/unity-menubar.patch?h=firefox-appmenu. See https://github.com/airyxos/Firefox_app for a FreeBSD implementation * https://aur.archlinux.org/cgit/aur.git/tree/0001-Use-remoting-name-for-GDK-application-names.patch?h=firefox-appmenu -FreeBSD Ports files by thanks Jesper Schmitz Mouridsen ([__jsm222__](https://github.com/jsm222/)) are available at +FreeBSD Ports files for patched Firefox and Thunderbird by Jesper Schmitz Mouridsen ([__jsm222__](https://github.com/jsm222/)) are available at * https://github.com/jsm222/helloDesktop/tree/main/www/firefox * https://github.com/jsm222/helloDesktop/tree/main/mail/thunderbird -Packages are available at http://build.schmitz.computer/packages/122amd64-quarterly (see https://wiki.freebsd.org/helloDesktop for details). +Packages of patched Firefox and Thunderbird are available at http://build.schmitz.computer/packages/122amd64-quarterly (see https://wiki.freebsd.org/helloDesktop for details). ### GMenu-DBusMenu-Proxy From 3e1e3e0657e47c3564bc4a20e0f8a9ae00a3bf4f Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 14 Nov 2021 10:16:18 +0100 Subject: [PATCH 430/592] Update menu.md --- developer/menu.md | 44 ++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 44 insertions(+) diff --git a/developer/menu.md b/developer/menu.md index c4840260..d6715093 100644 --- a/developer/menu.md +++ b/developer/menu.md @@ -304,6 +304,50 @@ FreeBSD Ports files for patched Firefox and Thunderbird by Jesper Schmitz Mourid Packages of patched Firefox and Thunderbird are available at http://build.schmitz.computer/packages/122amd64-quarterly (see https://wiki.freebsd.org/helloDesktop for details). +To use this repository: + +``` +cat > /usr/local/etc/pkg/repos/helloDesktop.conf <<\EOF +helloDesktop: { + url: "pkg+http://build.schmitz.computer/packages/122amd64-quarterly", + mirror_type: "srv", + enabled: yes, + signature_type: "pubkey", + pubkey: "/usr/local/etc/ssl/certs/poudriere.cert", + priority: 100 +} +EOF + +cat > /usr/local/etc/ssl/certs/poudriere.cert <<\EOF +-----BEGIN PUBLIC KEY----- +MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEA5gEt92AHUkYkZH2Q2nP3 +2/Wu7gxbMEno5iqi1ea327lHmhJB18E0mW9dKYgxz74PbbTAmyaMdY4G1vn3cStp +jKVnrOCsNboaZ1L6riYFTjZX0pVAQYdtblCNjTf92X1kk8Yp1jy3baH8s19IKVWD +jX+2j33BOjRH3jbiLxdPu51wPItDUM4UU+mdrMH2+RgHjVX3ZkgRe/bYxMgrYBQg +roEwp0Pv9DbDQ0Vx3qIBJahQ7zfDCWZI1urr85/kM58KXYLt1YHW+vRd3scOm1IE +mRON0zVO2f8+obzy3lLNnZj/XIWxh+LNI4kmmdoHMksysYtrRz1bpcnsY8qOe4g3 +X7q+i8k0JaaMwwD9YvKf6HyQ09rFt3WqV2AAOwR0835oHxCENJJFcoUCMCaKjNSF +OZyuYKKPqSm8BKj/QaoXBIF1fQJBJzrINYSUj4/M6TWKVTSO8H4s+eiqfD7FYJ3h +jSZ2ubydtTOef1Tk79OVoo8Ns7FqzCK7ffOvELxuY2OMDIKrw0sCfpkI9uM5Dfrr +rYXn4dwvZLwB+tnBbKBXIfjAvwqjHeWfzqgUHSk/Slqh7UEYL+BnLfHxLMVN0Omk +gFM24eVEKju1PHkBDHVAD+NGfq4g/hcbAbcrtjxDrs1ztdwjtCJmFNcEYFjz0DRc +q9cTv5oaRy9FQy0NdGwGuqUCAwEAAQ== +-----END PUBLIC KEY----- +EOF + +sudo pkg install firefox thunderbird +``` + +Since the helloDesktop repository has `priority: 100`, you should see: + +``` +New packages to be INSTALLED: + firefox-94.0.1_1,2 [helloDesktop] + thunderbird: 91.3.0_1 [helloDesktop] +``` + +Note the `helloDesktop`, indicating that these packages will be installed from the helloDesktop repository provided by [__jsm222__](https://github.com/jsm222/) rather than from the FreeBSD repository. In general, we aim to use software that is in the official FreeBSD packages, so we hope that those ports will be upstreamed. + ### GMenu-DBusMenu-Proxy ``` From 5fafee701150305b7f0508e610e0f64aff95f680 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 14 Nov 2021 10:17:11 +0100 Subject: [PATCH 431/592] Document jsm222 repository --- developer/menu.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/developer/menu.md b/developer/menu.md index d6715093..baeacf0c 100644 --- a/developer/menu.md +++ b/developer/menu.md @@ -313,12 +313,12 @@ helloDesktop: { mirror_type: "srv", enabled: yes, signature_type: "pubkey", - pubkey: "/usr/local/etc/ssl/certs/poudriere.cert", + pubkey: "/usr/local/etc/ssl/certs/jsm222.cert", priority: 100 } EOF -cat > /usr/local/etc/ssl/certs/poudriere.cert <<\EOF +cat > /usr/local/etc/ssl/certs/jsm222.cert <<\EOF -----BEGIN PUBLIC KEY----- MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEA5gEt92AHUkYkZH2Q2nP3 2/Wu7gxbMEno5iqi1ea327lHmhJB18E0mW9dKYgxz74PbbTAmyaMdY4G1vn3cStp From 540293cd6dc7058bdfb38e2b279694fd0cb16a7a Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 14 Nov 2021 10:19:18 +0100 Subject: [PATCH 432/592] Add link to https://wiki.freebsd.org/helloDesktop --- developer/acknowledgements.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/developer/acknowledgements.md b/developer/acknowledgements.md index a9a04167..e3758a9b 100644 --- a/developer/acknowledgements.md +++ b/developer/acknowledgements.md @@ -109,8 +109,9 @@ __[crees](https://github.com/crees)__ ## Jesper Schmitz Mouridsen (jsmdk) __[jsm222](https://github.com/jsm222)__ -* Packaging helloDesktop components for FreeBSD Ports +* Packaging helloDesktop components for FreeBSD Ports ([details](https://wiki.freebsd.org/helloDesktop)) * Fix for the Global Menu in Chrome and Firefox +* Added patches to Firefox and Thunderbird Ports for global menu support ## Sergey Tyuryukanov __[s199p.wa1k9k](https://github.com/s199pwa1k9r)__ From 39a6a6190a10bf8612b5a29e2edf9e5717340216 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 14 Nov 2021 10:30:59 +0100 Subject: [PATCH 433/592] Update menu.md --- developer/menu.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/developer/menu.md b/developer/menu.md index baeacf0c..42871401 100644 --- a/developer/menu.md +++ b/developer/menu.md @@ -304,7 +304,7 @@ FreeBSD Ports files for patched Firefox and Thunderbird by Jesper Schmitz Mourid Packages of patched Firefox and Thunderbird are available at http://build.schmitz.computer/packages/122amd64-quarterly (see https://wiki.freebsd.org/helloDesktop for details). -To use this repository: +helloSystem versions 0.7.0 and up come with this repository enabled. To enable it manually: ``` cat > /usr/local/etc/pkg/repos/helloDesktop.conf <<\EOF From abdacda3708dcc23766b0dc74bbcbda75c08fa83 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 14 Nov 2021 19:13:06 +0100 Subject: [PATCH 434/592] ${ABI}-mozillapatched --- developer/menu.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/developer/menu.md b/developer/menu.md index 42871401..62999777 100644 --- a/developer/menu.md +++ b/developer/menu.md @@ -309,7 +309,7 @@ helloSystem versions 0.7.0 and up come with this repository enabled. To enable i ``` cat > /usr/local/etc/pkg/repos/helloDesktop.conf <<\EOF helloDesktop: { - url: "pkg+http://build.schmitz.computer/packages/122amd64-quarterly", + url: "pkg+http://build.schmitz.computer/packages/${ABI}-mozillapatched", mirror_type: "srv", enabled: yes, signature_type: "pubkey", From 1e39f7ec066cb978c05d169be914a21b215028db Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 15 Nov 2021 23:20:15 +0100 Subject: [PATCH 435/592] Create monkey-patch.md --- developer/monkey-patch.md | 48 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 48 insertions(+) create mode 100644 developer/monkey-patch.md diff --git a/developer/monkey-patch.md b/developer/monkey-patch.md new file mode 100644 index 00000000..dbb2950b --- /dev/null +++ b/developer/monkey-patch.md @@ -0,0 +1,48 @@ +# Monkey Patching + +Starting with helloSystem 0.7.0 it is possible to [monkey patch](https://en.wikipedia.org/wiki/Monkey_patch) the running Live ISO as early in the boot process as possible so that developers can make changes to all aspects of an existing Live ISO without having to re-create it and without having to write the ISO to a device each time a change is to be tested. + +With that, it allows for a very rapid development-test cycle for Live ISOs. + +``` .. note:: + This feature is currently under active development and its usage is still subject to change. +``` + +## Theory of operation + +Since an ISO file is read-only by design, the monkey patch feature allows to insert code into the early boot process from another loacation, e.g., from a USB stick. + +If the user tells the system to perform the monkey patching, the early boot scripts in helloSystem execute code provided by the user (outside of the ISO), then continues the normal boot process. + +## Creating the monkey patch volume + +* Format a USB stick with the FAT32 (`msdosfs`) file system +* The volume must have the name ("filesystem label") `MONKEYPATCH` +* There must be a `monkeypatch.sh` file that will be run by `#!/bin/sh` + +## Booting a Live ISO applying the monkey patch on-the-fly + +* Boot the ISO but interrupt the bootloader by pressing the Esc key +* At the boot prompt, enter: `set monkey_patch=YES` +* Optionally, use `unset BOOT_MUTE` so that you can see messages on the screen during boot +* Start the system by entering `boot` + +The code inside the file `monkeypatch.sh` on the volume called `MONKEYPATCH` will be executed before `/sbin/init` on the Live ISO is started but after most areas of the ISO have been made writable by `/boot/init_script`. + +## Example `monkeypatch.sh` file + +``` +# Write a file +echo "HELLO MONKEY" > /tmp/MONKEY_WAS_HERE + +# Patch something on the ISO +sed -i '' -e 's|\&\& __wait 3|\&\& sync|g' /etc/rc.d/initgfx + +# Show a message if the system is booted without `boot_mute` +echo "HELLO DEVELOPERS" + +# Show a message to users in the boot process +# This should be done only in rare cases since it destroys +# the helloSystem zero-text boot experience +echo "HELLO MERE MORTALS" > /dev/console +``` From cff6d486d53385d660f7e19633893ec24c843b65 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 15 Nov 2021 23:21:33 +0100 Subject: [PATCH 436/592] Update monkey-patch.md --- developer/monkey-patch.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/developer/monkey-patch.md b/developer/monkey-patch.md index dbb2950b..6b7aec03 100644 --- a/developer/monkey-patch.md +++ b/developer/monkey-patch.md @@ -16,6 +16,8 @@ If the user tells the system to perform the monkey patching, the early boot scri ## Creating the monkey patch volume +![image](https://user-images.githubusercontent.com/2480569/141862072-250f4d58-b5a5-4857-9bd0-70651690796e.png) + * Format a USB stick with the FAT32 (`msdosfs`) file system * The volume must have the name ("filesystem label") `MONKEYPATCH` * There must be a `monkeypatch.sh` file that will be run by `#!/bin/sh` From a33b56852f4a30f14b48326c509633464060056d Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 15 Nov 2021 23:27:23 +0100 Subject: [PATCH 437/592] Update index.md --- index.md | 1 + 1 file changed, 1 insertion(+) diff --git a/index.md b/index.md index 188590f6..05686fc1 100644 --- a/index.md +++ b/index.md @@ -48,6 +48,7 @@ __helloSystem__ is a desktop system for creators with a focus on simplicity, ele developer/specifications developer/contributing developer/building + developer/monkey-patch developer/tracing developer/localization developer/ports From 5aeadb3bf2922f4ece713e6e477a0613a8d4bdea Mon Sep 17 00:00:00 2001 From: probonopd Date: Tue, 16 Nov 2021 18:51:13 +0100 Subject: [PATCH 438/592] Document Ventoy --- user/getting-started.md | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/user/getting-started.md b/user/getting-started.md index 4e790543..473ad4c5 100644 --- a/user/getting-started.md +++ b/user/getting-started.md @@ -40,6 +40,23 @@ sudo dd if= of=/dev/daX bs=4m status=progress On GNU-style systems (e.g., most Linux distributions), `status=progress` does not work and can be left away. +## Ventoy + +[Ventoy](https://github.com/ventoy/Ventoy/) is a tool that lets you boot the operating systems of multiple ISO files that are residing on the same disk, without the need to write the ISO to a physical device. Starting with version 1.0.62, Ventoy can boot helloSystem 0.7.0 and later. + +If you are not running helloSystem yet, then please refer to the Ventoy documentation on how to create a bootable Ventoy disk (that you put your ISOs on) using Windows or Linux. + +If you are already running helloSystem and would like to create a bootable Ventoy disk, please follow these steps instead since the Ventoy installation instructions since the Ventoy documentation only describes installation using Windows and Linux: + +![image](https://user-images.githubusercontent.com/2480569/142038823-d7413735-73d9-44b4-84e5-c50768c2f271.png) + +1. Run The __Create Live Media__ utility in helloSystem +2. From the drop-down menu, select __Ventoy__. Select the latest version (at least 1.0.62), and create a Ventoy Live medium (a 1 GB USB stick is sufficient for this) +3. Boot from the Ventoy Live medium you just created, and use it to install Ventoy to a disk (a SSD with hundreds of GB of space is recommended if you want to store hundreds of different operating system ISOs) +4. At this point, you don't need the Ventoy Live medium anymore (the 1 GB USB stick) +5. Put one or more helloSystem ISOs (and potentially ISOs of other operating systems supported by Ventoy) onto the Ventoy disk (the one with hundreds of GB of space) +6. Once a new version of Ventoy comes out, put the latest Ventoy Live ISO onto your Ventoy disk, just like any other operating system ISO. Boot it to update the Ventoy installation on the Ventoy disk itself (yes, it can update the disk it is running from) + ## Tested hardware hello is known to boot to a graphical desktop on the following machines. Auxiliary functionality such as wireless networking, sound over HDMI, sleep, graphics acceleration, etc. has not yet been tested systematically. From 132519cbfe9e868fe863025249c1c9ca48627beb Mon Sep 17 00:00:00 2001 From: probonopd Date: Tue, 16 Nov 2021 18:58:40 +0100 Subject: [PATCH 439/592] Treated with https://dlaa.me/markdownlint/ --- user/getting-started.md | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/user/getting-started.md b/user/getting-started.md index 473ad4c5..af2c9878 100644 --- a/user/getting-started.md +++ b/user/getting-started.md @@ -89,7 +89,7 @@ Users have reported success in running helloSystem in the following virtualizati * VMware host (on Windows), possibly only working in BIOS mode? -* QEMU host (on Linux), works in both BIOS and EFI modes (see below). Note that for acceptable performance, QEMU needs KVM which is currently not available on FreeBSD hosts yet +* QEMU host (on Linux), works in both BIOS and EFI modes (see below). Note that for acceptable performance, QEMU needs KVM which is currently not available on FreeBSD hosts yet * Parallels host, reported to work in EFI mode (see below) @@ -105,7 +105,7 @@ Please note: Please report back about the results on your virtualization environment. -#### QEMU +### QEMU Create an 8 GiB (or larger) `hello.img` image file on which you can install the system: @@ -143,19 +143,20 @@ Notes To boot/install hello in UEFI mode, first install [OVMF Open Virtual Machine Firmware](https://github.com/tianocore/tianocore.github.io/wiki/OVMF) on your host side. The package name for Fedora 32 is `edk2-ovmf` Then add these two `qemu-system-x86_64` options: + ``` -bios /usr/share/edk2/ovmf/OVMF_CODE.fd \ -smbios type=0,vendor=0vendor,version=0version,date=0date,release=0.0,uefi=on \ ``` -#### Parallels +### Parallels * Select Hardware > Boot Order. -* Expand **Advanced Settings**. Set **BIOS** to "EFI 64-bit" and in the Boot flags field, enter `vm.bios.efi=1`. +* Expand **Advanced Settings**. Set **BIOS** to "EFI 64-bit" and in the Boot flags field, enter `vm.bios.efi=1`. ![Screenshot](https://docs.01.org/clearlinux/latest/zh_CN/_images/parallels-07.png) -#### Proxmox VE +### Proxmox VE * Memory: 4GB (not ballooned) * Processors: 2 (1 socket 2 cores) From 5efd053521d3d37f9e67b0790307705fb3d01eb5 Mon Sep 17 00:00:00 2001 From: probonopd Date: Wed, 17 Nov 2021 19:24:37 +0100 Subject: [PATCH 440/592] Workaround for https://github.com/ryanfox/sphinx-markdown-tables/issues/34 --- buildDocs.sh | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/buildDocs.sh b/buildDocs.sh index ee327468..4a606ae3 100644 --- a/buildDocs.sh +++ b/buildDocs.sh @@ -20,8 +20,9 @@ set -x apt-get update apt-get -y install git rsync python3-pip qttools5-dev-tools qt5-default qt5-qmake pip3 install setuptools wheel -pip3 install docutils==0.16 sphinx sphinx-autobuild sphinx-rtd-theme commonmark recommonmark sphinxcontrib-qthelp sphinx-markdown-tables - +pip3 install docutils==0.16 sphinx sphinx-autobuild sphinx-rtd-theme commonmark recommonmark sphinxcontrib-qthelp sphinx-markdown-tables markdown!=3.3.5 +# markdown!=3.3.5 = Workaround for ryanfox/sphinx-markdown-tables#34 + ##################### # DECLARE VARIABLES # ##################### From ceda1ce7347cd8c70862c2f79e5853a20fe0ff46 Mon Sep 17 00:00:00 2001 From: probonopd Date: Thu, 18 Nov 2021 19:23:35 +0100 Subject: [PATCH 441/592] Add example --- developer/monkey-patch.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/developer/monkey-patch.md b/developer/monkey-patch.md index 6b7aec03..400b0d43 100644 --- a/developer/monkey-patch.md +++ b/developer/monkey-patch.md @@ -47,4 +47,9 @@ echo "HELLO DEVELOPERS" # This should be done only in rare cases since it destroys # the helloSystem zero-text boot experience echo "HELLO MERE MORTALS" > /dev/console + +# Override a file in the running system from the MONKEYPATCH volume +HERE="$(dirname "$(readlink -f "${0}")")" +cp ${HERE}/mount_md /usr/local/sbin/mount_md +chmod +x /usr/local/sbin/mount_md ``` From 4bba9820573627631112c61b80b50926f3c13a0a Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 21 Nov 2021 17:57:23 +0100 Subject: [PATCH 442/592] Screenshot --- user/components/utilities/hardware-probe.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/user/components/utilities/hardware-probe.md b/user/components/utilities/hardware-probe.md index 6925ef96..af91839f 100644 --- a/user/components/utilities/hardware-probe.md +++ b/user/components/utilities/hardware-probe.md @@ -2,6 +2,8 @@ The __Hardware Probe__ utility collects hardware details of your computer and can anonymously upload them to the public database at [bsd-hardware.info](https://bsd-hardware.info/?d=helloSystem). +![](https://user-images.githubusercontent.com/2480569/103484839-12564480-4df2-11eb-8c57-d6ee6ef48e2b.png) + This can help users and operating system developers to collaboratively debug hardware related issues, check for operating system compatibility and find drivers. You will get a permanent probe URL to view and share collected information. From 581e32d809c6ab9d944947cb5050405dd0127035 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 21 Nov 2021 18:01:01 +0100 Subject: [PATCH 443/592] FreeBSD wireless network card compatibility --- user/getting-started.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/user/getting-started.md b/user/getting-started.md index af2c9878..f5377e02 100644 --- a/user/getting-started.md +++ b/user/getting-started.md @@ -77,6 +77,8 @@ Not all networking devices may be supported by FreeBSD yet. In those cases, you * [USB 802.11n WLAN Adapters based on `ID 0bda:8176 Realtek Semiconductor Corp. RTL8188CUS`](https://vermaden.wordpress.com/2020/10/30/realtek-usb-wifi-review/) * [USB Wired Ethernet Adapters based on `ID 0b95:772b ASIX Electronics Corp. AX88772B`](https://www.freebsd.org/cgi/man.cgi?query=axe) +Detailed information on #FreeBSD wireless network card compatibility is available at [https://wiki.freebsd.org/dev](https://wiki.freebsd.org/dev). + ## Virtualization environments ``` .. note:: From 705c8a1b8d49e730b634867dbc511d1049334791 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Emir=20Sar=C4=B1?= Date: Sun, 21 Nov 2021 22:27:43 +0300 Subject: [PATCH 444/592] Update welcome text (#35) Merhaba is "hi", this one is the actual translation of welcome. --- index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.md b/index.md index 05686fc1..b51d79a2 100644 --- a/index.md +++ b/index.md @@ -5,7 +5,7 @@ ``` ```eval_rst -.. centered:: Willkommen • Welcome • Bienvenue • Benvenuto • Bienvenido • ようこそ • Mabuhay • Välkommen • Добро пожаловать • Merhaba • Bonvenon • 歡迎 +.. centered:: Willkommen • Welcome • Bienvenue • Benvenuto • Bienvenido • ようこそ • Mabuhay • Välkommen • Добро пожаловать • Hoş geldiniz • Bonvenon • 歡迎 ``` # hello From 27586c2cde15827e7e76635f8ced35864a11c29c Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 22 Nov 2021 08:33:31 +0100 Subject: [PATCH 445/592] Update acknowledgements.md --- developer/acknowledgements.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/developer/acknowledgements.md b/developer/acknowledgements.md index e3758a9b..83074eaa 100644 --- a/developer/acknowledgements.md +++ b/developer/acknowledgements.md @@ -122,3 +122,7 @@ __[s199p.wa1k9k](https://github.com/s199pwa1k9r)__ __[mszoek](https://github.com/mszoek)__ @thatzoek on twitter * Implemented `org.freedesktop.FileManager1` API in Filer + +## alphamodh0 +__[alphamodh0](https://github.com/alphamodh0)__ +* Translated helloSystem to Spanish From e2e02bfda112659c0ffbd0ab852fc092695173b1 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 22 Nov 2021 11:51:20 +0100 Subject: [PATCH 446/592] Update troubleshooting.md --- user/troubleshooting.md | 18 +++++++++++++++--- 1 file changed, 15 insertions(+), 3 deletions(-) diff --git a/user/troubleshooting.md b/user/troubleshooting.md index 3a64f16a..5170eb4e 100644 --- a/user/troubleshooting.md +++ b/user/troubleshooting.md @@ -11,11 +11,23 @@ If – after five minutes – you're reluctant to stop the computer, you can occ * Please restart the computer. If normal use of the power button is not effective, press and hold. * Then, please [start the computer in verbose mode](https://hellosystem.github.io/docs/developer/boot.html#boot-in-verbose-mode) to see any relevant error messages that may help in resolving the issue. -### Boot stalls during `Replicate system image to swap-based memdisk`(seen during verbose boot) +### Boot stalls with black screen -You may also see the error message `md1.uzip: UZIP(zlib) inflate() failed`. +This means that Xorg has been started but for some reason the login manager `slim` or the helloDesktop startup script `start-hello` cannot run. -This affects some computers with some (~ out of 10) builds of the ISO. If you encounter this issue with your computer, please __retry with the next build of the ISO__ or try with a different computer. +* Boot in verbose mode +* Press Ctrl+Alt+F2 +* Log in +* `sudo killall Xorg` +* `sudo service dbus restart` +* `sudo service slim restart` + +If this does not work: + +* `sudo killall Xorg` +* `startx` +* In XTerm, `sudo liveuser` (or the username you chose) +* `start-hello` ### `login:` prompt, no desktop environment From 78d6404592a3e672b2b66d7e2e91e6689c7047f4 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 22 Nov 2021 12:52:17 +0100 Subject: [PATCH 447/592] Update monkey-patch.md --- developer/monkey-patch.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/developer/monkey-patch.md b/developer/monkey-patch.md index 400b0d43..ea2b9f8b 100644 --- a/developer/monkey-patch.md +++ b/developer/monkey-patch.md @@ -53,3 +53,16 @@ HERE="$(dirname "$(readlink -f "${0}")")" cp ${HERE}/mount_md /usr/local/sbin/mount_md chmod +x /usr/local/sbin/mount_md ``` + +* There must be a `monkeypatch.sh` file that will be run by `#!/bin/sh` + +## Booting a Live ISO running a different `init_script` + +If you would like to test changes to `/boot/init_script` on the ISO without having to re-create it and without having to write the ISO to a device, you can use the `monkey_patch_init_script` feature: + +* Boot the ISO but interrupt the bootloader by pressing the Esc key +* At the boot prompt, enter: `set monkey_patch_init_script=YES` +* Optionally, use `unset BOOT_MUTE` so that you can see messages on the screen during boot +* Start the system by entering `boot` + +The code inside the file `init_script` on the volume called `MONKEYPATCH` will be executed instead of `/boot/init_script` on the ISO. From 1bbf3c3eb8d48410457381253efe45619788dc78 Mon Sep 17 00:00:00 2001 From: probonopd Date: Tue, 23 Nov 2021 21:04:02 +0100 Subject: [PATCH 448/592] Show Contents (from 0.7.0 on) [ci skip] --- user/components/applications.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/user/components/applications.md b/user/components/applications.md index b3a43290..74957b11 100644 --- a/user/components/applications.md +++ b/user/components/applications.md @@ -1,6 +1,6 @@ # Applications -Most applications in helloSystem come in the form of __application bundles__. An application bundle is an application that looks and behaves like a file but is actually a directory, containing not only the application but also auxiliary files such as icons and other resources. To view the contents of an application bundle, right-click on it and select "Open in new Tab". This is useful especially for open source applications written in languages such as PyQt5, because you can interactively edit the source code and test your changes. +Most applications in helloSystem come in the form of __application bundles__. An application bundle is an application that looks and behaves like a file but is actually a directory, containing not only the application but also auxiliary files such as icons and other resources. To view the contents of an application bundle, right-click on it and select "Show Contents". This is useful especially for open source applications written in languages such as PyQt5, because you can interactively edit the source code and test your changes. ![Viewing the contents of an application bundle](https://pbs.twimg.com/media/EoK9u7vXUAAJFPn?format=png) From 63bca777c4ea557bf6c73b43ca0def9595a15f62 Mon Sep 17 00:00:00 2001 From: probonopd Date: Tue, 23 Nov 2021 21:15:29 +0100 Subject: [PATCH 449/592] Starting with 0.7.0: 2 GiB minimum, 4 GiB recommended --- user/getting-started.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/user/getting-started.md b/user/getting-started.md index f5377e02..f4a172b2 100644 --- a/user/getting-started.md +++ b/user/getting-started.md @@ -7,7 +7,7 @@ hello is currently being developed. It is not yet available for general use, but ## System requirements * 2 GHz dual core Intel/ARM 64-bit processor -* 4 GiB RAM (system memory for physical and virtualized installs) +* 4 GiB RAM (system memory for physical and virtualized installs) (starting with 0.7.0: 2 GiB minimum, 4 GiB recommended) * VGA capable of 1024x768 screen resolution * Either a CD/DVD drive or a USB port for booting the installer media * On non-Macintosh hardware, a [Raspberry Pi keyboard](https://static.raspberrypi.org/files/product-briefs/210108_Product_Brief_Keyboard_and_Mouse.pdf) is recommended as it allows the keyboard and system language to be detected automatically if it is attached while the system is starting up. On Macintosh hardware, the `prev-lang:kbd` EFI variable is usually set and is used to detect the keyboard and system language. Note that the key left to the space bar is used as the Command key (Alt key on PC keyboards, Apple key on Apple keyboards). From f8a393e43d280655ace6fd99cd8f0e71bbaa8361 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 19 Dec 2021 16:32:16 +0100 Subject: [PATCH 450/592] Update index.md --- index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.md b/index.md index b51d79a2..0219ed6a 100644 --- a/index.md +++ b/index.md @@ -12,7 +12,7 @@ __helloSystem__ is a desktop system for creators with a focus on simplicity, elegance, and usability. Its design follows the "Less, but better" philosophy. It is intended as a system for "mere mortals", welcoming to switchers from the Mac. [FreeBSD](https://www.freebsd.org/) is used as the core operating system. Please refer to [https://github.com/helloSystem/hello](https://github.com/helloSystem/hello) if you would like to learn more about the ideas and principles behind hello. -![Screenshot](https://raw.githubusercontent.com/helloSystem/hello/1db268eb69c8c45909d1dc0f642395b5f948a338/screenshots/20211002-desktop-0.6.png) +![Screenshot](https://github.com/helloSystem/hello/blob/master/screenshots/20211219-desktop-0.7.png) ```eval_rst .. toctree:: From 4dfadd5b692834202242b4b1b54b3b5e539f6502 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 19 Dec 2021 16:53:39 +0100 Subject: [PATCH 451/592] 0.7.0 --- user/getting-started.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/user/getting-started.md b/user/getting-started.md index f4a172b2..663f5737 100644 --- a/user/getting-started.md +++ b/user/getting-started.md @@ -7,7 +7,7 @@ hello is currently being developed. It is not yet available for general use, but ## System requirements * 2 GHz dual core Intel/ARM 64-bit processor -* 4 GiB RAM (system memory for physical and virtualized installs) (starting with 0.7.0: 2 GiB minimum, 4 GiB recommended) +* 2 GiB RAM system memory (4 GiB recommended; before 0.7.0: 4 GiB minimum) * VGA capable of 1024x768 screen resolution * Either a CD/DVD drive or a USB port for booting the installer media * On non-Macintosh hardware, a [Raspberry Pi keyboard](https://static.raspberrypi.org/files/product-briefs/210108_Product_Brief_Keyboard_and_Mouse.pdf) is recommended as it allows the keyboard and system language to be detected automatically if it is attached while the system is starting up. On Macintosh hardware, the `prev-lang:kbd` EFI variable is usually set and is used to detect the keyboard and system language. Note that the key left to the space bar is used as the Command key (Alt key on PC keyboards, Apple key on Apple keyboards). @@ -18,7 +18,7 @@ Please refer to [FreeBSD Hardware Compatibility](https://www.freebsd.org/doc/en_ ## Downloading -The **helloSystem 0.6.0** ISO image is available for download [here](https://github.com/helloSystem/ISO/releases/tag/r0.6.0). +The **helloSystem 0.7.0** ISO image is available for download [here](https://github.com/helloSystem/ISO/releases/tag/r0.7.0). Experimental and pre-release images are available for download [here](https://github.com/helloSystem/ISO/releases). From 08af371ddba6fa42b42804a4b2f71b1871129188 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 19 Dec 2021 16:56:33 +0100 Subject: [PATCH 452/592] Update index.md --- index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.md b/index.md index 0219ed6a..c80067c7 100644 --- a/index.md +++ b/index.md @@ -12,7 +12,7 @@ __helloSystem__ is a desktop system for creators with a focus on simplicity, elegance, and usability. Its design follows the "Less, but better" philosophy. It is intended as a system for "mere mortals", welcoming to switchers from the Mac. [FreeBSD](https://www.freebsd.org/) is used as the core operating system. Please refer to [https://github.com/helloSystem/hello](https://github.com/helloSystem/hello) if you would like to learn more about the ideas and principles behind hello. -![Screenshot](https://github.com/helloSystem/hello/blob/master/screenshots/20211219-desktop-0.7.png) +![Screenshot](https://github.com/helloSystem/hello/raw/master/screenshots/20211219-desktop-0.7.png) ```eval_rst .. toctree:: From 1e7a526f1532788ce91bc2e2a1eadda95ae504be Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 27 Dec 2021 15:13:41 +0100 Subject: [PATCH 453/592] Fix Screenshot https://github.com/helloSystem/docs/issues/36 --- index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.md b/index.md index c80067c7..6a3f86f7 100644 --- a/index.md +++ b/index.md @@ -12,7 +12,7 @@ __helloSystem__ is a desktop system for creators with a focus on simplicity, elegance, and usability. Its design follows the "Less, but better" philosophy. It is intended as a system for "mere mortals", welcoming to switchers from the Mac. [FreeBSD](https://www.freebsd.org/) is used as the core operating system. Please refer to [https://github.com/helloSystem/hello](https://github.com/helloSystem/hello) if you would like to learn more about the ideas and principles behind hello. -![Screenshot](https://github.com/helloSystem/hello/raw/master/screenshots/20211219-desktop-0.7.png) +![Screenshot](https://raw.githubusercontent.com/helloSystem/hello/master/screenshots/20211219-desktop-0.7.png) ```eval_rst .. toctree:: From fa9656118cbde450daee133f8e2b589019a82d0a Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 27 Dec 2021 15:50:05 +0100 Subject: [PATCH 454/592] System -> Applications -> Utilities -> Install FreeBSD https://github.com/helloSystem/ISO/issues/348 --- user/getting-started.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/user/getting-started.md b/user/getting-started.md index 663f5737..a2ed7681 100644 --- a/user/getting-started.md +++ b/user/getting-started.md @@ -132,7 +132,7 @@ qemu-system-x86_64 -machine type=q35,accel=kvm \ When QEMU starts, press `esc` and select `2` to boot the ISO. -Use the __Install FreeBSD__ utility to install helloSystem do the disk image. +Use the __Install FreeBSD__ utility (System -> Applications -> Utilities -> Install FreeBSD) to install helloSystem to the disk image. Then restart QEMU, you now remove the last two options from the above command. From 37ab6daab34651b082ebdb3b0925545e770c3c3d Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 1 Jan 2022 21:06:05 +0100 Subject: [PATCH 455/592] Update acknowledgements.md --- developer/acknowledgements.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/developer/acknowledgements.md b/developer/acknowledgements.md index 83074eaa..af05af65 100644 --- a/developer/acknowledgements.md +++ b/developer/acknowledgements.md @@ -126,3 +126,7 @@ __[mszoek](https://github.com/mszoek)__ ## alphamodh0 __[alphamodh0](https://github.com/alphamodh0)__ * Translated helloSystem to Spanish + +## Sebastian Birnbach +[https://zweibruecken-ip.de/](https://zweibruecken-ip.de/) +* Donated a Mac mini (Mid 2010) (`Macmini4,1`) to the helloSystem Hardware Test Zoo From eae245332e8466d5ad9743e518477fd7bfcd0b0c Mon Sep 17 00:00:00 2001 From: probonopd Date: Thu, 6 Jan 2022 19:12:03 +0100 Subject: [PATCH 456/592] Update developer-tools.md --- developer/developer-tools.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/developer/developer-tools.md b/developer/developer-tools.md index a5eea106..cce398e9 100644 --- a/developer/developer-tools.md +++ b/developer/developer-tools.md @@ -1,5 +1,7 @@ # Developer Tools +Starting with helloSystem 0.7.0, compilers, headers, `.o` files and other files for developers are not shipped on the helloSystem Live ISO by default in order to reduce the ISO size. You need to install the Developer Tools from `developer.img` which is a separate download from the same location you obtained the Live ISO (e.g., for 0.7.0, this is https://github.com/helloSystem/ISO/releases/tag/r0.7.0). + The __Developer__ folder in the __Applications__ folder contains useful development tools for use with helloSystem. * __PyCharm CE__: A powerful integrated development environment (IDE) for the Python language which is used for From 7b3cd192112b9a19beb6a4afb84c3235b6edfb0e Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 15 Jan 2022 11:57:46 +0100 Subject: [PATCH 457/592] Update contact.md --- developer/contact.md | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/developer/contact.md b/developer/contact.md index 642c8b65..28a9a3a9 100644 --- a/developer/contact.md +++ b/developer/contact.md @@ -1,5 +1,11 @@ # Contact -You can meet other helloSystem users and developers at [`#helloSystem:matrix.org`](https://matrix.to/#/#helloSystem:matrix.org) from any Matrix client (such as the Element web-based Matrix client). This Matrix channel is bridged to the IRC channel #helloSystem on irc.libera.chat. Joining via Matrix has the advantage that you will see responses that you may have received while you were offline. So after asking a question, you can come back in a day or so to see if there were any responses. +## Discussions -In any case, please stay in the channel for a few days and do not expect to receive answers immediately, since we are all volunteers. +The helloSystems [Discussions](https://github.com/helloSystem/hello/discussions/) forum is a great place to interact with helloSystem users and developers. + +## Chat + +You can also meet other helloSystem users and developers at [`#helloSystem:matrix.org`](https://matrix.to/#/#helloSystem:matrix.org) from any Matrix client (such as the Element web-based Matrix client). This Matrix channel is bridged to the IRC channel #helloSystem on irc.libera.chat. Joining via Matrix has the advantage that you will see responses that you may have received while you were offline. So after asking a question, you can come back in a day or so to see if there were any responses. + +In any case, _please stay in the channel for a few days_ and do not expect to receive answers immediately, since we are all volunteers and come by only once in a while. From d826343a72c75b9c363fe7a76402551e8b6aad9c Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 15 Jan 2022 12:01:48 +0100 Subject: [PATCH 458/592] Update contact.md --- developer/contact.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/developer/contact.md b/developer/contact.md index 28a9a3a9..28def35e 100644 --- a/developer/contact.md +++ b/developer/contact.md @@ -2,7 +2,7 @@ ## Discussions -The helloSystems [Discussions](https://github.com/helloSystem/hello/discussions/) forum is a great place to interact with helloSystem users and developers. +The helloSystem [Discussions](https://github.com/helloSystem/hello/discussions/) forum is a great place to interact with helloSystem users and developers. If you have questions, feel free to ask in "Q&A". If you are running helloSystem, we'd be happy to hear from you in the "Show and tell" section. ## Chat From ace5508677de3d80970592dadf6dee355b2c2f27 Mon Sep 17 00:00:00 2001 From: probonopd Date: Tue, 18 Jan 2022 18:33:21 +0100 Subject: [PATCH 459/592] Update acknowledgements.md --- developer/acknowledgements.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/developer/acknowledgements.md b/developer/acknowledgements.md index af05af65..f7264148 100644 --- a/developer/acknowledgements.md +++ b/developer/acknowledgements.md @@ -130,3 +130,7 @@ __[alphamodh0](https://github.com/alphamodh0)__ ## Sebastian Birnbach [https://zweibruecken-ip.de/](https://zweibruecken-ip.de/) * Donated a Mac mini (Mid 2010) (`Macmini4,1`) to the helloSystem Hardware Test Zoo + +## Luna Jernberg +__[bittin](https://github.com/bittin)__ +* Translated helloSystem installer to Swedish From 1b7630e2f047d75f779aaa825d6b9b2d078c11d4 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 23 Jan 2022 20:39:43 +0100 Subject: [PATCH 460/592] Try to upload EPUB --- .github/workflows/main.yml | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/.github/workflows/main.yml b/.github/workflows/main.yml index 76f50f34..fa3ceba5 100644 --- a/.github/workflows/main.yml +++ b/.github/workflows/main.yml @@ -19,9 +19,15 @@ jobs: runs-on: ubuntu-latest env: G_TOKEN: ${{secrets.GITHUB_TOKEN}} + GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} steps: - uses: actions/checkout@v2 - name: Build docs run: sudo -E bash -ex buildDocs.sh + - name: Deploy EPUB (only when building from master branch) + if: ${{ github.ref == 'refs/heads/master' }} + run: | + wget -c https://github.com/probonopd/uploadtool/raw/master/upload.sh + bash ./upload.sh _build/epub/* From c8723581cc1af301d4830edeacddbb74efe909e1 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 23 Jan 2022 20:40:21 +0100 Subject: [PATCH 461/592] Try to deploy EPUB (only when building from main branch) --- .github/workflows/main.yml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/.github/workflows/main.yml b/.github/workflows/main.yml index fa3ceba5..a8f24bad 100644 --- a/.github/workflows/main.yml +++ b/.github/workflows/main.yml @@ -26,8 +26,8 @@ jobs: - name: Build docs run: sudo -E bash -ex buildDocs.sh - - name: Deploy EPUB (only when building from master branch) - if: ${{ github.ref == 'refs/heads/master' }} + - name: Deploy EPUB (only when building from main branch) + if: ${{ github.ref == 'refs/heads/main' }} run: | wget -c https://github.com/probonopd/uploadtool/raw/master/upload.sh bash ./upload.sh _build/epub/* From d73aaef44522b332c60d03d56cdc7c2cae7b594e Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 23 Jan 2022 20:45:37 +0100 Subject: [PATCH 462/592] Deploy epub file only --- .github/workflows/main.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/main.yml b/.github/workflows/main.yml index a8f24bad..9ef42dd5 100644 --- a/.github/workflows/main.yml +++ b/.github/workflows/main.yml @@ -30,4 +30,4 @@ jobs: if: ${{ github.ref == 'refs/heads/main' }} run: | wget -c https://github.com/probonopd/uploadtool/raw/master/upload.sh - bash ./upload.sh _build/epub/* + bash ./upload.sh _build/epub/*.epub From 6f2be352f2285f2c687a35c751468a7eb9682e13 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 31 Jan 2022 19:13:45 +0100 Subject: [PATCH 463/592] Create midi.md --- developer/midi.md | 101 ++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 101 insertions(+) create mode 100644 developer/midi.md diff --git a/developer/midi.md b/developer/midi.md new file mode 100644 index 00000000..5ca46293 --- /dev/null +++ b/developer/midi.md @@ -0,0 +1,101 @@ +# MIDI + +Over a decade ago, someone [wrote](https://forums.freebsd.org/threads/alsa-midi-is-the-key-to-serious-musicproduction.22722/#post-158077) on the FreeBSD forum: + +> The main problem with anything midi and jack (in fact anything more complex than using simple audio in or audio out) under FreeBSD, is that I haven't found out how to configure things. A complete writeup (for a non-musician) about how to configure a system which use jack would be nice. + +``` .. note:: + This page describes how to use USB based hardware MIDI controllers (e.g., keyboards), with helloSystem and FreeBSD. It is a work in progress. Please consider contributing additions and corrections. +``` + +## Using /dev/umidi* + +Whenever a USB based hardware MIDI controller is plugged into the computer, a `/dev/umidi*` device node is created automatically. + +### Testing + +To test whether input from the MIDI controller arrives, run in a Terminal window: + +``` +midicat -d -q rmidi/0.0 -o /dev/null +``` + +As you play some notes on the MIDI controller, you should see MIDI messages appear on the screen. After verifying that this works, exit `midicat`. + +Some applications can use `/dev/umidi*` device nodes directly. Some expect the device node to be at `/dev/midi` though, so you need to create a symlink there manually. + +### Example application + +For example, the `fluidsynth` command line tool, can use hardware MIDI controllers in this way directly: + +``` +sudo pkg install -y fluidsynth musescore +sudo ln -sf /dev/umidi*.0 /dev/midi +fluidsynth -m oss -a oss SoundFont.sf2 +``` + +Unfortunately, not all applications on FreeBSD can use `/dev/umidi*` device nodes directly in this way. Hence there are other methods to access MIDI controllers. which one you need to use depends on what methods the application in question supports. + +## Using OSS Raw-MIDI (Open Sound System) + +Supposedly applications can use "OSS Raw-MIDI (Open Sound System)" to talk to MIDI controllers. + +### Testing + +Please let us know if you know how this works. + +### Example application + +The LMMS FreeBSD package offers "OSS Raw-MIDI (Open Sound System)" in the dropdown menu for the MIDI interface; however, it is not clear whether and how this works on FreeBSD. Please let us know if you know how this works. + +## Using alsa-seq-server + +Some applications can use `alsa-seq-server` to access MIDI controllers. For some applications, this support needs to be specifically enabled as a configuration option at compile time. + +In order for applications that use `alsa-seq-server` to talk to your MIDI controller, run + +``` +sudo pkg install alsa-seq-server alsa-utils +sudo alsa-seq-server -d /dev/umidi* +``` + +and then run the application. + +### Testing + +To test whether input from the MIDI controller arrives, run in a separate Terminal: + +``` +aseqdump -p 0 +Waiting for data. Press Ctrl+C to end. +Source Event Ch Data +``` + +As you play some notes on the MIDI controller, you should see MIDI messages appear on the screen. After verifying that this works, exit `aseqdump`. + +### Example application + +An example application that can use `alsa-seq-server` to talk to MIDI controllers "out of the box" (without the need to recompile the application) is yet to be found in the FreeBSD Packages collection. Please let us know if you know one. + +Recompiling LMMS from FreeBSD Ports with the following change regarding `WANT_ALSA` in the `Makefile` allows one to use `alsa-seq-server` to talk to MIDI controllers: + +``` +CMAKE_OFF= WANT_CALF WANT_CAPS WANT_CMT WANT_SWH WANT_STK \ + WANT_TAP WANT_VST +CMAKE_ON= WANT_QT5 WANT_ALSA +``` + +Run `make clean ; make config ; make` to define which of the supported sound systems and MIDI interfaces will be available. LMMS can support the following MIDI interfaces on FreeBSD if it is configured accordingly at compile time: ALSA, OSS, Sndio, JACK. The ALSA one is known to work. + +To use it, select "ALSA-Sequencer (Advanced Linux Sound Architecture)" from the MIDI interface dropdown menu in the MIDI pane of the LMMS settings, restart ALSA, click on the gear icon e.g., in the TripleOscillator track, and select MIDI -> Input -> 0:0 (name of your USB device). + +If you see + +``` +ALSA lib seq_hw.c:466:(snd_seq_hw_open) open /dev/snd/seq failed: No such file or directory +cannot open sequencer: No such file or directory +``` + +when you start LMMS, then most likely `sudo alsa-seq-server -d /dev/umidi*` is not running (see above). + +Note that depending on the application, using `alsa-seq-server` for the MIDI interface does not automatically mean that you have to use ALSA as the sound system (e.g., for the output of the generated sound). For example, if LMMS has been configured at compile time to support SDL (Simple DirectMedia Layer), you could use SDL rather than ALSA for the sound output. From b3e60894169ee0496042acc9a2542510c4420447 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 31 Jan 2022 19:14:29 +0100 Subject: [PATCH 464/592] Add MIDI --- index.md | 1 + 1 file changed, 1 insertion(+) diff --git a/index.md b/index.md index 6a3f86f7..bbbfe592 100644 --- a/index.md +++ b/index.md @@ -45,6 +45,7 @@ __helloSystem__ is a desktop system for creators with a focus on simplicity, ele developer/menu developer/filer-context-menus developer/developer-tools + developer/midi developer/specifications developer/contributing developer/building From 1a6299178b647fc39a5da46e179b135df5dce1c6 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 31 Jan 2022 19:21:45 +0100 Subject: [PATCH 465/592] Update midi.md --- developer/midi.md | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/developer/midi.md b/developer/midi.md index 5ca46293..870f4b30 100644 --- a/developer/midi.md +++ b/developer/midi.md @@ -4,8 +4,10 @@ Over a decade ago, someone [wrote](https://forums.freebsd.org/threads/alsa-midi- > The main problem with anything midi and jack (in fact anything more complex than using simple audio in or audio out) under FreeBSD, is that I haven't found out how to configure things. A complete writeup (for a non-musician) about how to configure a system which use jack would be nice. +This page describes how to use USB based hardware MIDI controllers (e.g., keyboards), with helloSystem and FreeBSD. + ``` .. note:: - This page describes how to use USB based hardware MIDI controllers (e.g., keyboards), with helloSystem and FreeBSD. It is a work in progress. Please consider contributing additions and corrections. + It is a work in progress. Please consider contributing additions and corrections. ``` ## Using /dev/umidi* @@ -61,6 +63,10 @@ sudo alsa-seq-server -d /dev/umidi* and then run the application. +``` .. note:: + alsa-seq-server was recently updated so that one can run it as a service which will automatically make all MIDI devices available without having to run one instance per MIDI device. The change should appear in FreeBSD packages (and thus in helloSystem) starting in Q2/2022. +``` + ### Testing To test whether input from the MIDI controller arrives, run in a separate Terminal: From b1efb82cbb4c984916117e19c71ca50797d01740 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 31 Jan 2022 19:24:09 +0100 Subject: [PATCH 466/592] Update midi.md --- developer/midi.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/developer/midi.md b/developer/midi.md index 870f4b30..0bc2506b 100644 --- a/developer/midi.md +++ b/developer/midi.md @@ -38,6 +38,10 @@ fluidsynth -m oss -a oss SoundFont.sf2 Unfortunately, not all applications on FreeBSD can use `/dev/umidi*` device nodes directly in this way. Hence there are other methods to access MIDI controllers. which one you need to use depends on what methods the application in question supports. +``` .. note:: + Applications cannot access /dev/umidi* directly while alsa-seq-server is running. +``` + ## Using OSS Raw-MIDI (Open Sound System) Supposedly applications can use "OSS Raw-MIDI (Open Sound System)" to talk to MIDI controllers. From d72c66ddcc1e042d0bb8de983845541efd8477c8 Mon Sep 17 00:00:00 2001 From: abby2k1 <94508813+abby2k1@users.noreply.github.com> Date: Sat, 19 Feb 2022 04:21:23 -0600 Subject: [PATCH 467/592] Update getting-started.md (#39) Corrected mistake in system requirements, 'Intel/ARM', to 'Intel/AMD'. --- user/getting-started.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/user/getting-started.md b/user/getting-started.md index a2ed7681..f7c6b085 100644 --- a/user/getting-started.md +++ b/user/getting-started.md @@ -6,7 +6,7 @@ hello is currently being developed. It is not yet available for general use, but ## System requirements -* 2 GHz dual core Intel/ARM 64-bit processor +* 2 GHz dual core Intel/AMD 64-bit processor * 2 GiB RAM system memory (4 GiB recommended; before 0.7.0: 4 GiB minimum) * VGA capable of 1024x768 screen resolution * Either a CD/DVD drive or a USB port for booting the installer media From 4e826f940d52c6c15cf872651f02c22141da346e Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 19 Feb 2022 14:28:18 +0100 Subject: [PATCH 468/592] Update ux-guidelines.md --- developer/ux-guidelines.md | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/developer/ux-guidelines.md b/developer/ux-guidelines.md index 638f1bbd..b7e4622e 100644 --- a/developer/ux-guidelines.md +++ b/developer/ux-guidelines.md @@ -10,7 +10,9 @@ What are the design principles that make user interfaces "Mac-like"? Apple spell Source: [Apple Computer, Inc., 1992, Macintosh Human Interface Guidelines, First Printing, November 1992. Addison-Wesley Publishing Company. ISBN 0-201-62216-5](https://dl.acm.org/doi/book/10.5555/573097) -## Walker, N & Smelcer, 1990 (Superiority of the global menu bar) +## Using the global menu bar + +### Walker, N & Smelcer, 1990 (Superiority of the global menu bar) Referred to in the Macintosh Human Interface Guidelines with highest praise: @@ -28,6 +30,10 @@ more efficient to place menus at the top of the window Source: Walker, N & Smelcer, JB 1990, A comparison of selection times from walking and pull-down menus. in JC Chew & J Whiteside (eds), Proceedings of the SIGCHI Conference on Human Factors in Computing Systems, CHI 1990. Association for Computing Machinery, pp. 221-225, 1990 SIGCHI Conference on Human Factors in Computing Systems, CHI 1990, Seattle, United States, 4/1/90. https://dl.acm.org/doi/pdf/10.1145/97243.97277 +## Avoiding hidden menus hamburger icons + +Menus hidden behind hamburger menus have been [proven to hurt user experience]( https://www.nngroup.com/articles/hamburger-menus/). They should not be used. The global menu bar should be used instead. + ## Avoiding configuration options Configuration options add complexity to software, increase the test matrix, and make software harder to support (e.g., over the phone) because no two systems behave exactly the same way depending on how they were configured. Hence in helloSystem we want to avoid unnecessary user-facing configuration options whenever possible. We take great care to set sensible defaults and make things "just work" as expected (in line with our design objectives) out of the box, without the need for configuration. KDE Plasma is recommended as an alternative for users who wish to configure and customize every aspect of the system. From 81767db03eb574564df9e64e9a5e62c9c8b89b83 Mon Sep 17 00:00:00 2001 From: probonopd Date: Wed, 23 Feb 2022 20:11:23 +0100 Subject: [PATCH 469/592] Lower RAM requirement as of 0.7.0 --- user/getting-started.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/user/getting-started.md b/user/getting-started.md index f7c6b085..b26a98c0 100644 --- a/user/getting-started.md +++ b/user/getting-started.md @@ -100,7 +100,7 @@ Users have reported success in running helloSystem in the following virtualizati Please note: * The VM needs to be __64-bit__ -* The VM needs __at least 4 GB of RAM__ +* The VM needs __at least 2 GB of RAM__ * The VM needs __at least 2 CPU cores__ * The boot process takes longer than you might expect; boot in verbose mode to see the details * For best results set **EFI/UEFI** boot mode (not BIOS) From 74c12f0f88aaedfc9fe742f04ea987e53472741c Mon Sep 17 00:00:00 2001 From: Mark LaPointe <47114659+marklapointe@users.noreply.github.com> Date: Fri, 25 Feb 2022 02:37:38 -0500 Subject: [PATCH 470/592] Update getting-started.md (#40) * Update getting-started.md I have been able to install on VMware Workstation, updating with details. * Update getting-started.md --- user/getting-started.md | 26 ++++++++++++++++++-------- 1 file changed, 18 insertions(+), 8 deletions(-) diff --git a/user/getting-started.md b/user/getting-started.md index b26a98c0..a16f70bf 100644 --- a/user/getting-started.md +++ b/user/getting-started.md @@ -22,9 +22,9 @@ The **helloSystem 0.7.0** ISO image is available for download [here](https://git Experimental and pre-release images are available for download [here](https://github.com/helloSystem/ISO/releases). -``` .. important:: - Experimental images get built automatically whenever source code is committed. Not every build is tested. Builds marked as "Pre-Release" are strictly for developers, may be broken and may not even boot. -``` + +> :warning: **Important**
Experimental images get built automatically whenever source code is committed. Not every build is tested. Builds marked as "Pre-Release" are strictly for developers, may be broken and may not even boot. + ## Creating Live Media @@ -81,15 +81,13 @@ Detailed information on #FreeBSD wireless network card compatibility is availabl ## Virtualization environments -``` .. note:: - We recommend running helloSystem on real hardware ("bare metal") if possible. This should give you the best possible performance and hardware support. -``` +> :warning: **Note**:
We recommend running helloSystem on real hardware ("bare metal") if possible. This should give you the best possible performance and hardware support. Users have reported success in running helloSystem in the following virtualization environments: -* VirtualBox host (on FreeBSD and on macOS), known to work in BIOS and EFI mode +* VirtualBox host (on FreeBSD and on macOS), known to work in BIOS and EFI modes -* VMware host (on Windows), possibly only working in BIOS mode? +* VMware Workstation works in BIOS and EFI modes (see below) * QEMU host (on Linux), works in both BIOS and EFI modes (see below). Note that for acceptable performance, QEMU needs KVM which is currently not available on FreeBSD hosts yet @@ -171,3 +169,15 @@ Then add these two `qemu-system-x86_64` options: * Network Device: VirtIO To set resolution, press F2 at boot to access OVMF settings. Select 'Device Manager > OVMF Platform Configuration > Change Preferred', save and reboot. + +### VMware Workstation +Tested on VMware Workstation 16.2.1 + +> :warning: **Installation Issue**
For best results while installing, please set your CPU to 1 socket, and no more than 4 cores.
After installation, you can set the CPU socket and core count to your desire. + +* Memory: 4GB +* Processors: 4 (1 socket, 4 cores) +* Hard Disk: At least 8GB +* Guest Operating System Version: FreeBSD 12 64-bit + + From fbe476608f3d9a5629bff2df9394ccb5dca50b13 Mon Sep 17 00:00:00 2001 From: TriVoxel Date: Tue, 1 Mar 2022 12:33:06 -0700 Subject: [PATCH 471/592] Add more helpful information (#41) Provide more details, streamlined installation instructions, add performance information, and fix display instructions. --- developer/rpi.md | 109 ++++++++++++++++++++++++++++++++++++----------- 1 file changed, 83 insertions(+), 26 deletions(-) diff --git a/developer/rpi.md b/developer/rpi.md index 94f861ad..0e28ef45 100644 --- a/developer/rpi.md +++ b/developer/rpi.md @@ -6,9 +6,7 @@ Although we are currently not providing installation images for Raspberry Pi, we The same instructions are roughly applicable to other aarch64 based systems such as rk3399 ones like the PineBook Pro and the [pine64 rockpro64_rk3399](https://bsd-hardware.info/?id=board:pine64-pinebook-pro-rk3399) as well. -``` .. note:: - This page is intended for technically advanced users and developers, not for end users. This page is work in progress. Instructions are brief and assume prior knowledge with the subject. -``` +> __Note:__ This page is intended for technically advanced users and developers, not for end users. This page is work in progress. Instructions are brief and assume prior knowledge with the subject. This page describes how to run the main components of helloSystem (referred to collectively as helloDesktop) on Raspberry Pi 3 and Raspberry Pi 4 devices, starting with the official FreeBSD 13 image that does not even contain Xorg. @@ -25,21 +23,44 @@ If there is enough interest, we might eventually provide readymade helloSystem i * Keyboard and mouse (we recommend the official Raspberry Pi keyboard since helloSystem can automatically detect its language) * Ethernet (WLAN is not yet covered on this page) -## Preparing +## Optional hardware + +* SATA SSD drive (not NVME) + +## Preparing an SD card * Install the official FreeBSD 13 image (not FreeBSD 14) to a microSD card * Copy this file to the microSD card you are running the Raspberry Pi from. You will need it because you will not have an internet browser at hand -* Edit `config.txt` in the `MSDOSBOOT` partition to contain the correct resolution for your screen. Apparently the screen resolution is not autodetected on the Raspberry Pi? +* Edit `config.txt` in the `MSDOSBOOT` partition to contain the correct resolution for your screen. ``` hdmi_safe=0 -framebuffer_width=1920 -framebuffer_height=1080 disable_overscan=1 +display_auto_detect=1 +max_framebuffer_width=3840 +max_framebuffer_height=2160 +max_framebuffers=2 +gpu_mem=512 + +[pi4] +dtoverlay=vc4-kms-v3d-pi4 ``` ``` .. note:: - Please let us know if you know how to get screen resolution autodetection working on FreeBSD with Raspberry Pi +If, for some reason, the display does not work, simply remove or comment out the `max_framebuffer*` lines and replace them with the following: +``` +``` +framebuffer_width= +framebuffer_height= +``` + +## Preparing a bootable SSD drive (optional but recommended) + +* [Update your firmware if USB boot is not working](https://www.raspberrystreet.com/learn/how-to-boot-raspberrypi-from-usb-ssd) +* Follow the instructions in the SD card section, but write the image to your SSD + +``` .. note:: +The Raspberry Pi 4/400 doesn't have a PCIe bus, so booting off an NVMe drive over USB protocol is not supported by the hardware. You will need to use a SATA SSD. This works for either M.2 or traditional drive form factors. ``` ## Booting into the system @@ -48,14 +69,16 @@ We will be doing all subsequent steps on the Raspberry Pi system itself since we * Insert the microSD card into the Raspberry Pi * Attach keyboard and mouse (we recommend the official Raspberry Pi keyboard since helloSystem can automatically detect its language) -* Attach the display (on the Raspberry Pi 4, the display needs to be attached to the HDMI port next to the USB type C power port) +* Attach the display (If you don't see anything, DO NOT power off your machine. Simply switch the HDMI port.) * Attach Ethernet * Power on the Raspberry Pi -* After some time you should land in a login screen +* After some time, you should land in a login screen * Log in with `root`, password `root` * Install some basic software with `pkg install -y xorg xterm nano openbox fluxbox git-lite` -__NOTE:__ `fluxbox` is not strictly needed and can be removed later on, but it gives us a graphical desktop session while we are working on installing helloDesktop +``` .. note:: +`fluxbox` is not strictly needed and can be removed later on, but it gives us a graphical desktop session while we are working on installing helloDesktop +``` ## Starting a graphical session @@ -70,6 +93,12 @@ Doing it like this is the easiest way since the display `DISPLAY` environment va ## Compiling and installing helloDesktop core components +### Install prerequisites + +``` +pkg install -y cmake pkgconf qt5-qmake qt5-buildtools kf5-kdbusaddons kf5-kwindowsystem libdbusmenu-qt5 qt5-concurrent qt5-quickcontrols2 libfm libqtxdg wget +``` + ### launch The `launch` command is central to helloSystem and is used to launch applications throughout the system. @@ -89,7 +118,6 @@ cd ../../ ### Menu ``` -pkg install -y cmake pkgconf qt5-qmake qt5-buildtools kf5-kdbusaddons kf5-kwindowsystem libdbusmenu-qt5 qt5-concurrent qt5-quickcontrols2 git clone https://github.com/helloSystem/Menu cd Menu mkdir build @@ -108,7 +136,6 @@ git clone https://github.com/helloSystem/Filer cd Filer/ mkdir build cd build/ -pkg install -y libfm cmake .. make -j4 make install @@ -117,9 +144,9 @@ cd ../../ ``` ``` .. note:: - It seems like Filer refuses to start if D-Bus is missing. We should change it so that it can also work without D-Bus and at prints a clear warning if D-Bus is missing. Currently all you see if D-Bus is missing is the following: '** (process:3691): WARNING **: The directory '~/Templates' doesn't exist, ignoring it', and then Filer exits. +It seems like Filer refuses to start if D-Bus is missing. We should change it so that it can also work without D-Bus and at prints a clear warning if D-Bus is missing. Currently all you see if D-Bus is missing is the following: '** (process:3691): WARNING **: The directory '~/Templates' doesn't exist, ignoring it', and then Filer exits. ``` - + ### Dock ``` @@ -143,7 +170,6 @@ git clone https://github.com/helloSystem/QtPlugin cd QtPlugin/ mkdir build cd build/ -pkg install -y libqtxdg cmake .. make -j4 make install @@ -158,7 +184,6 @@ Install icons and other helloSystem assets that are not packaged as FreeBSD pack For the system icons: ``` -pkg install -y wget wget -c -q http://archive.ubuntu.com/ubuntu/pool/universe/x/xubuntu-artwork/xubuntu-icon-theme_16.04.2_all.deb tar xf xubuntu-icon-theme_16.04.2_all.deb tar xf data.tar.xz @@ -268,29 +293,63 @@ cp /home/user/.openbox* . cp -r /home/user/.config/* .config/ ``` -## Known issues +## Improving system performance + +### Setting up SWAP for greater system memory capabilities ``` .. note:: - Any help in improving the situation is appreciated. + While this will work on an SD card, it will be slow and wear out your drive quickly. Take it from me, SD cards SUCK for quick memory page access. It is highly recommended to use a SATA SSD when using SWAP. This section was adapted from [a guide on nixCraft](https://www.cyberciti.biz/faq/create-a-freebsd-swap-file/). It goes into more detail and even breifly covers encryption. +``` + +* Create a SWAP file using +``` +# dd if=/dev/zero of=/swap bs=1M count=8192 +``` +``` .. note:: +This will create a swap file holding up to 8192 MB (8 GB) of memory. To go much further beyond that would recommend some further tweaking. 8 GB should be more than enough. It's easy enough to convert what you want in GB to MB, but for the sake of convenience, multiply how much memory you want in gigabytes (GB) by 1024. For example, if you wanted 4 GB, you'd do 4*1024=4096. +``` +* Run `# chmod 0600 /swap` to give it the correct permissions. +* Edit /etc/fstab and append the following line: +``` +md42 none swap sw,file=/swap 0 0 ``` +* Run `# swapon -aq` to immediately enable SWAP +* Run `$ swapinfo -k` to verify that it's been attached correctly -### No 3D graphics and video acceleration +### Overclocking your system -* Very low FPS video -* No 3D acceleration +With an SSD, SWAP, and several GPU enhancements enabled, you should immediately notice a speed boost. This will give you a much better development system and may even replace your desktop. However, you can quickly and easily take it a step further by overclocking your system. Please note, overclocking can lead to reduced hardware lifespan and can cause permenant damage. That said, I've found that a decent heat sing and a good fan go the trick. This is necessary as not having a somewhat competatant cooling solution will bite you in the ass. If you let it heat too much, it will thermal throttle and kill your performance. Do keep in mind, you need a good power supply to run this thing, especially overclocked. A Raspberry Pi power supply is a little different than a normal phone charger by design. Your new iPhone or MacBook charger probably won't cut it. I'd recommend getting the [official Rasbperry Pi power supply](https://www.amazon.com/Raspberry-Power-Supply-USB-C-Listed/dp/B07Z8P61DQ), manufactured by the Rasbperry Pi Foundation or whatever. Ir's OEM, it's good. Another great option is the [Argon ONE](https://www.amazon.com/Argon-Raspberry-Supply-Listed-Adapter/dp/B07TW4Q693) power supply. -Not sure whether `vc4-kms-v3d` is usable with FreeBSD. +Overclocking is inherently dangerous as you are pushing the device beyond the intended spec. However, it is a very simple and robust machine that will most likely experience no ussues doing this. The Raspberry Pi is very affordable and modular, making the risk of hardware failure less of an issue. The main board can easily be swapped out and EEPROM flashed and you have your whole system back. There's a hard limit to how far you can push your Pi, so don't even worry about overdoing it. No 8 GHz liquid nitrogen overclocks I'm afraid. + +To overclock you Raspberry Pi 4 to the max, edit `/boot/msdos/config.txt` and append the following: + +``` +over_voltage=6 +arm_freq=2147 +gpu_freq=700 +``` + +2147 MHz is the maximum the device can go. Unlike Raspberry Pi OS, FreeBSD will boot even if you set these values higher. Even though you can set it higher, I can see no difference, even at 3000. You can set the gpu_freq up to "900" before it refuses to boot on FreeBSD. However, I can't tell if it is actually working or not. Even if you can push it past its limits, you will probaby see diminishing returns. In the event that you actually can overclock it to these badass levels, I'd recommend investing in a monster CPU cooler, maybe even running liquid cooling or higher as 2147 MHz is already pretty warm. + +## Known issues ``` .. note:: - Any help in improving Raspberry Pi graphics on FreeBSD appreciated. + Any help in improving the situation is appreciated. ``` +Not sure whether `vc4-kms-v3d` is usable with FreeBSD. + Also see: https://papers.freebsd.org/2019/bsdcan/vadot-adventure_in_drmland/ ### Missing login window The `slim` package is missing, hence we don't have a login window at the moment. +``` .. note:: + Web browser performance may be improved and the following issues may not be relevant anymore. This will require more user feedback and testing. +``` + ### Web browser The Falkon browser can be launched, but trying to load more than the most basic web pages such as http://frogfind.com/ leads to an instant crash: @@ -311,8 +370,6 @@ Rendering engine: QtWebEngine The exact same crash also happens on a RockPro64 with 4GB of RAM. ``` -How do projects like the official Raspberry Pi OS (Debian based desktop) manage to do web browsing and video playing in a browser on the Raspberry Pi? - ### RAM compression On Linux, there is also __zram__ which is enabled by default on Android and Chromium OS. Did anything ever come out of https://wiki.freebsd.org/SummerOfCode2019Projects/VirtualMemoryCompression? From 8990d97a7939b92cbda4f41e744cfe5617da1623 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 14 May 2022 23:31:05 +0200 Subject: [PATCH 472/592] For Firefox, this topic is being discussed upstream --- developer/menu.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/developer/menu.md b/developer/menu.md index 62999777..4325e8c6 100644 --- a/developer/menu.md +++ b/developer/menu.md @@ -298,6 +298,9 @@ Firefox and Thunderbird need substantial source code patches to make global menu * https://aur.archlinux.org/cgit/aur.git/tree/unity-menubar.patch?h=firefox-appmenu. See https://github.com/airyxos/Firefox_app for a FreeBSD implementation * https://aur.archlinux.org/cgit/aur.git/tree/0001-Use-remoting-name-for-GDK-application-names.patch?h=firefox-appmenu +For Firefox, this topic is being discussed upstream: +https://bugzilla.mozilla.org/show_bug.cgi?id=1419151 + FreeBSD Ports files for patched Firefox and Thunderbird by Jesper Schmitz Mouridsen ([__jsm222__](https://github.com/jsm222/)) are available at * https://github.com/jsm222/helloDesktop/tree/main/www/firefox * https://github.com/jsm222/helloDesktop/tree/main/mail/thunderbird From 920b82038278ffedb0e1fa5cef53803c6a248b42 Mon Sep 17 00:00:00 2001 From: 9gay <112729446+9gay@users.noreply.github.com> Date: Sun, 4 Sep 2022 15:11:23 +0000 Subject: [PATCH 473/592] autostart: correct documentation (#44) note that `~/Applications/Autostart` doesn't work --- user/components/autostart.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/user/components/autostart.md b/user/components/autostart.md index ad6e3bdb..97950a4b 100644 --- a/user/components/autostart.md +++ b/user/components/autostart.md @@ -2,8 +2,8 @@ The __Autostart__ mechanism provides an easy way to automatically start applications whenever the computer is started (to be precise, when a user is logged into a graphical desktop session). Applications can be either `.app` bundles or `.AppDir` directories. -* __System-wide autostart__: Place applications (or symlinks to applications) into the `/Applications` folder to have them started for all users of the computer +* __System-wide autostart__: Place applications (or symlinks to applications) into the `/Applications/Autostart` folder to have them started for all users of the computer -* __Per-user autostart__: Place applications (or symlinks to applications) into the `~/Applications` folder (in your home folder) to have them started for all users of the computer. You can create the folder if it does not exist yet +* ~__Per-user autostart__: Place applications (or symlinks to applications) into the `~/Applications/Autostart` folder (in your home folder) to have them started for all users of the computer. You can create the folder if it does not exist yet~ The `launch` command is invoked for each of those applications and launches the applications. From 7bc3cc1d00c5534f658f4c2fb373537b65ceb49b Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 3 Oct 2022 15:11:57 +0200 Subject: [PATCH 474/592] Update ports.md --- developer/ports.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/developer/ports.md b/developer/ports.md index 26654862..5c8c95a1 100644 --- a/developer/ports.md +++ b/developer/ports.md @@ -21,10 +21,14 @@ Unfortunately one has to download/update the whole ports tree, containing all av ``` sudo portsnap fetch -sudo portsnap fetch update sudo portsnap extract + +# Or (if you already had it before) +sudo portsnap fetch update ``` +__Question:__ Can we use git for `/usr/ports` instead? + If you are running an end-of-life FreeBSD version such as 12.1, you also need to ``` From 7a8e90631a25488c04713d2bc1ebb74f8bc6ea09 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 17 Oct 2022 22:31:39 +0200 Subject: [PATCH 475/592] Add information from @sunweaver https://github.com/helloSystem/Menu/issues/101#issuecomment-1281363537 --- developer/menu.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/developer/menu.md b/developer/menu.md index 4325e8c6..fabf8f50 100644 --- a/developer/menu.md +++ b/developer/menu.md @@ -41,7 +41,7 @@ Those may or may not be used in helloSystem, they are mentioned here to give an * [__AyatanaIndicators__](https://ayatanaindicators.github.io/): "The Ayatana Indicators project is the continuation of Application Indicators, a technology developed by Canonical for the Unity desktop. Application Indicators are a GNOME implementation of the StatusNotifierItem Specification (SNI) that was originally submitted to freedesktop.org by KDE. The Ayatana Indicator project intends to become the new upstream for application indicators and associated projects with a focus on making Ayatana Indicators a desktop agnostic technology.". With Ubuntu now using GNOME rather than Unity, it is no longer developed by Canonical. UBports, MATE and XFCE are adopting AyatanaIndicators and Ubuntu are starting to migrate to it in 21.04. Some people say that StatusNotifierItems should be preferred since they are already more widely supported across the various desktops * [__Application Menu or appmenu__](https://wiki.ubuntu.com/DesktopExperienceTeam/ApplicationMenu): As part of Aytana, Canonical has produced an implementation called `indicator-appmenu` which re-routes Gtk and Qt menus over `dbusmenu` so that they appear in the panel * [__dbusmenu__](https://wiki.ubuntu.com/DesktopExperienceTeam/ApplicationIndicators#Software_Architecture): Library by Canonical implementing the transport protocol between the applications and the panel -* [__libappindicator__](https://wiki.ubuntu.com/DesktopExperienceTeam/ApplicationIndicators#Software_Architecture): Library by Canonical to register icons and menus and internally uses dbusmenu to publish context menus over dbus. Needed for some applications (e.g., screenkey) to show icons in the upper right hand corner of the menu (system tray/notification area). The same as [`indicator-application`](https://launchpad.net/indicator-application)? +* [__libappindicator__](https://wiki.ubuntu.com/DesktopExperienceTeam/ApplicationIndicators#Software_Architecture): Library by Canonical to register icons and menus and internally uses dbusmenu to publish context menus over dbus. Needed for some applications (e.g., screenkey) to show icons in the upper right hand corner of the menu (system tray/notification area). The same as [`indicator-application`](https://launchpad.net/indicator-application)? According to @sunweaver, libappindicator is unmaintained as of late 2022 and [libayatana-appindicator](https://github.com/AyatanaIndicators/libayatana-appindicator) is the current upstream * [__MenuModel__](): Used by Gtk * [__JAyatana__](): Supposedly allows for displaying global menus in Java Swing applications (such as Netbeans and the JetBrains suite of IDEs) * [__Airyx DBusKit__](https://github.com/mszoek/airyx/tree/main/DBusKit): Airyx DBusKit implements a subset of D-Bus needed to support sending menus of **AppKit** applications to the global menu bar @@ -106,7 +106,7 @@ tbd * Bugtracker: tbd * Purpose: tbd * Theory of operation: tbd -* Status: . "Unity" = Deprecated? +* Status: . "Unity" = Deprecated? According to @sunweaver, unity-gtk-module is (sort of) unmaintained as of late 2022 and [appmenu-gtk-module](https://gitlab.com/vala-panel-project/vala-panel-appmenu/-/tree/master/subprojects/appmenu-gtk-module) is a more active alternative * Issues: Not in ports? Is this an issue, preventing us from some applications to work properly? * Installed by package: Not in ports? (In Ubuntu, `sudo apt-get install unity-gtk-module-common unity-gtk2-module unity-gtk3-module`) From 9fea403b72d0beefa129eeb8b591e9e6ea1e4334 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 17 Oct 2022 22:33:21 +0200 Subject: [PATCH 476/592] GNUstep libs-dbuskit --- developer/menu.md | 1 + 1 file changed, 1 insertion(+) diff --git a/developer/menu.md b/developer/menu.md index fabf8f50..a7664128 100644 --- a/developer/menu.md +++ b/developer/menu.md @@ -45,6 +45,7 @@ Those may or may not be used in helloSystem, they are mentioned here to give an * [__MenuModel__](): Used by Gtk * [__JAyatana__](): Supposedly allows for displaying global menus in Java Swing applications (such as Netbeans and the JetBrains suite of IDEs) * [__Airyx DBusKit__](https://github.com/mszoek/airyx/tree/main/DBusKit): Airyx DBusKit implements a subset of D-Bus needed to support sending menus of **AppKit** applications to the global menu bar +* [__GNUstep libs-dbuskit__](https://github.com/gnustep/libs-dbuskit): The DBusKit framework provides GNUstep Objective-C applications with bindings for the D-Bus inter-process communication system ## Libraries involved From aa3e1ae2a34b492c38018e8cbd887c18842999c2 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 5 Nov 2022 20:22:36 +0100 Subject: [PATCH 477/592] Create linux.md --- developer/linux.md | 28 ++++++++++++++++++++++++++++ 1 file changed, 28 insertions(+) create mode 100644 developer/linux.md diff --git a/developer/linux.md b/developer/linux.md new file mode 100644 index 00000000..52699302 --- /dev/null +++ b/developer/linux.md @@ -0,0 +1,28 @@ +# Building on Linux + +helloSystem is designed for use with helloSystem, which is based on FreeBSD. + +However, developers may want to verify that the code is reasonably platform independent by building on Linux from time to time. +That the code build does not necessarily mean that it works properly on Linux or that all features are implemented for Linux. + +To verify that the code builds on Linux without needing a different development machine, one can use an Alpine Linux chroot in FreeBSD. + +``` +sudo service linux stop +sudo service debian stop +sudo service alpine start +sudo chroot /compat/alpine +``` + +In the chroot, execute + +``` +apk add --no-cache qt5-qtbase-dev kwindowsystem-dev git cmake alpine-sdk nano +git clone https://github.com/helloSystem/launch +cd launch/ +mkdir build +cd build +cmake .. +make -j $(nproc) +``` + From 5e4a99e5b924cbbbc6c7f6a32c1e9d41fddecb73 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 5 Nov 2022 20:23:46 +0100 Subject: [PATCH 478/592] Update linux.md --- developer/linux.md | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/developer/linux.md b/developer/linux.md index 52699302..7e6eba80 100644 --- a/developer/linux.md +++ b/developer/linux.md @@ -3,7 +3,10 @@ helloSystem is designed for use with helloSystem, which is based on FreeBSD. However, developers may want to verify that the code is reasonably platform independent by building on Linux from time to time. -That the code build does not necessarily mean that it works properly on Linux or that all features are implemented for Linux. + +``` .. note:: + That the code build does not necessarily mean that it works properly on Linux or that all features are implemented for Linux. +``` To verify that the code builds on Linux without needing a different development machine, one can use an Alpine Linux chroot in FreeBSD. From 263a11584847b3ced8ced187d9ca93908b0e096e Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 5 Nov 2022 20:36:24 +0100 Subject: [PATCH 479/592] Update linux.md --- developer/linux.md | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/developer/linux.md b/developer/linux.md index 7e6eba80..c29ab488 100644 --- a/developer/linux.md +++ b/developer/linux.md @@ -13,7 +13,7 @@ To verify that the code builds on Linux without needing a different development ``` sudo service linux stop sudo service debian stop -sudo service alpine start +sudo service alpine onestart sudo chroot /compat/alpine ``` @@ -29,3 +29,8 @@ cmake .. make -j $(nproc) ``` +After you are done, + +``` +sudo service alpine onestop +``` From d68a3005adc12b0180cb6c0dd612f48be8e43bbe Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 5 Nov 2022 20:42:10 +0100 Subject: [PATCH 480/592] Update linux.md --- developer/linux.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/developer/linux.md b/developer/linux.md index c29ab488..996ebef3 100644 --- a/developer/linux.md +++ b/developer/linux.md @@ -10,6 +10,9 @@ However, developers may want to verify that the code is reasonably platform inde To verify that the code builds on Linux without needing a different development machine, one can use an Alpine Linux chroot in FreeBSD. +Beginning with build 0H165, helloSystem ships with an [alpine rc.d script](https://github.com/helloSystem/ISO/blob/experimental/overlays/uzip/hello/files/usr/local/etc/rc.d/alpine). +When started for the first time, this downloads a minimal root filesystem. + ``` sudo service linux stop sudo service debian stop From 1c54b9a53b2db78ea411c3e11aef5b07cb5a1213 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 5 Nov 2022 20:42:47 +0100 Subject: [PATCH 481/592] Update linux.md --- developer/linux.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/developer/linux.md b/developer/linux.md index 996ebef3..198548d2 100644 --- a/developer/linux.md +++ b/developer/linux.md @@ -8,7 +8,7 @@ However, developers may want to verify that the code is reasonably platform inde That the code build does not necessarily mean that it works properly on Linux or that all features are implemented for Linux. ``` -To verify that the code builds on Linux without needing a different development machine, one can use an Alpine Linux chroot in FreeBSD. +To verify that the code builds on Linux without needing a different development machine, one can use an [Alpine Linux](https://alpinelinux.org/) chroot in FreeBSD. Beginning with build 0H165, helloSystem ships with an [alpine rc.d script](https://github.com/helloSystem/ISO/blob/experimental/overlays/uzip/hello/files/usr/local/etc/rc.d/alpine). When started for the first time, this downloads a minimal root filesystem. From 3c808b5549521ad468d4780978092bcafd0305b2 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 5 Nov 2022 20:43:47 +0100 Subject: [PATCH 482/592] Add Linux --- index.md | 1 + 1 file changed, 1 insertion(+) diff --git a/index.md b/index.md index bbbfe592..a493ef6e 100644 --- a/index.md +++ b/index.md @@ -55,6 +55,7 @@ __helloSystem__ is a desktop system for creators with a focus on simplicity, ele developer/ports developer/base developer/rpi + developer/linux developer/distributions developer/acknowledgements developer/contact From 9e20e94342eadb165fc9cab3bcd3ebbe042a27c8 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 5 Nov 2022 21:29:42 +0100 Subject: [PATCH 483/592] musl-dev --- developer/linux.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/developer/linux.md b/developer/linux.md index 198548d2..b79b21cf 100644 --- a/developer/linux.md +++ b/developer/linux.md @@ -23,7 +23,7 @@ sudo chroot /compat/alpine In the chroot, execute ``` -apk add --no-cache qt5-qtbase-dev kwindowsystem-dev git cmake alpine-sdk nano +apk add --no-cache qt5-qtbase-dev kwindowsystem-dev git cmake musl-dev alpine-sdk nano git clone https://github.com/helloSystem/launch cd launch/ mkdir build From 12a6ef9e5adccb37d53fdfdc4a5fd99b5eb830ab Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 5 Nov 2022 21:34:23 +0100 Subject: [PATCH 484/592] Update linux.md --- developer/linux.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/developer/linux.md b/developer/linux.md index b79b21cf..a224b10e 100644 --- a/developer/linux.md +++ b/developer/linux.md @@ -23,7 +23,7 @@ sudo chroot /compat/alpine In the chroot, execute ``` -apk add --no-cache qt5-qtbase-dev kwindowsystem-dev git cmake musl-dev alpine-sdk nano +apk add --no-cache qt5-qtbase-dev kwindowsystem-dev git cmake musl-dev alpine-sdk clang nano git clone https://github.com/helloSystem/launch cd launch/ mkdir build @@ -37,3 +37,7 @@ After you are done, ``` sudo service alpine onestop ``` + +``` .. note:: + If the compiler crashes, make sure that /usr/bin/clang++ is being used rather than /usr/bin/c++. This can be checked in CMakeCache.txt. +``` From 6cab853411350c18cc276c25694eb2dbce0d31d2 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 5 Nov 2022 22:21:34 +0100 Subject: [PATCH 485/592] Update linux.md --- developer/linux.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/developer/linux.md b/developer/linux.md index a224b10e..88058f76 100644 --- a/developer/linux.md +++ b/developer/linux.md @@ -17,7 +17,7 @@ When started for the first time, this downloads a minimal root filesystem. sudo service linux stop sudo service debian stop sudo service alpine onestart -sudo chroot /compat/alpine +sudo chroot /compat/alpine /bin/sh ``` In the chroot, execute From c1ff1487e8aff929949e9978eebcc073bf6ce602 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 6 Nov 2022 13:28:14 +0100 Subject: [PATCH 486/592] Use git for ports --- developer/ports.md | 12 ++---------- 1 file changed, 2 insertions(+), 10 deletions(-) diff --git a/developer/ports.md b/developer/ports.md index 5c8c95a1..0e64eb7a 100644 --- a/developer/ports.md +++ b/developer/ports.md @@ -15,20 +15,12 @@ https://github.com/lxqt/qtermwidget/blob/059d832086facb19035a07d975ea4fd05d36b1e Here is how to do it using FreeBSD Ports: -## Installing the ports tree - -Unfortunately one has to download/update the whole ports tree, containing all available ports, even if one just wants to make a change to one or a few of the ports. +## Pulling the ports tree ``` -sudo portsnap fetch -sudo portsnap extract - -# Or (if you already had it before) -sudo portsnap fetch update +sudo git clone https://git.freebsd.org/ports.git /usr/ports --depth=1 ``` -__Question:__ Can we use git for `/usr/ports` instead? - If you are running an end-of-life FreeBSD version such as 12.1, you also need to ``` From ec0112db7be8bf2383ba5b5e162e92444c650755 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 6 Nov 2022 18:41:25 +0100 Subject: [PATCH 487/592] Update base.md --- developer/base.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/developer/base.md b/developer/base.md index f94ae395..e2e8b8b2 100644 --- a/developer/base.md +++ b/developer/base.md @@ -43,7 +43,7 @@ Now make changes to the command line tool. cd /usr/src/usr.sbin/efivar/ rm efivar.c # From https://reviews.freebsd.org/D29620 -wget "https://reviews.freebsd.org/file/data/qquakxqeqeeepcbml5cy/PHID-FILE-ryp4c3imjqswnsjqiip3/usr.sbin_efivar_efivar.c" -O efivar.c +wget "https://reviews.freebsd.org/file/data/yytb47lr5cxaijaaupeh/PHID-FILE-gihl33z7feu4dagjxjgz/usr.sbin_efivar_efivar.c" -O efivar.c make /usr/obj/usr/src/amd64.amd64/usr.sbin/efivar/efivar ``` From 33e3155f53c50bf37166afe102b416d2ed2f94d1 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 7 Nov 2022 22:21:59 +0100 Subject: [PATCH 488/592] More complete instructions for Alpine Linux --- developer/linux.md | 57 ++++++++++++++++++++++++++++++++++++++++------ 1 file changed, 50 insertions(+), 7 deletions(-) diff --git a/developer/linux.md b/developer/linux.md index 88058f76..37eff803 100644 --- a/developer/linux.md +++ b/developer/linux.md @@ -8,6 +8,8 @@ However, developers may want to verify that the code is reasonably platform inde That the code build does not necessarily mean that it works properly on Linux or that all features are implemented for Linux. ``` +## Building in a chroot on a FreeBSD host + To verify that the code builds on Linux without needing a different development machine, one can use an [Alpine Linux](https://alpinelinux.org/) chroot in FreeBSD. Beginning with build 0H165, helloSystem ships with an [alpine rc.d script](https://github.com/helloSystem/ISO/blob/experimental/overlays/uzip/hello/files/usr/local/etc/rc.d/alpine). @@ -20,16 +22,40 @@ sudo service alpine onestart sudo chroot /compat/alpine /bin/sh ``` -In the chroot, execute +In the chroot, build the essential helloSystem components ``` -apk add --no-cache qt5-qtbase-dev kwindowsystem-dev git cmake musl-dev alpine-sdk clang nano +# launch, open, and other essential command line tools that are required git clone https://github.com/helloSystem/launch -cd launch/ -mkdir build -cd build +apk add qt5-qtbase-dev kwindowsystem-dev git cmake musl-dev alpine-sdk clang nano +mkdir -p launch/build +cd launch/build +cmake .. +sudo make -j $(nproc) install +cd ../../ + +# Menu +git clone https://github.com/helloSystem/Menu +sudo pkg install -y cmake pkgconf qt5-x11extras qt5-qmake qt5-widgets \ +qt5-buildtools kf5-kdbusaddons kf5-kwindowsystem kf5-baloo libdbusmenu-qt5 \ +qt5-concurrent qt5-qtmultimedia-dev libfm-extra-dev menu-cache-dev +mkdir -p Menu/build +cd Menu/build cmake .. -make -j $(nproc) +sudo make -j $(nproc) install +cd ../../ + +# Filer +git clone https://github.com/helloSystem/Filer +apk add apk add qt5-qtbase-dev kwindowsystem-dev qt5-qttools-dev \ +qt5-qtmultimedia-dev libfm-dev menu-cache-dev libfm-extra-dev \ +kdbusaddons-dev baloo-dev xcb-util-wm-dev libdbusmenu-qt-dev git cmake musl-dev \ + +mkdir -p Filer/build +cd Filer/build +cmake .. +sudo make -j $(nproc) install +cd ../../ ``` After you are done, @@ -39,5 +65,22 @@ sudo service alpine onestop ``` ``` .. note:: - If the compiler crashes, make sure that /usr/bin/clang++ is being used rather than /usr/bin/c++. This can be checked in CMakeCache.txt. + If the compiler crashes, make sure that /usr/bin/clang++ is being used rather than /usr/bin/c++. This can be edited in CMakeCache.txt. +``` + +## Running helloDesktop on Linux + +The three core components of helloDesktop are launch, Menu, and Filer. + +Build and `make install` them as above. + +Then log into a KDE Plasma session on Alpine Linux. From the running KDE Plasma session, you can switch to helloDesktop using + +``` +#!/bin/sh + +launch Menu & +sleep 1 +launch Filer & +killall plasmashell ``` From 9caca48e1bf6e3ac71f716b66857275ddbaa6f4b Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 7 Nov 2022 22:42:14 +0100 Subject: [PATCH 489/592] Update linux.md --- developer/linux.md | 19 ++++++++++++++----- 1 file changed, 14 insertions(+), 5 deletions(-) diff --git a/developer/linux.md b/developer/linux.md index 37eff803..c12baaa6 100644 --- a/developer/linux.md +++ b/developer/linux.md @@ -70,11 +70,18 @@ sudo service alpine onestop ## Running helloDesktop on Linux -The three core components of helloDesktop are launch, Menu, and Filer. - -Build and `make install` them as above. - -Then log into a KDE Plasma session on Alpine Linux. From the running KDE Plasma session, you can switch to helloDesktop using +Run Alpine Linux, e.g., in VirtualBox on helloSystem, or on real hardware. + +* Download ISO from https://alpinelinux.org/downloads/, "Standard" +* User `root`, no password is the default +* Install to to a hard disk using the `setup-alpine` command, need to use a classic ("sys mode") installation +* Enable community repo by `sed -i -e 's|^#||g' /etc/apk/repositories` +* Install KDE Plasma using `setup-desktop`; set up a user +* `rc-update add sddm` and `rc-service sddm start` +* Log into a KDE Plasma session on Alpine Linux. __Important:__ Select X11 session. Wayland doesn't work smoothly +* Optionally, install VirtualBox related guest packages using `apk search` and `apk add` +* Build and `make install` the three core components of helloDesktop (launch, Menu, and Filer) as above +* From within the running KDE Plasma session, you can switch to the minimal helloDesktop with ``` #!/bin/sh @@ -84,3 +91,5 @@ sleep 1 launch Filer & killall plasmashell ``` + +Menu shoud work including full text search in the filesystem. From 21ae6b1b24a0a7f167cc96a7b45c9b0c2ee34d88 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 7 Nov 2022 22:46:53 +0100 Subject: [PATCH 490/592] Update linux.md --- developer/linux.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/developer/linux.md b/developer/linux.md index c12baaa6..ea935321 100644 --- a/developer/linux.md +++ b/developer/linux.md @@ -80,6 +80,7 @@ Run Alpine Linux, e.g., in VirtualBox on helloSystem, or on real hardware. * `rc-update add sddm` and `rc-service sddm start` * Log into a KDE Plasma session on Alpine Linux. __Important:__ Select X11 session. Wayland doesn't work smoothly * Optionally, install VirtualBox related guest packages using `apk search` and `apk add` +* `sudo su` to become root (there is no `sudo` configured on Alpine Linux by default) * Build and `make install` the three core components of helloDesktop (launch, Menu, and Filer) as above * From within the running KDE Plasma session, you can switch to the minimal helloDesktop with @@ -93,3 +94,11 @@ killall plasmashell ``` Menu shoud work including full text search in the filesystem. + +The result will look somewhat like this: + +![Screenshot](https://user-images.githubusercontent.com/2480569/200421869-96f81c37-0785-4416-ae43-bee920dd6a3e.png) + +``` .. note:: + That the code runs does not necessarily mean that it works properly on Linux or that all features are implemented for Linux. Please keep in mind that for the best desktop experience, you should be using helloSystem which helloDesktop has been designed for. +``` From 4bde43ae33ff2e86ce4bc701214058e116ea0090 Mon Sep 17 00:00:00 2001 From: probonopd Date: Tue, 8 Nov 2022 18:58:28 +0100 Subject: [PATCH 491/592] Update linux.md --- developer/linux.md | 11 +++-------- 1 file changed, 3 insertions(+), 8 deletions(-) diff --git a/developer/linux.md b/developer/linux.md index ea935321..d857501c 100644 --- a/developer/linux.md +++ b/developer/linux.md @@ -27,32 +27,27 @@ In the chroot, build the essential helloSystem components ``` # launch, open, and other essential command line tools that are required git clone https://github.com/helloSystem/launch -apk add qt5-qtbase-dev kwindowsystem-dev git cmake musl-dev alpine-sdk clang nano mkdir -p launch/build cd launch/build +grep ^apk ../README.md | sh cmake .. sudo make -j $(nproc) install cd ../../ # Menu git clone https://github.com/helloSystem/Menu -sudo pkg install -y cmake pkgconf qt5-x11extras qt5-qmake qt5-widgets \ -qt5-buildtools kf5-kdbusaddons kf5-kwindowsystem kf5-baloo libdbusmenu-qt5 \ -qt5-concurrent qt5-qtmultimedia-dev libfm-extra-dev menu-cache-dev mkdir -p Menu/build cd Menu/build +grep ^apk ../README.md | sh cmake .. sudo make -j $(nproc) install cd ../../ # Filer git clone https://github.com/helloSystem/Filer -apk add apk add qt5-qtbase-dev kwindowsystem-dev qt5-qttools-dev \ -qt5-qtmultimedia-dev libfm-dev menu-cache-dev libfm-extra-dev \ -kdbusaddons-dev baloo-dev xcb-util-wm-dev libdbusmenu-qt-dev git cmake musl-dev \ - mkdir -p Filer/build cd Filer/build +grep ^apk ../README.md | sh cmake .. sudo make -j $(nproc) install cd ../../ From 04ac55362b23ff1f94fdbc7a7b54a198e8feeb5c Mon Sep 17 00:00:00 2001 From: probonopd Date: Tue, 8 Nov 2022 19:13:46 +0100 Subject: [PATCH 492/592] make makeplist > pkg-plist --- developer/ports.md | 12 ++++++++---- 1 file changed, 8 insertions(+), 4 deletions(-) diff --git a/developer/ports.md b/developer/ports.md index 0e64eb7a..24a495a8 100644 --- a/developer/ports.md +++ b/developer/ports.md @@ -176,10 +176,6 @@ USE_GITHUB= yes GH_ACCOUNT= davidgiven GH_TAGNAME= 61ff48c -PLIST_FILES= bin/brother120tool \ - bin/brother240tool \ - bin/fluxengine - do-install: ${INSTALL_PROGRAM} ${WRKSRC}/brother120tool ${STAGEDIR}${PREFIX}/bin/ ${INSTALL_PROGRAM} ${WRKSRC}/brother240tool ${STAGEDIR}${PREFIX}/bin/ @@ -188,6 +184,14 @@ do-install: .include ``` +Run + +``` +make makeplist > pkg-plist +``` + +to create that file. Check and edit it by hand, especially the first line. + Notes * See `ls /usr/ports/` for possible categories, such as `sysutils` * See [5.2. Naming](https://docs.freebsd.org/en/books/porters-handbook/makefile-naming.html) for naming and versioning conventions From 70178f2762f1ac44af324f98a1835b0bb8d46ce4 Mon Sep 17 00:00:00 2001 From: probonopd Date: Tue, 8 Nov 2022 19:15:11 +0100 Subject: [PATCH 493/592] porters-handbook/order --- developer/ports.md | 8 ++------ 1 file changed, 2 insertions(+), 6 deletions(-) diff --git a/developer/ports.md b/developer/ports.md index 24a495a8..191d2622 100644 --- a/developer/ports.md +++ b/developer/ports.md @@ -136,12 +136,8 @@ First, prepare the Ports environment: ``` sudo su -export ALLOW_UNSUPPORTED_SYSTEM=YES -# or on csh -setenv ALLOW_UNSUPPORTED_SYSTEM YES -pkg install portlint subversion +pkg install portlint echo DEVELOPER=yes >> /etc/make.conf -portsnap fetch extract update # Run this from time to time ``` Next, create a directory for the new port: @@ -195,7 +191,7 @@ to create that file. Check and edit it by hand, especially the first line. Notes * See `ls /usr/ports/` for possible categories, such as `sysutils` * See [5.2. Naming](https://docs.freebsd.org/en/books/porters-handbook/makefile-naming.html) for naming and versioning conventions -* The lines must be in a defined order. Run `portlint` to get information on this and re-order until it no longer complains +* The lines must be in a defined order. Run `portlint` to get information on this. When `portlint` complains about `appears out-of-order`, the blocks and lines in the `Makefile` need to be reshuffled to match the order described at [https://docs.freebsd.org/en/books/porters-handbook/order/](https://docs.freebsd.org/en/books/porters-handbook/order/). * Run `make stage-qa` to find out dependencies. Using something like `make stage-qa 2>&1 | grep "you need" | sort | uniq | cut -d " " -f 4` can speed this up * The `do-install` section is needed in this example because there is no `make install` in the original software's Makefile From 56cff781ab6f93bfc28f718aaafd1368d585a75e Mon Sep 17 00:00:00 2001 From: probonopd Date: Tue, 8 Nov 2022 19:46:14 +0100 Subject: [PATCH 494/592] Update linux.md --- developer/linux.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/developer/linux.md b/developer/linux.md index d857501c..e3b42315 100644 --- a/developer/linux.md +++ b/developer/linux.md @@ -97,3 +97,15 @@ The result will look somewhat like this: ``` .. note:: That the code runs does not necessarily mean that it works properly on Linux or that all features are implemented for Linux. Please keep in mind that for the best desktop experience, you should be using helloSystem which helloDesktop has been designed for. ``` + +## Building and running helloDesktop on Raspberry Pi + +Loosely follow https://wiki.alpinelinux.org/wiki/Classic_install_or_sys_mode_on_Raspberry_Pi (not all commands seem to be working exactly as written anymore), but also create "Linux Swap" partition. Alternatively, in the running Alpine Linux system + +``` +fallocate -l 8G /swapfile +mkswap /swapfile +swapon /swapfile +``` + +to have enough RAM or else the compilation will be killed (at least on the 1GB and less RAM models). From 61d5d9939a30ae946f76352e75394d596c5ca4de Mon Sep 17 00:00:00 2001 From: probonopd Date: Wed, 9 Nov 2022 19:30:48 +0100 Subject: [PATCH 495/592] Speed up boot --- developer/boot.md | 58 ++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 57 insertions(+), 1 deletion(-) diff --git a/developer/boot.md b/developer/boot.md index 0ab79384..4798d0a4 100644 --- a/developer/boot.md +++ b/developer/boot.md @@ -1,11 +1,67 @@ # Boot process +## Speeding up the boot process + +As a desktop-centric system, helloSystem should bring up a graphical desktop as soon as possible, and delay starting up other services such as the network beyond that point. Unfortunately, in the FreeBSD default configuration this is the other way around, and the graphical desktop will only start after the network has been configured, the time has been set using NTP, etc. + +While it would be possible to change the order of the scripts in `/etc/rc.d` and `/usr/local/etc/rc.d`, those changes might get overwritten with subsequent FreeBSD or package updates. Hence, we should never edit startup scripts provided by FreeBSD or packages. + +Instead, we can disable the services in question so that they don't get started as part of the normal FreeBSD boot sequence, and start them later in the boot process (after the graphical session has been started) using a custom start script. + ``` .. note:: - This page describes helloSystem boot process up to 0.6.0. Starting with version 0.7.0, helloSystem will use a completely different live system boot process. This page needs to be updated accordingly. + The following instructions are DANGEROUS and can potentially lead to a system that cannot boot into a graphical desktop if things go wrong. This is currently only for developers and experienced users who know how to handle such situations. Future versions of helloSystem may come with this already set up. ``` +To do this, create a Boot Environment that you can roll back to in case things go wrong. + +Then create the following `/usr/local/etc/rc.d/late-start` script: + +``` +#!/bin/sh + +# PROVIDE: late-start +# REQUIRE: slim + +PATH=$PATH:/usr/sbin +export PATH + +. /etc/rc.subr + +name="late" +start_cmd="${name}_start" + +# NOTE: devd needs to stay enabled in early boot +# so that we have a working mouse pointer as soon as Xorg is started + +SERVICES="setup-mouse webcamd vboxservice dsbdriverd netif routing defaultroute avahi-daemon clear-tmp cupsd ntpdate smartd sshd" + +late_start() +{ + service devd restart # For networking; invokes dhcpd + for SERVICE in {$SERVICES} ; do + service "${SERVICE}" onestart + done +} + +load_rc_config $name +run_rc_command "$1" +``` + +Disable the services in question with + +``` +SERVICES="setup-mouse webcamd vboxservice dsbdriverd netif routing defaultroute avahi-daemon clear-tmp cupsd ntpdate smartd sshd" +for SERVICE in {$SERVICES} ; do service "${SERVICE}" disable ; done +``` + +Reboot. + ## Live system early boot process +``` .. note:: + This section describes helloSystem boot process up to 0.6.0. Starting with version 0.7.0, helloSystem will use a completely different live system boot process. This page needs to be updated accordingly. +``` + The ISO contains a compressed Live system filesystem image in uzip format. This filesystem image contains the filesystem used when running the ISO. During the Live system boot process, the image needs to get mounted and needs to get turned into a read-write filesystem so that one can make changes to the running system. FreeBSD does not have a standard way to achieve this, so custom code has to be used. (The ISOs provided by the FreeBSD project do not use a compressed Live system filesystem image, and do not result in a read-write filesystem when being booted.) From 37025590883d779eaa1842a8c97e7c0ed5438020 Mon Sep 17 00:00:00 2001 From: probonopd Date: Wed, 9 Nov 2022 19:56:20 +0100 Subject: [PATCH 496/592] Update boot.md --- developer/boot.md | 19 +++++++++++++++++-- 1 file changed, 17 insertions(+), 2 deletions(-) diff --git a/developer/boot.md b/developer/boot.md index 4798d0a4..0705bef1 100644 --- a/developer/boot.md +++ b/developer/boot.md @@ -14,6 +14,12 @@ Instead, we can disable the services in question so that they don't get started To do this, create a Boot Environment that you can roll back to in case things go wrong. +In `/etc/rc.conf`, set +``` +defaultroute_carrier_delay="0" +defaultroute_delay="0" +``` + Then create the following `/usr/local/etc/rc.d/late-start` script: ``` @@ -30,6 +36,9 @@ export PATH name="late" start_cmd="${name}_start" +extra_commands="disable_early_services" +disable_early_services_cmd="${name}_disable_early_services" + # NOTE: devd needs to stay enabled in early boot # so that we have a working mouse pointer as soon as Xorg is started @@ -43,6 +52,13 @@ late_start() done } +late_disable_early_services() +{ + for SERVICE in {$SERVICES} ; do + service "${SERVICE}" disable + done +} + load_rc_config $name run_rc_command "$1" ``` @@ -50,8 +66,7 @@ run_rc_command "$1" Disable the services in question with ``` -SERVICES="setup-mouse webcamd vboxservice dsbdriverd netif routing defaultroute avahi-daemon clear-tmp cupsd ntpdate smartd sshd" -for SERVICE in {$SERVICES} ; do service "${SERVICE}" disable ; done +sudo service late-start disable_early_services ``` Reboot. From 25a47463040ceaaf98501c4995f4a947d2739e73 Mon Sep 17 00:00:00 2001 From: probonopd Date: Wed, 9 Nov 2022 20:03:58 +0100 Subject: [PATCH 497/592] Update boot.md --- developer/boot.md | 1 + 1 file changed, 1 insertion(+) diff --git a/developer/boot.md b/developer/boot.md index 0705bef1..0e53a67e 100644 --- a/developer/boot.md +++ b/developer/boot.md @@ -18,6 +18,7 @@ In `/etc/rc.conf`, set ``` defaultroute_carrier_delay="0" defaultroute_delay="0" +background_dhclient="YES" ``` Then create the following `/usr/local/etc/rc.d/late-start` script: From fdb136cb75e57bce04d9b2955f9d43444134d49b Mon Sep 17 00:00:00 2001 From: probonopd Date: Wed, 9 Nov 2022 20:05:14 +0100 Subject: [PATCH 498/592] Update boot.md --- developer/boot.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/developer/boot.md b/developer/boot.md index 0e53a67e..919f36f1 100644 --- a/developer/boot.md +++ b/developer/boot.md @@ -70,6 +70,19 @@ Disable the services in question with sudo service late-start disable_early_services ``` +Check which services are still enabled, should now be treatly reduced: + +``` +% grep -r 'enable="YES"' /etc/rc.conf* +/etc/rc.conf:autofs_enable="YES" +/etc/rc.conf:clear_tmp_enable="YES" +/etc/rc.conf:dbus_enable="YES" +/etc/rc.conf:initgfx_enable="YES" +/etc/rc.conf:load_acpi_enable="YES" +/etc/rc.conf:slim_enable="YES" +/etc/rc.conf:zfs_enable="YES" +``` + Reboot. ## Live system early boot process From 21fae234bb6921b47e1df6486975c547845eb0cc Mon Sep 17 00:00:00 2001 From: probonopd Date: Wed, 9 Nov 2022 20:06:34 +0100 Subject: [PATCH 499/592] Update boot.md --- developer/boot.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/developer/boot.md b/developer/boot.md index 919f36f1..a53c1eab 100644 --- a/developer/boot.md +++ b/developer/boot.md @@ -83,7 +83,7 @@ Check which services are still enabled, should now be treatly reduced: /etc/rc.conf:zfs_enable="YES" ``` -Reboot. +Reboot. The graphical desktop (including a usable mouse pointer) should appear ~10 seconds faster, but the network will start to work only after ~10 seconds. ## Live system early boot process From 651e367dc443257329d2463e69df59f891fe2f78 Mon Sep 17 00:00:00 2001 From: probonopd Date: Wed, 9 Nov 2022 16:47:27 -0500 Subject: [PATCH 500/592] Update boot.md --- developer/boot.md | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/developer/boot.md b/developer/boot.md index a53c1eab..d3c12e23 100644 --- a/developer/boot.md +++ b/developer/boot.md @@ -48,25 +48,27 @@ SERVICES="setup-mouse webcamd vboxservice dsbdriverd netif routing defaultroute late_start() { service devd restart # For networking; invokes dhcpd - for SERVICE in {$SERVICES} ; do - service "${SERVICE}" onestart + for SERVICE in $SERVICES ; do + service "$SERVICE" onestart done } late_disable_early_services() { - for SERVICE in {$SERVICES} ; do - service "${SERVICE}" disable + for SERVICE in $SERVICES ; do + service "$SERVICE" disable done } load_rc_config $name run_rc_command "$1" + ``` Disable the services in question with ``` +sudo chmod +x /usr/local/etc/rc.d/late-start sudo service late-start disable_early_services ``` From 578592cd6934a657f0b561d2c32ce12aa1119e5e Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 13 Nov 2022 14:58:42 +0100 Subject: [PATCH 501/592] x11/qterminal example --- developer/ports.md | 39 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 39 insertions(+) diff --git a/developer/ports.md b/developer/ports.md index 191d2622..def32ab1 100644 --- a/developer/ports.md +++ b/developer/ports.md @@ -258,3 +258,42 @@ rm -rf work/ cd .. tar cf fluxengine.shar --format shar fluxengine ``` + +## Updating existing ports + +This real-life example shows how to update a port, e.g., `x11/qterminal`. + +``` +sudo su +cd /usr/ports +git pull +cd x11/qterminal +``` + +Change `PORTVERSION= 1.2.0` to `PORTVERSION= 1.2.0`. Turns out that one has to update `x11-toolkits/qtermwidget` and `devel/lxqt-build-tools` too for it to compile. + +``` +portlint # Fix errors, if any +rm pkg-plist +make clean +make package reinstall +make makeplist > pkg-plist +nano pkg-plist # Remove first line and check the others +make clean +make package reinstall +``` + +Finally, once everything is tested, create separate patches for each port with +``` +cd /usr/ports +git diff -U999999 x11/qterminal > /home/user/Desktop/x11_qterminal.diff +git diff -U999999 devel/lxqt-build-tools > /home/user/Desktop/devel_lxqt-build-tools.diff +git diff -U999999 x11-toolkits/qtermwidget > /home/user/Desktop/x11-toolkits_qtermwidget.diff +``` + +Go to https://reviews.freebsd.org/differential/, click "Create Diff", can log in using GitHub credentials, subject `devel/lxqt-build-tools: Update to 0.12.0`, under "Reviewers" add the maintainer. + +Result: +* https://reviews.freebsd.org/D37378 +* https://reviews.freebsd.org/D37379 +* https://reviews.freebsd.org/D37380 From f60f2e48d08889ae935ebe648e1e9ced542139c5 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 13 Nov 2022 15:01:34 +0100 Subject: [PATCH 502/592] man [ci skip] --- developer/man.md | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) create mode 100644 developer/man.md diff --git a/developer/man.md b/developer/man.md new file mode 100644 index 00000000..60c91cc7 --- /dev/null +++ b/developer/man.md @@ -0,0 +1,19 @@ +# Writing man pages + +Command line tools should be shipped with man pages. + +One way to create man pages from Markdown is by using `pandoc` +and the template from https://github.com/pragmaticlinuxblog/pandocmanpage. + +To convert Markdown to man: + +``` +pandoc Desktop/launch.1.md -s -t man -o Desktop/launch.1 +/usr/bin/man ~/Desktop/launch.1 +``` + +To convert man to txt: + +``` +/usr/bin/man ~/Desktop/launch.1 | col -b > ~/Desktop/launch.txt +``` From 02a8e9868a7a8d5fc8862b57973889d727474fe5 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 13 Nov 2022 15:02:01 +0100 Subject: [PATCH 503/592] Add secion on man pages --- index.md | 1 + 1 file changed, 1 insertion(+) diff --git a/index.md b/index.md index a493ef6e..6edc8b2f 100644 --- a/index.md +++ b/index.md @@ -54,6 +54,7 @@ __helloSystem__ is a desktop system for creators with a focus on simplicity, ele developer/localization developer/ports developer/base + developer/man developer/rpi developer/linux developer/distributions From abbfc687d326e34c4ea13c34ff00a3fcf4d36b66 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 13 Nov 2022 15:06:43 +0100 Subject: [PATCH 504/592] Update ports.md --- developer/ports.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/developer/ports.md b/developer/ports.md index def32ab1..84d183d2 100644 --- a/developer/ports.md +++ b/developer/ports.md @@ -270,7 +270,7 @@ git pull cd x11/qterminal ``` -Change `PORTVERSION= 1.2.0` to `PORTVERSION= 1.2.0`. Turns out that one has to update `x11-toolkits/qtermwidget` and `devel/lxqt-build-tools` too for it to compile. +Change `PORTVERSION= 1.1.0` to `PORTVERSION= 1.2.0`. Turns out that one has to update `x11-toolkits/qtermwidget` and `devel/lxqt-build-tools` too for it to compile. ``` portlint # Fix errors, if any From 303ca984e2cc49c5db723ffc6817779801b42f84 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 13 Nov 2022 16:34:05 +0100 Subject: [PATCH 505/592] Update man.md --- developer/man.md | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) diff --git a/developer/man.md b/developer/man.md index 60c91cc7..9fab2335 100644 --- a/developer/man.md +++ b/developer/man.md @@ -17,3 +17,26 @@ To convert man to txt: ``` /usr/bin/man ~/Desktop/launch.1 | col -b > ~/Desktop/launch.txt ``` + +## Order of sections + +* `PROGNAME section` +* `NAME` +* `LIBRARY` +* `SYNOPSIS` +* `DESCRIPTION` +* `IMPLEMENTATION NOTES` +* `RETURN VALUES` +* `ENVIRONMENT` +* `FILES` +* `EXIT STATUS` +* `EXAMPLES` +* `DIAGNOSTICS` +* `ERRORS` +* `SEE ALSO` +* `STANDARDS` +* `HISTORY` +* `AUTHORS` +* `CAVEATS` +* `BUGS` +* `SECURITY CONSIDERATIONS` From 3ae29dbbde5d51f6fe4c8c60876a499e264014d5 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 13 Nov 2022 16:39:21 +0100 Subject: [PATCH 506/592] Update man.md --- developer/man.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/developer/man.md b/developer/man.md index 9fab2335..dad8fe62 100644 --- a/developer/man.md +++ b/developer/man.md @@ -2,6 +2,12 @@ Command line tools should be shipped with man pages. +``` .. note:: + To make fullest use of all features, man pages should be written in their native markup language. + + However, this has a quite steep learning curve, so the following can be used to get started quickly. +``` + One way to create man pages from Markdown is by using `pandoc` and the template from https://github.com/pragmaticlinuxblog/pandocmanpage. @@ -25,6 +31,7 @@ To convert man to txt: * `LIBRARY` * `SYNOPSIS` * `DESCRIPTION` +* `ARGUMENTS` * `IMPLEMENTATION NOTES` * `RETURN VALUES` * `ENVIRONMENT` From 824df69123eb8806e56db80fabbddb64f60f9c6f Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 13 Nov 2022 16:42:47 +0100 Subject: [PATCH 507/592] mdoc --- developer/man.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/developer/man.md b/developer/man.md index dad8fe62..737fff5b 100644 --- a/developer/man.md +++ b/developer/man.md @@ -3,7 +3,7 @@ Command line tools should be shipped with man pages. ``` .. note:: - To make fullest use of all features, man pages should be written in their native markup language. + To make fullest use of all features, man pages should be written in their native markup language, mdoc. However, this has a quite steep learning curve, so the following can be used to get started quickly. ``` @@ -26,12 +26,14 @@ To convert man to txt: ## Order of sections +For more information, see [`man mdoc`](https://www.freebsd.org/cgi/man.cgi?mdoc). + * `PROGNAME section` * `NAME` * `LIBRARY` * `SYNOPSIS` * `DESCRIPTION` -* `ARGUMENTS` +* `CONTEXT` * `IMPLEMENTATION NOTES` * `RETURN VALUES` * `ENVIRONMENT` From adff46ef225ddeb17c400c45ad0860ffc3e82d5c Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 19 Nov 2022 23:53:43 +0100 Subject: [PATCH 508/592] Remove gvfs --- user/components/utilities/update.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/user/components/utilities/update.md b/user/components/utilities/update.md index f4048b53..5d5e429b 100644 --- a/user/components/utilities/update.md +++ b/user/components/utilities/update.md @@ -19,7 +19,7 @@ This utility Please follow this exact procedure when testing the Update utility: * Install a helloSystem 0.7.0 pre-release build to hard disk. -* Open QTerminal and run `sudo pkg lock --yes automount slim gvfs dejavu liberation-fonts-ttf`. This step is __important__ because otherwise the update will overwrite carefully crafted helloSystem customizations. (There may be more packages that need to be locked as well.) +* Open QTerminal and run `sudo pkg lock --yes automount slim dejavu liberation-fonts-ttf`. This step is __important__ because otherwise the update will overwrite carefully crafted helloSystem customizations. (There may be more packages that need to be locked as well.) * Run the __Update__ utility and follow the on-screen instructions. * Once the update has completed, restart your computer to make full use of the updated software. * Run the __Boot Environments__ preferences application and check that there is a boot environment that you can switch back to in the case you are not satisfied with the updated system. From 6082ef00ac0bb40483359ba87baeeffe0add2450 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 20 Nov 2022 15:43:11 +0100 Subject: [PATCH 509/592] Update application-bundles.md --- developer/application-bundles.md | 1 + 1 file changed, 1 insertion(+) diff --git a/developer/application-bundles.md b/developer/application-bundles.md index d074f795..20a7db56 100644 --- a/developer/application-bundles.md +++ b/developer/application-bundles.md @@ -27,6 +27,7 @@ Minimal requirements: ./Application.app ./Application.app/Application <-- (link to) the executable to be launched when Application.app is double clicked ./Application.app/Resources/Application.png <-- the application icon (png format) +./Application.app/Resources/can-open <-- optional, MIME types the application can open, separated by `;` ``` In order to realize the full intended functionality, additional metadata may be required (such as localized application name, version, supported file formats, etc.). Possibly the GNUstep metadata format is sufficient for this. From 9a0656b126aecb41b35f019651f703d830fd1185 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 20 Nov 2022 16:26:17 +0100 Subject: [PATCH 510/592] Update boot.md --- developer/boot.md | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) diff --git a/developer/boot.md b/developer/boot.md index d3c12e23..47d3156d 100644 --- a/developer/boot.md +++ b/developer/boot.md @@ -87,6 +87,29 @@ Check which services are still enabled, should now be treatly reduced: Reboot. The graphical desktop (including a usable mouse pointer) should appear ~10 seconds faster, but the network will start to work only after ~10 seconds. +## Debugging the live system boot process + +Press the Backspace key on your keyboard during early boot until you see the `OK` prompt. + +![bootloader](https://user-images.githubusercontent.com/2480569/202910570-9bcc21c5-d9f4-4c3f-b8c0-b07b7e36f35e.png) + +Enter + +``` +unset boot_mute +boot -s +``` + +to boot in single user mode. The system will boot to the first stage Live system prompt: + +![livefirstsingleprompt](https://user-images.githubusercontent.com/2480569/202910574-22c0e284-8717-4ae0-9489-68cc23995e1d.png) + +Enter `exit` to contine. The system will boot to the second stage Live system prompt: + +![livesecondsingleprompt](https://user-images.githubusercontent.com/2480569/202910576-e4253133-8544-4566-8b8e-8c0895f63edd.png) + +Hit the Enter key on your keyboard, then enter `exit` to contine. The system will boot into the graphical desktop. + ## Live system early boot process ``` .. note:: From 2db687d5463da028423548f65303063eb5563087 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 20 Nov 2022 16:39:24 +0100 Subject: [PATCH 511/592] Update boot.md --- developer/boot.md | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/developer/boot.md b/developer/boot.md index 47d3156d..193294c9 100644 --- a/developer/boot.md +++ b/developer/boot.md @@ -87,7 +87,9 @@ Check which services are still enabled, should now be treatly reduced: Reboot. The graphical desktop (including a usable mouse pointer) should appear ~10 seconds faster, but the network will start to work only after ~10 seconds. -## Debugging the live system boot process +## Debugging the Live system boot process + +The following has been tested on experimental helloSystem 0.8.0 builds. Press the Backspace key on your keyboard during early boot until you see the `OK` prompt. @@ -104,10 +106,13 @@ to boot in single user mode. The system will boot to the first stage Live system ![livefirstsingleprompt](https://user-images.githubusercontent.com/2480569/202910574-22c0e284-8717-4ae0-9489-68cc23995e1d.png) +At this point, the Live system has not been made writable yet. Enter `exit` to contine. The system will boot to the second stage Live system prompt: ![livesecondsingleprompt](https://user-images.githubusercontent.com/2480569/202910576-e4253133-8544-4566-8b8e-8c0895f63edd.png) +At this point, the system has been made partly writable by the `init_script`. To see the messages, you can press the ScrLk key on your keyboard and then use the arrow up and arrow down keys on your keyboard. Then press the ScrLk key again. + Hit the Enter key on your keyboard, then enter `exit` to contine. The system will boot into the graphical desktop. ## Live system early boot process From d5a29e45ffcba436b640e529da4267213b70595f Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 20 Nov 2022 16:43:21 +0100 Subject: [PATCH 512/592] Update boot.md --- developer/boot.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/developer/boot.md b/developer/boot.md index 193294c9..70bf3aad 100644 --- a/developer/boot.md +++ b/developer/boot.md @@ -113,7 +113,11 @@ Enter `exit` to contine. The system will boot to the second stage Live system pr At this point, the system has been made partly writable by the `init_script`. To see the messages, you can press the ScrLk key on your keyboard and then use the arrow up and arrow down keys on your keyboard. Then press the ScrLk key again. -Hit the Enter key on your keyboard, then enter `exit` to contine. The system will boot into the graphical desktop. +Hit the Enter key on your keyboard. + +Here you can make changes to files like `/usr/local/bin/start-hello`. For example, you can add `xterm &` near the top to get a rescue graphical terminal that can help you debug the later stages of the boot process, when Xorg has started and is executing `start-hello`. + +Then enter `exit` to contine. The system will boot into the graphical desktop. ## Live system early boot process From 0153d66a40398ad9f74c74c23877042797fdca0e Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 20 Nov 2022 16:58:00 +0100 Subject: [PATCH 513/592] Update boot.md --- developer/boot.md | 18 ++++++++++++++++-- 1 file changed, 16 insertions(+), 2 deletions(-) diff --git a/developer/boot.md b/developer/boot.md index 70bf3aad..72b13581 100644 --- a/developer/boot.md +++ b/developer/boot.md @@ -98,7 +98,6 @@ Press the Backspace key on your keyboard during early boot until you see the `OK Enter ``` -unset boot_mute boot -s ``` @@ -115,10 +114,25 @@ At this point, the system has been made partly writable by the `init_script`. To Hit the Enter key on your keyboard. -Here you can make changes to files like `/usr/local/bin/start-hello`. For example, you can add `xterm &` near the top to get a rescue graphical terminal that can help you debug the later stages of the boot process, when Xorg has started and is executing `start-hello`. +Here you can make changes to files like `/usr/local/bin/start-hello`. + +For example, you can + +``` +mv /usr/local/bin/start-hello /usr/local/bin/start-hello.original +ln -sf /usr/local/bin/xterm /usr/local/bin/start-hello +``` Then enter `exit` to contine. The system will boot into the graphical desktop. +If you have made the above changes, you can run + +``` +sh -x /usr/local/bin/start-hello.original +``` + +to watch `start-hello.original` run in a graphical terminal. + ## Live system early boot process ``` .. note:: From 4efbd667face23abf5b3201b082ba7bc2d212715 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 20 Nov 2022 17:14:27 +0100 Subject: [PATCH 514/592] Update boot.md --- developer/boot.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/developer/boot.md b/developer/boot.md index 72b13581..ee6980b5 100644 --- a/developer/boot.md +++ b/developer/boot.md @@ -133,6 +133,10 @@ sh -x /usr/local/bin/start-hello.original to watch `start-hello.original` run in a graphical terminal. +![image](https://user-images.githubusercontent.com/2480569/202913068-5399a4fa-cefc-4ffc-ba24-9b752d6a4cff.png) + +Here you can see what goes wrong, if anything... + ## Live system early boot process ``` .. note:: From 15f49a9399add6e37f1a6d2bf19e209c78d2576c Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 20 Nov 2022 18:55:37 +0100 Subject: [PATCH 515/592] Mention Monkey Patching --- developer/boot.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/developer/boot.md b/developer/boot.md index ee6980b5..fcb5842b 100644 --- a/developer/boot.md +++ b/developer/boot.md @@ -135,7 +135,7 @@ to watch `start-hello.original` run in a graphical terminal. ![image](https://user-images.githubusercontent.com/2480569/202913068-5399a4fa-cefc-4ffc-ba24-9b752d6a4cff.png) -Here you can see what goes wrong, if anything... +Here you can see what goes wrong, if anything... and then you can create, e.g., a replacement `start-hello` script that gets loaded with Monkey Patching. ## Live system early boot process From 949e592524c5065cfb84bd175567ba8fca41f985 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 20 Nov 2022 21:41:26 +0100 Subject: [PATCH 516/592] Update monkey-patch.md --- developer/monkey-patch.md | 18 +++++++++++++++++- 1 file changed, 17 insertions(+), 1 deletion(-) diff --git a/developer/monkey-patch.md b/developer/monkey-patch.md index ea2b9f8b..79179658 100644 --- a/developer/monkey-patch.md +++ b/developer/monkey-patch.md @@ -48,13 +48,29 @@ echo "HELLO DEVELOPERS" # the helloSystem zero-text boot experience echo "HELLO MERE MORTALS" > /dev/console +# Give users a chance to see the message +sleep 1 + # Override a file in the running system from the MONKEYPATCH volume HERE="$(dirname "$(readlink -f "${0}")")" cp ${HERE}/mount_md /usr/local/sbin/mount_md chmod +x /usr/local/sbin/mount_md ``` -* There must be a `monkeypatch.sh` file that will be run by `#!/bin/sh` +A particularly effective way to debug the late boot process (after Xorg has started) is: + +``` +mv /usr/local/bin/start-hello /usr/local/bin/start-hello.real +cat > /usr/local/bin/start-hello <<\EOF +#!/bin/sh + +xterm -maximized start-hello.real +# xterm -maximized +EOF +chmod +x /usr/local/bin/start-hello* +``` + +This will allow you to see the commands in `start-hello.real` as they are executed. ## Booting a Live ISO running a different `init_script` From 7242e63f8b5714584d671caa01650ace6732e135 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 21 Nov 2022 20:53:01 +0100 Subject: [PATCH 517/592] Update boot.md --- developer/boot.md | 1 - 1 file changed, 1 deletion(-) diff --git a/developer/boot.md b/developer/boot.md index fcb5842b..8ea96f47 100644 --- a/developer/boot.md +++ b/developer/boot.md @@ -76,7 +76,6 @@ Check which services are still enabled, should now be treatly reduced: ``` % grep -r 'enable="YES"' /etc/rc.conf* -/etc/rc.conf:autofs_enable="YES" /etc/rc.conf:clear_tmp_enable="YES" /etc/rc.conf:dbus_enable="YES" /etc/rc.conf:initgfx_enable="YES" From a276afbcb3f57288550a27381ed8782c98e8b28c Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 27 Nov 2022 10:46:46 +0100 Subject: [PATCH 518/592] Update and rename chromium.md to iridium.md --- user/components/applications/chromium.md | 12 ------------ user/components/applications/iridium.md | 12 ++++++++++++ 2 files changed, 12 insertions(+), 12 deletions(-) delete mode 100644 user/components/applications/chromium.md create mode 100644 user/components/applications/iridium.md diff --git a/user/components/applications/chromium.md b/user/components/applications/chromium.md deleted file mode 100644 index 71fde99a..00000000 --- a/user/components/applications/chromium.md +++ /dev/null @@ -1,12 +0,0 @@ -# Chromium - -__Chromium__ is an optional web browser that can be used on helloSystem. - -Upon first start of the Chromium browser, the following extensions are automatically installed from [https://chrome.google.com/webstore/](https://chrome.google.com/webstore/) to increase privacy and convenience: - -* __I don't care about cookies__: Tries to remove annoying cookie popups automatically. Visit [https://www.i-dont-care-about-cookies.eu](https://www.i-dont-care-about-cookies.eu) to learn more about this extension. Deactivate or uninstall this extension if you would like to see cookie popups -* __uBlock Origin__: Tries to block unwanted advertising and tracking. Visit [https://github.com/gorhill/uBlock](https://github.com/gorhill/uBlock) to learn more about this extension. Deactivate or uninstall this extension if you would like to see advertising and allow trackers to track you. - -You can uninstall those extensions at any time from within Chromium. - -If you would like Chromium not to install those extensions from the Chrome Web Store in the first place, remove the files in `/usr/local/share/chromium/extensions/*.json` prior to launching Chromium for the first time. diff --git a/user/components/applications/iridium.md b/user/components/applications/iridium.md new file mode 100644 index 00000000..ca7ce41e --- /dev/null +++ b/user/components/applications/iridium.md @@ -0,0 +1,12 @@ +# Iridium + +__Iridium__ is an optional web browser that can be used on helloSystem. It is based on the Chromium browser. + +Upon first start of the Iridium browser, the following extensions are automatically installed from [https://chrome.google.com/webstore/](https://chrome.google.com/webstore/) to increase privacy and convenience: + +* __I don't care about cookies__: Tries to remove annoying cookie popups automatically. Visit [https://www.i-dont-care-about-cookies.eu](https://www.i-dont-care-about-cookies.eu) to learn more about this extension. Deactivate or uninstall this extension if you would like to see cookie popups +* __uBlock Origin__: Tries to block unwanted advertising and tracking. Visit [https://github.com/gorhill/uBlock](https://github.com/gorhill/uBlock) to learn more about this extension. Deactivate or uninstall this extension if you would like to see advertising and allow trackers to track you. + +You can uninstall those extensions at any time from within Iridium. + +If you would like Iridium not to install those extensions from the Chrome Web Store in the first place, remove the files in `/usr/local/share/iridium/extensions/*.json` prior to launching Iridium for the first time. From 69c225ecc91cd248a8515283c131f2e3df51591a Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 27 Nov 2022 18:03:15 +0100 Subject: [PATCH 519/592] Framework Computer Inc --- developer/acknowledgements.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/developer/acknowledgements.md b/developer/acknowledgements.md index f7264148..5195bed0 100644 --- a/developer/acknowledgements.md +++ b/developer/acknowledgements.md @@ -134,3 +134,7 @@ __[alphamodh0](https://github.com/alphamodh0)__ ## Luna Jernberg __[bittin](https://github.com/bittin)__ * Translated helloSystem installer to Swedish + +## Framework Computer Inc +__[FrameworkComputer](https://github.com/FrameworkComputer)__ +* Donated a Framework Mainboard through the Developer Mainboard Program From d1899b9abf6fbaa609014c2a09988ce23437e874 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 27 Nov 2022 18:04:51 +0100 Subject: [PATCH 520/592] Update acknowledgements.md --- developer/acknowledgements.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/developer/acknowledgements.md b/developer/acknowledgements.md index 5195bed0..6da137bc 100644 --- a/developer/acknowledgements.md +++ b/developer/acknowledgements.md @@ -137,4 +137,4 @@ __[bittin](https://github.com/bittin)__ ## Framework Computer Inc __[FrameworkComputer](https://github.com/FrameworkComputer)__ -* Donated a Framework Mainboard through the Developer Mainboard Program +* Donated a Framework Mainboard (i5-1135G7) through the Developer Mainboard Program From 6bcf90fdb432f6c2c0f4eecd01a64b1823475d33 Mon Sep 17 00:00:00 2001 From: probonopd Date: Tue, 29 Nov 2022 19:19:00 +0100 Subject: [PATCH 521/592] Remove outdated information --- developer/application-bundles.md | 18 ------------------ 1 file changed, 18 deletions(-) diff --git a/developer/application-bundles.md b/developer/application-bundles.md index 20a7db56..cbb3b173 100644 --- a/developer/application-bundles.md +++ b/developer/application-bundles.md @@ -89,24 +89,6 @@ Instead, use [`QString QCoreApplication::applicationDirPath()`](http://doc.qt.io For an example, see: https://github.com/KaidanIM/Kaidan/commit/da38011b55a1aa5d17764647ecd699deb4be437f -## Getting application metadata for running applications - -Many desktop environments use XDG-style `.desktop` files to figure out which application a given window belongs to but since helloSystem is using `.app` bundles and `.AppDir` application directories this approach is not sufficient since such applications normally do not install XDG-style `.desktop` files in central locations. - -Docks (and other similar applications) can find the icon that belongs to a window on the screen by the following procedure: - -1. Get the Window IDs of the windows on the screen from Xorg (to simulate this, you can use the `xprop` tool) -1. Get the process ID (PID) that has launched the window with this ID from the `_NET_WM_PID` property of the Xorg window -1. Get the path of the executable and its arguments that launched this PID from the operating system, e.g., using `/proc/$PID/cmdline` (Linux) or the `procstat` command (FreeBSD) -1. From the path and the arguments figure out which element might be the relevant `.app` bundle or `.AppDir`. For example, a process might have been invoked with `sudo -E launch python3 /Applications/Some.app/Some --arguments 123`. In this case the relevant information is in a "random" location within the long list of arguments. Also consider the case `python3 /Applications/Some.app/Resources/some-executable`. In this case `some-executable` is in a subdirectory of the application bundle - -A rudimentary implementation of this logic is in place in Dock in the `Utils::readInfoFromPid(quint32 pid)` and `Utils::examinePotentialBundlePath(QString path)` methods, but improvements are highly welcome. - - -``` .. note:: - To display the correct icons in Dock for processes running as root, users must be able to see information on processes running as root. Hence security.bsd.see_other_uids=0 must not be set in sysctl.conf for this to work. -``` - ## Credits Application directories and application bundles have been used by many desktop-oriented operating systems, including RISC OS, NeXTStep/OPENSTEP, Mac OS X, and various other systems. Classic Macintosh System used single-file applications that kept resources in the Resource Fork. From a4204c4d1ee4b25ecb399d57404307b37ab88a31 Mon Sep 17 00:00:00 2001 From: probonopd Date: Thu, 1 Dec 2022 19:46:13 +0100 Subject: [PATCH 522/592] Update ports.md --- developer/ports.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/developer/ports.md b/developer/ports.md index 84d183d2..79e4ce36 100644 --- a/developer/ports.md +++ b/developer/ports.md @@ -297,3 +297,5 @@ Result: * https://reviews.freebsd.org/D37378 * https://reviews.freebsd.org/D37379 * https://reviews.freebsd.org/D37380 + +If a reviewer requires changes to be made, make the changes and upload (paste) a new diff (like the original diff; not a "diff of the diff"!) by clicking on "Update Diff" on the respective Phabricator page, e.g., https://reviews.freebsd.org/D37378. From 878c53c70e94fa8cc7529530c6c5f94ddaf13e1a Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 21 Jan 2023 20:58:31 +0100 Subject: [PATCH 523/592] Update index.md --- index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.md b/index.md index 6edc8b2f..63e8dbb6 100644 --- a/index.md +++ b/index.md @@ -12,7 +12,7 @@ __helloSystem__ is a desktop system for creators with a focus on simplicity, elegance, and usability. Its design follows the "Less, but better" philosophy. It is intended as a system for "mere mortals", welcoming to switchers from the Mac. [FreeBSD](https://www.freebsd.org/) is used as the core operating system. Please refer to [https://github.com/helloSystem/hello](https://github.com/helloSystem/hello) if you would like to learn more about the ideas and principles behind hello. -![Screenshot](https://raw.githubusercontent.com/helloSystem/hello/master/screenshots/20211219-desktop-0.7.png) +![Screenshot](https://github.com/helloSystem/hello/blob/master/screenshots/20220121-desktop-0.8.png?raw=true) ```eval_rst .. toctree:: From 0a422d70c6499c036cb6d829a6f76139e21996a9 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 21 Jan 2023 21:03:18 +0100 Subject: [PATCH 524/592] Disable Qt --- buildDocs.sh | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/buildDocs.sh b/buildDocs.sh index 4a606ae3..6915eea5 100644 --- a/buildDocs.sh +++ b/buildDocs.sh @@ -18,9 +18,9 @@ set -x ################### apt-get update -apt-get -y install git rsync python3-pip qttools5-dev-tools qt5-default qt5-qmake +apt-get -y install git rsync python3-pip # qttools5-dev-tools qt5-default qt5-qmake pip3 install setuptools wheel -pip3 install docutils==0.16 sphinx sphinx-autobuild sphinx-rtd-theme commonmark recommonmark sphinxcontrib-qthelp sphinx-markdown-tables markdown!=3.3.5 +pip3 install docutils==0.16 sphinx sphinx-autobuild sphinx-rtd-theme commonmark recommonmark sphinx-markdown-tables markdown!=3.3.5 # sphinxcontrib-qthelp # markdown!=3.3.5 = Workaround for ryanfox/sphinx-markdown-tables#34 ##################### From 017696b0b02139225962f790703540520a6be668 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 21 Jan 2023 21:10:54 +0100 Subject: [PATCH 525/592] Disable Qt --- buildDocs.sh | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/buildDocs.sh b/buildDocs.sh index 6915eea5..02faab93 100644 --- a/buildDocs.sh +++ b/buildDocs.sh @@ -41,7 +41,7 @@ make clean make html make epub make qthelp -qcollectiongenerator _build/qthelp/*.qhcp +# qcollectiongenerator _build/qthelp/*.qhcp # sphinx-build -b html . _build # make -C ./docs html From 44f062408e017e938027c03550c0e2b4bf6cff9e Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 21 Jan 2023 21:13:48 +0100 Subject: [PATCH 526/592] Update buildDocs.sh --- buildDocs.sh | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/buildDocs.sh b/buildDocs.sh index 02faab93..9fb0f494 100644 --- a/buildDocs.sh +++ b/buildDocs.sh @@ -51,7 +51,7 @@ make qthelp rm -rf ./out/ || true mkdir -p out -cp _build/qthelp/*.qhc _build/epub/*.epub out/ +# cp _build/qthelp/*.qhc _build/epub/*.epub out/ wget "https://github.com/tcnksm/ghr/releases/download/v0.13.0/ghr_v0.13.0_linux_amd64.tar.gz" tar xf ghr_*.tar.gz GH_USER=$(echo "${GITHUB_REPOSITORY}" | cut -d "/" -f 1) From 1a62d712db1dba0ecbc0924deac9ae32849b3d85 Mon Sep 17 00:00:00 2001 From: heidiwenger <82445727+heidiwenger@users.noreply.github.com> Date: Sat, 28 Jan 2023 15:44:56 +0000 Subject: [PATCH 527/592] Update index.md (#46) Added Finnish welcome "tervetuloa". --- index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.md b/index.md index 63e8dbb6..de79eec2 100644 --- a/index.md +++ b/index.md @@ -5,7 +5,7 @@ ``` ```eval_rst -.. centered:: Willkommen • Welcome • Bienvenue • Benvenuto • Bienvenido • ようこそ • Mabuhay • Välkommen • Добро пожаловать • Hoş geldiniz • Bonvenon • 歡迎 +.. centered:: Willkommen • Welcome • Bienvenue • Benvenuto • Bienvenido • ようこそ • Mabuhay • Tervetuloa • Välkommen • Добро пожаловать • Hoş geldiniz • Bonvenon • 歡迎 ``` # hello From a49026726449b380d378d0d2be9c8a2416bf1cb3 Mon Sep 17 00:00:00 2001 From: Abdulmujeeb Raji <121579011+midnadimple@users.noreply.github.com> Date: Sat, 4 Feb 2023 14:54:30 +0000 Subject: [PATCH 528/592] Update ISO link in getting-started.md (#47) I changed the ISO link in the Downloading section to the latest stable release. Do tell me if this is unwanted. --- user/getting-started.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/user/getting-started.md b/user/getting-started.md index a16f70bf..27a320d6 100644 --- a/user/getting-started.md +++ b/user/getting-started.md @@ -18,7 +18,7 @@ Please refer to [FreeBSD Hardware Compatibility](https://www.freebsd.org/doc/en_ ## Downloading -The **helloSystem 0.7.0** ISO image is available for download [here](https://github.com/helloSystem/ISO/releases/tag/r0.7.0). +The **helloSystem 0.8.0** ISO image is available for download [here](https://github.com/helloSystem/ISO/releases/tag/r0.8.0). Experimental and pre-release images are available for download [here](https://github.com/helloSystem/ISO/releases). From 0e46574d9cc4e0a083333fb328a94ad9699cb805 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ciar=C3=A1n=20Ainsworth?= Date: Mon, 6 Feb 2023 19:28:02 +0100 Subject: [PATCH 529/592] chore: migrate to myst syntax (#48) * chore: migrate to myst syntax * remove unnecessary formatting from header * Update missing admonitions * Fix typo * Update dependencies in build script --- buildDocs.sh | 3 +- conf.py | 24 +- developer/application-bundles.md | 12 +- developer/applications.md | 2 +- developer/architecture.md | 12 +- developer/base.md | 37 +-- developer/binary-compatibility.md | 53 ++-- developer/boot.md | 130 ++++---- developer/building.md | 36 +-- developer/developer-tools.md | 19 +- developer/distributions.md | 2 +- developer/filer-context-menus.md | 109 ++++--- developer/geom_rowr.md | 76 ++--- developer/graphics.md | 10 +- developer/linux.md | 103 ++++--- developer/localization.md | 26 +- developer/man.md | 20 +- developer/menu.md | 78 ++--- developer/midi.md | 50 +-- developer/monkey-patch.md | 24 +- developer/ports.md | 201 ++++++------ developer/rpi.md | 291 +++++++++--------- developer/tracing.md | 28 +- developer/ux-guidelines.md | 2 +- index.md | 102 +++--- requirements.txt | 14 +- user/components.md | 16 +- user/components/applications.md | 11 +- user/components/preferences.md | 13 +- .../preferences/boot-environments.md | 20 +- user/components/preferences/desktop.md | 2 +- user/components/preferences/keyboard.md | 14 +- user/components/preferences/sharing.md | 21 +- user/components/preferences/shortcuts.md | 44 +-- .../preferences/wireless-networks.md | 8 +- user/components/system.md | 11 +- user/components/system/launch.md | 60 ++-- user/components/system/menu.md | 4 +- user/components/utilities.md | 11 +- .../components/utilities/create-live-media.md | 20 +- user/components/utilities/hardware-probe.md | 8 +- user/components/utilities/install.md | 14 +- .../components/utilities/remote-assistance.md | 6 +- user/components/utilities/update.md | 6 +- user/getting-started.md | 35 ++- user/troubleshooting.md | 14 +- 46 files changed, 901 insertions(+), 901 deletions(-) diff --git a/buildDocs.sh b/buildDocs.sh index 9fb0f494..b5523f84 100644 --- a/buildDocs.sh +++ b/buildDocs.sh @@ -20,8 +20,7 @@ set -x apt-get update apt-get -y install git rsync python3-pip # qttools5-dev-tools qt5-default qt5-qmake pip3 install setuptools wheel -pip3 install docutils==0.16 sphinx sphinx-autobuild sphinx-rtd-theme commonmark recommonmark sphinx-markdown-tables markdown!=3.3.5 # sphinxcontrib-qthelp -# markdown!=3.3.5 = Workaround for ryanfox/sphinx-markdown-tables#34 +pip3 install docutils==0.16 sphinx>=5.0.0 sphinx-autobuild sphinx_rtd_theme>=0.5.2 myst-parser # sphinxcontrib-qthelp ##################### # DECLARE VARIABLES # diff --git a/conf.py b/conf.py index 0e4843b2..8572031d 100644 --- a/conf.py +++ b/conf.py @@ -16,9 +16,6 @@ # import sys # sys.path.insert(0, os.path.abspath('.')) -import recommonmark -from recommonmark.transform import AutoStructify - # -- Project information ----------------------------------------------------- @@ -38,10 +35,13 @@ extensions = [ # Auto-generate section labels. 'sphinx.ext.autosectionlabel', - 'recommonmark', - 'sphinx_markdown_tables' + 'myst_parser' ] +# Enable code fences to be written with colons for extra control + +myst_enable_extensions = ["colon_fence"] + master_doc = 'index' # Prefix document path to section labels, otherwise autogenerated labels would look like 'heading' @@ -95,17 +95,3 @@ ] github_doc_root = 'https://' + GITHUB_REPO_OWNER + '.github.io/' + GITHUB_REPO_NAME + '/' - - -def setup(app): - app.add_config_value( - 'recommonmark_config', - { - 'enable_auto_toc_tree': False, - 'url_resolver': lambda url: github_doc_root + url, - 'auto_toc_tree_section': 'Contents', - }, - True - ) - - app.add_transform(AutoStructify) diff --git a/developer/application-bundles.md b/developer/application-bundles.md index cbb3b173..975c241b 100644 --- a/developer/application-bundles.md +++ b/developer/application-bundles.md @@ -23,7 +23,7 @@ helloSystem supports simplified GNUstep-style `.app` bundles. Minimal requirements: -``` +```text ./Application.app ./Application.app/Application <-- (link to) the executable to be launched when Application.app is double clicked ./Application.app/Resources/Application.png <-- the application icon (png format) @@ -38,7 +38,7 @@ helloSystem supports simplified ROX-style `.AppDir` bundles. Minimal requirements: -``` +```text ./Application.AppDir ./Application.AppDir/AppRun <-- (link to) the executable to be launched when Application.app is double clicked ./Application.AppDir/.DirIcon <-- the application icon (png format) @@ -70,10 +70,10 @@ Please see the [`.cirrus.yml`](https://github.com/helloSystem/QHexEdit/blob/main If an application is supposed to load privately bundled libraries, one must patch it so that it loads privately bundled libraries from a path relative to itself (`$ORIGIN`) rather than from `/usr/local/lib`: -``` -sed -i -e 's|/usr/local/lib|$ORIGIN/../lib|g' usr/local/bin/falkon -ln -s usr/local/lib . -rm usr/local/bin/falkon-e +```console +$ sed -i -e 's|/usr/local/lib|$ORIGIN/../lib|g' usr/local/bin/falkon +$ ln -s usr/local/lib . +$ rm usr/local/bin/falkon-e ``` This works because by coincidence the string `/usr/local/lib` has the exact same length as `$ORIGIN/../lib`. If this was not the case, one would need to either specify the rpath at compilation time, or use a tool such as `patchelf`. diff --git a/developer/applications.md b/developer/applications.md index 3af10fe5..02193675 100644 --- a/developer/applications.md +++ b/developer/applications.md @@ -19,7 +19,7 @@ For an introduction to [Creating GUI applications with Python & Qt5](https://www Using Qt Creator, you can also create and edit graphical user interfaces for __Python__ based applications using `.ui` files. These can be used in PyQt like this: -``` +```py #!/usr/bin/env python3 # This Python file uses the following encoding: utf-8 diff --git a/developer/architecture.md b/developer/architecture.md index 8a6de876..336728db 100644 --- a/developer/architecture.md +++ b/developer/architecture.md @@ -32,14 +32,14 @@ A Dock that shows icons for running and pinned applications. (In the future it s ### `launch` command -The `launch` command is used to launch applications without specifying a path to them. +The {command}`launch` command is used to launch applications without specifying a path to them. -The `launch` command is expected to determine the preferred instance of an application with the given name. (The `launch` command is supposed to find the _preferred_ instance, e.g., the one with the highest version, the one last put onto the system, etc.) Eventually the `launch` command should also gain knowledge of which application to open a file with. +The {command}`launch` command is expected to determine the preferred instance of an application with the given name. (The {command}`launch` command is supposed to find the _preferred_ instance, e.g., the one with the highest version, the one last put onto the system, etc.) Eventually the {command}`launch` command should also gain knowledge of which application to open a file with. -Filer is supposed to launch all applications through the `launch` command. Shell scripts, `.desktop` files, etc. should be written to use the `launch` command rather than hardcoding paths to applications, where appropriate. +Filer is supposed to launch all applications through the {command}`launch` command. Shell scripts, `.desktop` files, etc. should be written to use the {command}`launch` command rather than hardcoding paths to applications, where appropriate. -If an application cannot be launched, the `launch` command shall give a localized, understandable clear-text error message and offer a solution if possible; fall back to the console output of the application that could not be launched. -When beginning to launch an application, the `launch` command shall notify the Dock via some IPC mechanism (ideally something _much_ simpler than the convoluted D-Bus) about the icon and name of the application about to be launched, so that the Dock can start a launch animation until the application is showing its first window). +If an application cannot be launched, the {command}`launch` command shall give a localized, understandable clear-text error message and offer a solution if possible; fall back to the console output of the application that could not be launched. +When beginning to launch an application, the {command}`launch` command shall notify the Dock via some IPC mechanism (ideally something _much_ simpler than the convoluted D-Bus) about the icon and name of the application about to be launched, so that the Dock can start a launch animation until the application is showing its first window). ### IPC mechanism for the desktop @@ -47,7 +47,7 @@ A very simple IPC mechanism should be introduced for the desktop components to t ### Applications -Applications must not need to be installed. Simply downloading them, attaching an external drive containing them, or connecting to a network share containing them must be sufficient. Multiple versions of the same application must be able to co-exist. The `launch` command is responsible to determine which one to use in cases where the user did not explicitly launch a specific instance by double-clicking it. +Applications must not need to be installed. Simply downloading them, attaching an external drive containing them, or connecting to a network share containing them must be sufficient. Multiple versions of the same application must be able to co-exist. The {command}`launch` command is responsible to determine which one to use in cases where the user did not explicitly launch a specific instance by double-clicking it. Custom-written applications should come as Application bundles whenever possible. It is acceptable for pre-existing applications to come with legacy XDG desktop files instead. diff --git a/developer/base.md b/developer/base.md index e2e8b8b2..1cf1d302 100644 --- a/developer/base.md +++ b/developer/base.md @@ -1,6 +1,7 @@ # Working with the FreeBSD base system In some situations it may be necessary to make changes to existing software that comes in the FreeBSD base system. + This section describes how to make such changes using an example. ## Example @@ -9,41 +10,41 @@ Suppose you would like to make a small change to the source code of software tha Here is a real-life example on how to do that: -https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=251025 can be fixed by changing a few lines in + can be fixed by changing a few lines in -https://github.com/freebsd/freebsd-src/blob/main/usr.sbin/efivar/efivar.c + ## Installing the FreeBSD source code Unfortunately one has to download/update the whole FreeBSD source code, even if one just wants to make a change to one command line tool. -From http://ftp.freebsd.org/pub/FreeBSD/releases/amd64/12.2-RELEASE/ (or from whatever FreeBSD version you are using) download `src.txz`. Then: +From (or from whatever FreeBSD version you are using) download {file}`src.txz`. Then: -``` -cd / -sudo tar xf ~/Downloads/src.txz -rm ~/Downloads/src.txz +```console +$ cd / +$ tar xf ~/Downloads/src.txz +$ rm ~/Downloads/src.txz ``` ## Building a command line tool without changes Build the command line tool without changes first to ensure it builds and works as expected. -``` -cd /usr/src/usr.sbin/efivar/ -make -/usr/obj/usr/src/amd64.amd64/usr.sbin/efivar/efivar +```console +$ cd /usr/src/usr.sbin/efivar/ +$ make +$ /usr/obj/usr/src/amd64.amd64/usr.sbin/efivar/efivar ``` ## Making changes Now make changes to the command line tool. -``` -cd /usr/src/usr.sbin/efivar/ -rm efivar.c -# From https://reviews.freebsd.org/D29620 -wget "https://reviews.freebsd.org/file/data/yytb47lr5cxaijaaupeh/PHID-FILE-gihl33z7feu4dagjxjgz/usr.sbin_efivar_efivar.c" -O efivar.c -make -/usr/obj/usr/src/amd64.amd64/usr.sbin/efivar/efivar +```console +$ cd /usr/src/usr.sbin/efivar/ +$ rm efivar.c +// From https://reviews.freebsd.org/D29620 +$ wget "https://reviews.freebsd.org/file/data/yytb47lr5cxaijaaupeh/PHID-FILE-gihl33z7feu4dagjxjgz/usr.sbin_efivar_efivar.c" -O efivar.c +$ make +$ /usr/obj/usr/src/amd64.amd64/usr.sbin/efivar/efivar ``` diff --git a/developer/binary-compatibility.md b/developer/binary-compatibility.md index 494d032a..82d0fc58 100644 --- a/developer/binary-compatibility.md +++ b/developer/binary-compatibility.md @@ -2,16 +2,16 @@ Binary compatibility is an important concept in software engineering. It allows applications compiled on a build system to run on user's target systems without forcing them to upgrade their entire system all the time. As the FreeBSD wiki page on binary compatibility points out, "a lot of downstream users keep systems for about 10 years and want to be able to keep running their stack on top of FreeBSD without worrying that an upgrade will break things." -``` .. note:: - This page is in draft status and needs to be reviewed by experienced FreeBSD developers. Pull requests welcome. -``` +:::{note} +This page is in draft status and needs to be reviewed by experienced FreeBSD developers. Pull requests welcome. +::: - ## Application compatibility - - The Application Binary Interface (ABI) defines which applications can run on which systems. The two main factors in determining application compatibility are the FreeBSD version (e.g., `12.x`) and the version of packages (e.g., `quarterly`). - - * Applications compiled on one major version of FreeBSD are expected to run on subsequent minor versions of the same major version of FreeBSD if the packages of the dependencies on the target system are no older than on the build system. __Example:__ An application compiled on FreeBSD 12.0 is expected to run on FreeBSD 12.1 and 12.2 if the packages of the dependencies on the target system are no older than on the build system - * Applications compiled on one major version of FreeBSD are expected to run on subsequent major versions of FreeBSD if compatibility libraries are installed. __Example:__ An application compiled on FreeBSD 3.2 is expected to run on FreeBSD 14 if compatibility libraries are installed. __But__ this is what happens when you try to `pkg-static add` a package built on FreeBSD 12 on a FreeBSD 13 machine: `pkg-static: wrong architecture: FreeBSD:12:amd64 instead of FreeBSD:13:amd64` - apparently `pkg-static add` does not make use of the compatibility assumption but this can be worked around by exporting, e.g., `ABI=freebsd:12:amd64`; `pkg install` does not seem to have this issue. +## Application compatibility + +The Application Binary Interface (ABI) defines which applications can run on which systems. The two main factors in determining application compatibility are the FreeBSD version (e.g., `12.x`) and the version of packages (e.g., `quarterly`). + +* Applications compiled on one major version of FreeBSD are expected to run on subsequent minor versions of the same major version of FreeBSD if the packages of the dependencies on the target system are no older than on the build system. __Example:__ An application compiled on FreeBSD 12.0 is expected to run on FreeBSD 12.1 and 12.2 if the packages of the dependencies on the target system are no older than on the build system +* Applications compiled on one major version of FreeBSD are expected to run on subsequent major versions of FreeBSD if compatibility libraries are installed. __Example:__ An application compiled on FreeBSD 3.2 is expected to run on FreeBSD 14 if compatibility libraries are installed. __But__ this is what happens when you try to `pkg-static add` a package built on FreeBSD 12 on a FreeBSD 13 machine: `pkg-static: wrong architecture: FreeBSD:12:amd64 instead of FreeBSD:13:amd64` - apparently `pkg-static add` does not make use of the compatibility assumption but this can be worked around by exporting, e.g., `ABI=freebsd:12:amd64`; `pkg install` does not seem to have this issue. ### Recommendation for building binary compatible applications @@ -20,29 +20,28 @@ Build on the `.0` minor version for each still-supported major version of FreeBS This should allow the application to run on all still-supported FreeBSD releases. - ## Kernel module compatibility - - The Kernel Binary Interface (KBI) defines which kernel extensions can run on which systems. +## Kernel module compatibility + +The Kernel Binary Interface (KBI) defines which kernel extensions can run on which systems. -``` .. note:: - Section to be written. Pull requests welcome. -``` +:::{note} +Section to be written. Pull requests welcome. +::: - * Normally, kernel extensions compiled on one major version of FreeBSD are expected to run on subsequent minor versions of the same major version of FreeBSD. However, there are notable exceptions such as the `i915kms` package that contains the Intel GPU driver. - - __Note:__ The `i915kms` package that contains the Intel GPU driver breaks on 12.2-RELEASE. - -``` .. note:: - Explanation to be written. Pull requests welcome. -``` - +* Normally, kernel extensions compiled on one major version of FreeBSD are expected to run on subsequent minor versions of the same major version of FreeBSD. However, there are notable exceptions such as the `i915kms` package that contains the Intel GPU driver. + +__Note:__ The `i915kms` package that contains the Intel GPU driver breaks on 12.2-RELEASE. +:::{note} +Explanation to be written. Pull requests welcome. +::: + ### Recommendation for building binary compatible kernel modules Build on the `.0` minor version for each still-supported major version of FreeBSD. Test whether the kernel module runs on all subsequent minr versions and build for those minor versions separately in case it does not. This should allow the kernel module to run on all still-supported FreeBSD releases. - ## References - - * https://wiki.freebsd.org/BinaryCompatibility describes best practices for maintaining binary compatibility in FreeBSD - * [i915kms package breaks on 12.2-RELEASE](https://forums.freebsd.org/threads/i915kms-package-breaks-on-12-2-release-workaround-build-from-ports.77501/) +## References + +* describes best practices for maintaining binary compatibility in FreeBSD +* [i915kms package breaks on 12.2-RELEASE](https://forums.freebsd.org/threads/i915kms-package-breaks-on-12-2-release-workaround-build-from-ports.77501/) diff --git a/developer/boot.md b/developer/boot.md index 8ea96f47..7382acb7 100644 --- a/developer/boot.md +++ b/developer/boot.md @@ -4,26 +4,27 @@ As a desktop-centric system, helloSystem should bring up a graphical desktop as soon as possible, and delay starting up other services such as the network beyond that point. Unfortunately, in the FreeBSD default configuration this is the other way around, and the graphical desktop will only start after the network has been configured, the time has been set using NTP, etc. -While it would be possible to change the order of the scripts in `/etc/rc.d` and `/usr/local/etc/rc.d`, those changes might get overwritten with subsequent FreeBSD or package updates. Hence, we should never edit startup scripts provided by FreeBSD or packages. +While it would be possible to change the order of the scripts in {file}`/etc/rc.d` and {file}`/usr/local/etc/rc.d`, those changes might get overwritten with subsequent FreeBSD or package updates. Hence, we should never edit startup scripts provided by FreeBSD or packages. Instead, we can disable the services in question so that they don't get started as part of the normal FreeBSD boot sequence, and start them later in the boot process (after the graphical session has been started) using a custom start script. -``` .. note:: - The following instructions are DANGEROUS and can potentially lead to a system that cannot boot into a graphical desktop if things go wrong. This is currently only for developers and experienced users who know how to handle such situations. Future versions of helloSystem may come with this already set up. -``` +:::{note} +The following instructions are DANGEROUS and can potentially lead to a system that cannot boot into a graphical desktop if things go wrong. This is currently only for developers and experienced users who know how to handle such situations. Future versions of helloSystem may come with this already set up. +::: To do this, create a Boot Environment that you can roll back to in case things go wrong. -In `/etc/rc.conf`, set -``` +In {file}`/etc/rc.conf`, set + +```text defaultroute_carrier_delay="0" defaultroute_delay="0" background_dhclient="YES" ``` -Then create the following `/usr/local/etc/rc.d/late-start` script: +Then create the following {file}`/usr/local/etc/rc.d/late-start` script: -``` +```sh #!/bin/sh # PROVIDE: late-start @@ -62,20 +63,19 @@ late_disable_early_services() load_rc_config $name run_rc_command "$1" - ``` Disable the services in question with -``` -sudo chmod +x /usr/local/etc/rc.d/late-start -sudo service late-start disable_early_services +```console +$ sudo chmod +x /usr/local/etc/rc.d/late-start +$ sudo service late-start disable_early_services ``` Check which services are still enabled, should now be treatly reduced: -``` -% grep -r 'enable="YES"' /etc/rc.conf* +```console +$ grep -r 'enable="YES"' /etc/rc.conf* /etc/rc.conf:clear_tmp_enable="YES" /etc/rc.conf:dbus_enable="YES" /etc/rc.conf:initgfx_enable="YES" @@ -96,8 +96,8 @@ Press the Backspace key on your keyboard during early boot until you see the `OK Enter -``` -boot -s +```console +OK boot -s ``` to boot in single user mode. The system will boot to the first stage Live system prompt: @@ -105,32 +105,32 @@ to boot in single user mode. The system will boot to the first stage Live system ![livefirstsingleprompt](https://user-images.githubusercontent.com/2480569/202910574-22c0e284-8717-4ae0-9489-68cc23995e1d.png) At this point, the Live system has not been made writable yet. -Enter `exit` to contine. The system will boot to the second stage Live system prompt: +Enter {command}`exit` to contine. The system will boot to the second stage Live system prompt: ![livesecondsingleprompt](https://user-images.githubusercontent.com/2480569/202910576-e4253133-8544-4566-8b8e-8c0895f63edd.png) -At this point, the system has been made partly writable by the `init_script`. To see the messages, you can press the ScrLk key on your keyboard and then use the arrow up and arrow down keys on your keyboard. Then press the ScrLk key again. +At this point, the system has been made partly writable by the `init_script`. To see the messages, you can press the {kbd}`ScrLk` key on your keyboard and then use the arrow up and arrow down keys on your keyboard. Then press the {kbd}`ScrLk` key again. -Hit the Enter key on your keyboard. +Hit the {kbd}`Enter` key on your keyboard. -Here you can make changes to files like `/usr/local/bin/start-hello`. +Here you can make changes to files like {file}`/usr/local/bin/start-hello`. For example, you can -``` -mv /usr/local/bin/start-hello /usr/local/bin/start-hello.original -ln -sf /usr/local/bin/xterm /usr/local/bin/start-hello +```console +$ mv /usr/local/bin/start-hello /usr/local/bin/start-hello.original +$ ln -sf /usr/local/bin/xterm /usr/local/bin/start-hello ``` -Then enter `exit` to contine. The system will boot into the graphical desktop. +Then enter {command}`exit` to contine. The system will boot into the graphical desktop. If you have made the above changes, you can run -``` -sh -x /usr/local/bin/start-hello.original +```console +$ sh -x /usr/local/bin/start-hello.original ``` -to watch `start-hello.original` run in a graphical terminal. +to watch {file}`start-hello.original` run in a graphical terminal. ![image](https://user-images.githubusercontent.com/2480569/202913068-5399a4fa-cefc-4ffc-ba24-9b752d6a4cff.png) @@ -138,9 +138,9 @@ Here you can see what goes wrong, if anything... and then you can create, e.g., ## Live system early boot process -``` .. note:: - This section describes helloSystem boot process up to 0.6.0. Starting with version 0.7.0, helloSystem will use a completely different live system boot process. This page needs to be updated accordingly. -``` +:::{note} +This section describes helloSystem boot process up to 0.6.0. Starting with version 0.7.0, helloSystem will use a completely different live system boot process. This page needs to be updated accordingly. +::: The ISO contains a compressed Live system filesystem image in uzip format. This filesystem image contains the filesystem used when running the ISO. During the Live system boot process, the image needs to get mounted and needs to get turned into a read-write filesystem so that one can make changes to the running system. @@ -149,17 +149,17 @@ FreeBSD does not have a standard way to achieve this, so custom code has to be u This is a simplified description of the boot process. There may be additional aspects which still need to be documented. 1. The bootloader gets loaded -1. The bootloader loads the kernel modules that are required for the Live system boot process as specified in `overlays/boot/boot/loader.conf`. Note that the bootloader apparently is not smart enough to load the dependencies of kernel modules, so one needs to manually specify those as well. For example, `zfs.ko` up to FreeBSD 12 requires `opensolaris.ko` and from 13 onward requires `cryptodev.ko` -1. The bootloader loads the ramdisk image `ramdisk.ufs` as specified in `overlays/boot/boot/loader.conf` under `mfsroot_name`. The contents of the ramdisk image are specified in `overlays/ramdisk` -1. `init.sh` from the ramdisk image gets executed as requested by `overlays/boot/boot/loader.conf` under `init_script` and specified in `overlays/ramdisk/init.sh`. It constructs a r/w Live filesystem tree (e.g., by replicating the system image to swap-based memdisk) at `/livecd` -1. `/usr/local/bin/furybsd-init-helper` gets executed by `init.sh` in a chroot of the live filesystem, `/livecd`. It is defined in `overlays/uzip/furybsd-live-settings/files/usr/local/bin/furybsd-init-helper` and deals with loading Xorg configuration based on the detected devices on PCI, and with loading virtualization-related drivers -1. The `/livecd` chroot is exited -1. `init.sh` from the ramdisk image exits -1. `etc/rc` from the ramdisk image gets executed as specified in `overlays/ramdisk/etc/rc` (by what?). It tells the kernel to "reroot" (not "chroot") into the live filesystem, `/livecd` using `reboot -r` -1. From here on, the boot process is the regular FreeBSD boot process with the following particularities: -1. `/etc/rc.d/initgfx` detects the GPU and loads the appropriate drivers -3. `/usr/local/etc/rc.d/localize` runs `/usr/local/sbin/localize` which tries to determine the language of the keyboard, and by proxy, of the system. This currently supports the official Raspberry Pi keyboard and Apple computers which store the keyboard and system language in the `prev-lang:kbd` EFI variable -4. The `slim` session manager (login window) is started; when the user is logged in, it starts the script `/usr/local/bin/start-hello` which starts the desktop session and sets the keyboard and system language based on the information provided by `localize` in an earlier step +2. The bootloader loads the kernel modules that are required for the Live system boot process as specified in {file}`overlays/boot/boot/loader.conf`. Note that the bootloader apparently is not smart enough to load the dependencies of kernel modules, so one needs to manually specify those as well. For example, `zfs.ko` up to FreeBSD 12 requires `opensolaris.ko` and from 13 onward requires `cryptodev.ko` +3. The bootloader loads the ramdisk image `ramdisk.ufs` as specified in {file}`overlays/boot/boot/loader.conf` under `mfsroot_name`. The contents of the ramdisk image are specified in `overlays/ramdisk` +4. `init.sh` from the ramdisk image gets executed as requested by {file}`overlays/boot/boot/loader.conf` under `init_script` and specified in {file}`overlays/ramdisk/init.sh`. It constructs a r/w Live filesystem tree (e.g., by replicating the system image to swap-based memdisk) at `/livecd` +5. {file}`/usr/local/bin/furybsd-init-helper` gets executed by `init.sh` in a chroot of the live filesystem, `/livecd`. It is defined in {file}`overlays/uzip/furybsd-live-settings/files/usr/local/bin/furybsd-init-helper` and deals with loading Xorg configuration based on the detected devices on PCI, and with loading virtualization-related drivers +6. The `/livecd` chroot is exited +7. `init.sh` from the ramdisk image exits +8. `etc/rc` from the ramdisk image gets executed as specified in {file}`overlays/ramdisk/etc/rc` (by what?). It tells the kernel to "reroot" (not "chroot") into the live filesystem, `/livecd` using {command}`reboot -r` +9. From here on, the boot process is the regular FreeBSD boot process with the following particularities: +10. {file}`/etc/rc.d/initgfx` detects the GPU and loads the appropriate drivers +11. {file}`/usr/local/etc/rc.d/localize` runs {file}`/usr/local/sbin/localize` which tries to determine the language of the keyboard, and by proxy, of the system. This currently supports the official Raspberry Pi keyboard and Apple computers which store the keyboard and system language in the `prev-lang:kbd` EFI variable +13. The `slim` session manager (login window) is started; when the user is logged in, it starts the script {file}`/usr/local/bin/start-hello` which starts the desktop session and sets the keyboard and system language based on the information provided by `localize` in an earlier step ### Troubleshooting the Live system early boot process @@ -189,9 +189,9 @@ Example: `load: 0.62 cmd: sleep 1739 [nanslp] 2.97r 0.00u 0.00s 0% 2168k` If you would like to observe the details of the boot process, you can start your computer in __verbose mode__. This allows you to inspect the Live system early boot process and to enter commands manually that would otherwise be executed automatically. -1. While the bootloader is running, keep the __Backspace__ key pressed until you see an `OK` prompt (alternatively, for a short time during boot, it says `Hit [Enter] to boot immediately, or any other key for command prompt.`. Press the __Esc__ key on your keyboard immediately when you see this) -1. Type `unset boot_mute` and press the __Enter__ key. This disables the graphical splash screen and results in boot messages being shown -1. Type `boot -v` and press the __Enter__ key. This results in the system being booted in verbose mode +1. While the bootloader is running, keep the {kbd}`Backspace` key pressed until you see an `OK` prompt (alternatively, for a short time during boot, it says `Hit [Enter] to boot immediately, or any other key for command prompt.`. Press the {kbd}`Esc` key on your keyboard immediately when you see this) +2. Type `unset boot_mute` and press the {kbd}`Enter` key. This disables the graphical splash screen and results in boot messages being shown +3. Type `boot -v` and press the {kbd}`Enter` key. This results in the system being booted in verbose mode The computer should boot into a graphical desktop. @@ -199,27 +199,27 @@ The computer should boot into a graphical desktop. If your computer hangs during booting, you can boot into __verbose single-user mode__. This allows advanced users, administrators, and developers to inspect the Live system early boot process and to enter commands manually that would otherwise be executed automatically. -1. While the bootloader is running, keep the __Backspace__ key pressed until you see an `OK` prompt (alternatively, for a short time during boot, it says `Hit [Enter] to boot immediately, or any other key for command prompt.`. Press the __Esc__ key on your keyboard immediately when you see this) -1. Type `unset boot_mute` and press the __Enter__ key. This disables the graphical splash screen and results in boot messages being shown -1. Type `boot -v -s` and press the __Enter__ key. This results in the system being booted in verbose single-user mode +1. While the bootloader is running, keep the {kbd}`Backspace` key pressed until you see an `OK` prompt (alternatively, for a short time during boot, it says `Hit [Enter] to boot immediately, or any other key for command prompt.`. Press the {kbd}`Esc` key on your keyboard immediately when you see this) +1. Type `unset boot_mute` and press the {kbd}`Enter` key. This disables the graphical splash screen and results in boot messages being shown +1. Type `boot -v -s` and press the {kbd}`Enter` key. This results in the system being booted in verbose single-user mode The computer should boot into a text console rescue system in which parts of `init.sh` from the ramdisk image have run. -``` .. note:: - Single-user mode on the Live system currently is for developers of the Live system only. - - If you boot the Live system into single-user mode, then you will be dropped into a shell in the ramdisk, and you are expected to manually enter the commands required for the Live system to continue booting which would otherwise be executed by the ramdisk automatically. Specifically, you need to enter everything below the line "Running in single-user mode" in the file overlays/ramdisk/init.sh (or variants thereof). If you just exit the shell without doing this, then the system will be unable to continue booting. -``` +:::{note} +Single-user mode on the Live system currently is for developers of the Live system only. + +If you boot the Live system into single-user mode, then you will be dropped into a shell in the ramdisk, and you are expected to manually enter the commands required for the Live system to continue booting which would otherwise be executed by the ramdisk automatically. Specifically, you need to enter everything below the line "Running in single-user mode" in the file overlays/ramdisk/init.sh (or variants thereof). If you just exit the shell without doing this, then the system will be unable to continue booting. +::: ## Graphical desktop start process -1. The system is configured in `/etc/rc.conf` to start the `slim` login manager. This also results in Xorg being started -1. `slim` is configured in `/usr/local/etc/slim.conf` to start `start-hello` once the user has logged in, or if autologin has occurred -1. The `/usr/local/bin/start-hello` shell script starts the various components of the helloSystem desktop +1. The system is configured in {file}`/etc/rc.conf` to start the `slim` login manager. This also results in Xorg being started +2. `slim` is configured in {file}`/usr/local/etc/slim.conf` to start `start-hello` once the user has logged in, or if autologin has occurred +3. The {file}`/usr/local/bin/start-hello` shell script starts the various components of the helloSystem desktop ### Troubleshooting the graphical desktop start process -* Login manager (`slim`) says __Failed to execute login command__. Check the `/usr/local/bin/start-hello` shell script. +* Login manager (`slim`) says __Failed to execute login command__. Check the {file}`/usr/local/bin/start-hello` shell script. ## Installed system boot process @@ -227,7 +227,7 @@ The boot process is the regular FreeBSD boot process. Please refer to [The FreeB ## Boot Mute -Setting `boot_mute="YES"` in `/boot/loader.conf` causes FreeBSD to show a boot splash screen instead of kernel messages during early boot. However, as soon as scripts from the ramdisk and init get executed, they tend to write output to the screen and manipulate it with `vidcontrol` and `conscontrol`, which results in the boot splash screen to disappear before the graphical desktop environment is started. +Setting `boot_mute="YES"` in {file}`/boot/loader.conf` causes FreeBSD to show a boot splash screen instead of kernel messages during early boot. However, as soon as scripts from the ramdisk and init get executed, they tend to write output to the screen and manipulate it with `vidcontrol` and `conscontrol`, which results in the boot splash screen to disappear before the graphical desktop environment is started. Since helloSystem targets a broad audience including non-technical users, the following behavior is intended: * By default, show no textual boot messages @@ -237,15 +237,15 @@ Since helloSystem targets a broad audience including non-technical users, the fo To achieve this, helloSystem uses a combination of the following techniques: * Read the `boot_mute` kernel environment variable and adjust the userland boot process accordingly -* Modify `/etc/rc` to run `conscontrol delete ttyv0` and redirect all of its output to `/dev/null` if `boot_mute` is set to `YES` -* Modify `/etc/rc.shutdown` to redirect all of its output to `/dev/null` if `boot_mute` is set to `YES` +* Modify {file}`/etc/rc` to run `conscontrol delete ttyv0` and redirect all of its output to `/dev/null` if `boot_mute` is set to `YES` +* Modify {file}`/etc/rc.shutdown` to redirect all of its output to `/dev/null` if `boot_mute` is set to `YES` * Replace the `/sbin/vidcontrol` command by a dummy that does nothing to prevent error messages related to setting the resolution of the text-mode console from ending the boot splash early -* Replace the `/etc/ttys` file with an empty file to not spawn login shells on the text-mode console -* Commenting out the line that ends in `/dev/console` in `/etc/syslog.conf` to prevent boot from being visually interrupted by `syslog` messages +* Replace the {file}`/etc/ttys` file with an empty file to not spawn login shells on the text-mode console +* Commenting out the line that ends in `/dev/console` in {file}`/etc/syslog.conf` to prevent boot from being visually interrupted by `syslog` messages * On the Live system, modify all scripts in the ramdisk to redirect all of their output to `/dev/null` if `boot_mute` is set to `YES` -``` .. note:: - Please note that if any errors are displayed on the screen during the boot process, the boot splash may still end early. In this case, the reason for the error message needs to be identified, and the message needs to be silenced. -``` +:::{note} +Please note that if any errors are displayed on the screen during the boot process, the boot splash may still end early. In this case, the reason for the error message needs to be identified, and the message needs to be silenced. +::: -To see boot messages, set `boot_mute="NO"` in `/boot/loader.conf` or at the bootloader prompt. +To see boot messages, set `boot_mute="NO"` in {file}`/boot/loader.conf` or at the bootloader prompt. diff --git a/developer/building.md b/developer/building.md index 3719e65b..eb57c90e 100644 --- a/developer/building.md +++ b/developer/building.md @@ -21,28 +21,28 @@ However, it is also possible to build the ISO locally, which is especially handy ## Building the Live ISO -``` -sudo pkg install -y pkg git-lite zsync wget sha bash zip devel/py-xdg librsvg2 ca_root_nss -git clone https://github.com/helloSystem/ISO -cd ISO -sudo ./build.sh hello +```console +$ sudo pkg install -y pkg git-lite zsync wget sha bash zip devel/py-xdg librsvg2 ca_root_nss +$ git clone https://github.com/helloSystem/ISO +$ cd ISO +$ sudo ./build.sh hello ``` -The resulting Live ISO will be located at `/usr/local/furybsd/iso/`. +The resulting Live ISO will be located at {file}`/usr/local/furybsd/iso/`. ## Writing Live Media to USB drive -``` -sudo dd if=/usr/local/furybsd/iso/FuryBSD-12.1-XFCE.iso of=/dev/daX bs=4m status=progress +```console +$ sudo dd if=/usr/local/furybsd/iso/FuryBSD-12.1-XFCE.iso of=/dev/daX bs=4m status=progress ``` Replace `daX` with the respective device name. -``` .. warning:: - This will overwrite the entire contents of the selected device. Take extra caution when determining the device name. - - This operation cannot be undone. -``` +:::{warning} +This will overwrite the entire contents of the selected device. Take extra caution when determining the device name. + +This operation cannot be undone. +::: For end users, there is the __Create Live Media__ application that can conveniently download and write Live Media with a graphical user interface. @@ -50,9 +50,9 @@ For end users, there is the __Create Live Media__ application that can convenien You can use the `cdrecord` command line tool to burn Live Media to DVD. -``` -pkg install cdrtools -cdrecord /usr/local/furybsd/iso/.iso +```console +# pkg install cdrtools +# cdrecord /usr/local/furybsd/iso/.iso ``` ## Customizing the Live ISO @@ -83,10 +83,10 @@ Configuration is applied using _transient packages_ that get generated on-the-fl * Overlays for the initial ramdisk are stored in `overlays/ramdisk` * Overlays for the main filesystem are stored in `overlays/uzip//files/`. Note that to be included in a build, the overlay called `` must be listed in `settings/overlays.`. Substitute `` with `hello` or one of the desktop environments mentioned above. -For example, a file that is supposed to appear in `/usr/local/bin/app` on the main filesystem could be stored in `overlays/uzip/hello/files/usr/local/bin/app`. +For example, a file that is supposed to appear in {file}`/usr/local/bin/app` on the main filesystem could be stored in {file}`overlays/uzip/hello/files/usr/local/bin/app`. ### Customizing the build script -If a file called `settings/script.` exists, then it will be executed during the build. Substitute `` with `hello` or one of the desktop environments mentioned above. For building helloSystem, `settings/script.hello` performs actions such as installing applications that are not coming from FreeBSD packages, setting the wallpaper, installing fonts that are not coming from FreeBSD, and so on. +If a file called {file}`settings/script.` exists, then it will be executed during the build. Substitute `` with `hello` or one of the desktop environments mentioned above. For building helloSystem, {file}`settings/script.hello` performs actions such as installing applications that are not coming from FreeBSD packages, setting the wallpaper, installing fonts that are not coming from FreeBSD, and so on. All desktop-specific build steps should go into this file. diff --git a/developer/developer-tools.md b/developer/developer-tools.md index cce398e9..bb8ef78d 100644 --- a/developer/developer-tools.md +++ b/developer/developer-tools.md @@ -4,18 +4,9 @@ Starting with helloSystem 0.7.0, compilers, headers, `.o` files and other files The __Developer__ folder in the __Applications__ folder contains useful development tools for use with helloSystem. -* __PyCharm CE__: A powerful integrated development environment (IDE) for the Python language which is used for -many of the utilities and preferences applications in helloSystem -* __Qt Creator__: The integrated development environment (IDE) for Qt-based applications, such as Menu, Dock, and Filer. -Includes graphical user interface editors for QtWidgets-based user interfaces (such as Menu and Filer) using `.ui` files -and for Qml-based user interfaces (such as Dock) using `.qml` files. -The user interfaces generated in Qt Creator can be used in Qt application written in C++ or Python -* __LiteIDE__: An integrated development environment (IDE) for the Go language. Go is recommended -for long-running processes such as servers and for processes with parallelism -* __Zeal__: A browser for documentation sets, also known as "docsets". Docsets can be downloaded from within the application -and are available for many languages and environments, including Python, Qt, and Go. +* __PyCharm CE__: A powerful integrated development environment (IDE) for the Python language which is used for many of the utilities and preferences applications in helloSystem +* __Qt Creator__: The integrated development environment (IDE) for Qt-based applications, such as Menu, Dock, and Filer. Includes graphical user interface editors for QtWidgets-based user interfaces (such as Menu and Filer) using `.ui` files and for Qml-based user interfaces (such as Dock) using `.qml` files. The user interfaces generated in Qt Creator can be used in Qt application written in C++ or Python +* __LiteIDE__: An integrated development environment (IDE) for the Go language. Go is recommended for long-running processes such as servers and for processes with parallelism +* __Zeal__: A browser for documentation sets, also known as "docsets". Docsets can be downloaded from within the application and are available for many languages and environments, including Python, Qt, and Go. -To minimize the initial download size of the helloSystem image, the applications in the Developer folder -need to be downloaded prior to first use. You will be guided through this automatic process when you launch these -applications for the first time. After the applications have been downloaded, you can use them without an active -network connection. +To minimize the initial download size of the helloSystem image, the applications in the Developer folder need to be downloaded prior to first use. You will be guided through this automatic process when you launch these applications for the first time. After the applications have been downloaded, you can use them without an active network connection. diff --git a/developer/distributions.md b/developer/distributions.md index e7142136..9bf58ce6 100644 --- a/developer/distributions.md +++ b/developer/distributions.md @@ -10,6 +10,6 @@ __Please do not call your derivatives "hello" or "helloSystem"__. In order to ke You may want to include the desktop components of helloSystem, the **helloDesktop** "Desktop Environment" (collection of individual components, really). -For example, work is being done to bring the helloDesktop components to FreeBSD: https://wiki.freebsd.org/helloDesktop. But please note that "FreeBSD with helloDesktop" is not the same as helloSystem. +For example, work is being done to bring the helloDesktop components to FreeBSD: . But please note that "FreeBSD with helloDesktop" is not the same as helloSystem. Please do not hesitate to contact the team if you have questions regarding this policy. diff --git a/developer/filer-context-menus.md b/developer/filer-context-menus.md index 63a102fa..876fedf3 100644 --- a/developer/filer-context-menus.md +++ b/developer/filer-context-menus.md @@ -2,15 +2,15 @@ It is possible to extend Filer context menu items by writing files that conform to the __DES-EMA__ (Desktop Entry Specification - Extension for Menus and Actions). Apparently this format was never adopted as a standard, so it is documented here. The information on this page is based on [draft 0.15](https://gitlab.gnome.org/GNOME/filemanager-actions/-/blob/NAUTILUS_ACTIONS_3_2_4/docs/des-ema/des-ema-0.15) from November 23, 2010. -``` .. note:: - Filer inherits its DES-EMA implementation from PCManFM, but may use a different format in the future. - - It still needs to be verified which portions have actually been implemented in Filer, so currently this page describes functionality which may or may not be implemented in Filer. Corrections are welcome. -``` +:::{note} +Filer inherits its DES-EMA implementation from PCManFM, but may use a different format in the future. + +It still needs to be verified which portions have actually been implemented in Filer, so currently this page describes functionality which may or may not be implemented in Filer. Corrections are welcome. +::: Changes take effect after a restart of Filer. To restart Filer: -1. Press Ctrl+Alt+Esc and click on the Desktop to force-quit it -2. Press Alt+F2 and enter `launch Filer --desktop` to start it again +1. Press {kbd}`Ctrl+Alt+Esc` and click on the Desktop to force-quit it +2. Press {kbd}`Alt+F2` and enter `launch Filer --desktop` to start it again ## Examples @@ -18,7 +18,7 @@ Changes take effect after a restart of Filer. To restart Filer: In the following example, we define an "Open terminal here" action, which has three profiles. These profiles are thought to be able to open a suitable terminal in most situations. They are ordered, and so only the first profile whose conditions are met at runtime will be used in the Filer context menu. -``` +```text [Desktop Entry] Name=Open terminal here Tooltip=Open a new terminal here @@ -43,7 +43,7 @@ Schemes=x-nautilus-desktop; Exec=launch QTerminal --workdir ~/Desktop ``` -This may be saved, e.g. as `~/.local/share/file-manager/actions/open-terminal.desktop` file. +This may be saved, e.g. as {file}`~/.local/share/file-manager/actions/open-terminal.desktop` file. Note that this is only an example of how an action may be defined in a `.desktop` file. It has not been deeply tested, and there is most probably more efficient ways of opening a terminal somewhere... @@ -51,7 +51,7 @@ Note that this is only an example of how an action may be defined in a `.desktop Suppose we would like to place the menu elements into a submenu. To achieve this, we create a second `.desktop` file with following content: -``` +```text [Desktop Entry] Type=Menu Name=Terminal menu @@ -60,7 +60,7 @@ Icon=terminal-group ItemsList=open-terminal; ``` -This may be saved, e.g. as `~/.local/share/file-manager/actions/menu-terminal.desktop` file. +This may be saved, e.g. as {file}`~/.local/share/file-manager/actions/menu-terminal.desktop` file. ## Desktop file @@ -68,11 +68,11 @@ This may be saved, e.g. as `~/.local/share/file-manager/actions/menu-terminal.de This specification relies on the common syntax defined in the [Desktop Entry Specification](http://standards.freedesktop.org/desktop-entry-spec/desktop-entry-spec-latest.html). Here is a summary of some main points: -* Files are UTF-8 encoded. -* All keys and values are case sensitive. -* The `[Desktop Entry]` group must be the first group of the file. -* Boolean values must be `true` or `false`. -* Strings, in strings lists, are semicolon-separated; the list itself ends with a semicolon. +* Files are UTF-8 encoded. +* All keys and values are case sensitive. +* The `[Desktop Entry]` group must be the first group of the file. +* Boolean values must be `true` or `false`. +* Strings, in strings lists, are semicolon-separated; the list itself ends with a semicolon. #### Desktop file identifier @@ -80,7 +80,7 @@ In the rest of this specification, when a desktop file needs to be identified, w #### Desktop files search path -`.desktop` files are searched for in `XDG_DATA_DIRS/file-manager/actions` directories. All used _desktop_file_id_s should be unique. +`.desktop` files are searched for in {file}`XDG_DATA_DIRS/file-manager/actions` directories. All used _desktop_file_id_s should be unique. ## Managed objects @@ -317,19 +317,20 @@ Defaults to `Name` value. The ordered list of the profiles attached to this action. Each element of this strings list may be: -* a _profile_id_, _i.e._ the id of a profile, as an ASCII string -* a command to be executed, if the string is enclosed between square brackets (`[`...`]`). +* a `_profile_id_`, _i.e._ the id of a profile, as an ASCII string +* a command to be executed, if the string is enclosed between square brackets (`[`...`]`). So, `Profiles` key has a dynamic value: if an element of the string list is enclosed between square brackets (`[`...`]`), it is considered as a command, optionally with After reading, and maybe evaluation of dynamic elements, profiles identified by the `Profiles` value, but not found in this `.desktop` file, are just ignored. It is up to the implementation to decide whether profiles found in this `.desktop` file, but not identified in this list, should or not be attached to the action. -It could be for example an acceptable fallback to append these "orphan" profiles at the end of the list of profiles. +It could be for example an acceptable fallback to append these "orphan" profiles at the end of the list of profiles. + Another choice might also be: -* at runtime, only attach to the action profiles which are listed in this `Profiles` key -* while a management UI may load all profiles found in the `.desktop` file. +* at runtime, only attach to the action profiles which are listed in this `Profiles` key +* while a management UI may load all profiles found in the `.desktop` file. @@ -491,7 +492,7 @@ It is the responsibility of the implementation to ensure that the displayed menu As stated -The menu is so defined as a particular case of a `.desktop` file, identified by its _desktop_file_id_, whose the `[Desktop Entry]` section has following keys: +The menu is so defined as a particular case of a `.desktop` file, identified by its `desktop_file_id`, whose the `[Desktop Entry]` section has following keys:
`Schemes` The list of schemes the selection must satisfy in order the item be selected. -Exemples of well-known schemes are: +Examples of well-known schemes are: * `file` * `sftp` @@ -939,7 +939,7 @@ Please note that each element of the specified list must be considered as ANDed, Capabilities have to be chosen between following predefined ones: * `Owner`: current user is the owner of the selected items -* `Readable`: selected items are readable by user (probably more usefull when negated) +* `Readable`: selected items are readable by user (probably more useful when negated) * `Writable`: selected items are writable by user * `Executable`: selected items are executable by user * `Local`: selected items are local @@ -1040,7 +1040,7 @@ Example: > > Nonetheless, mixing singular and plural forms, though we warn against, is not an error. As a counter example, there may be some situations where a command-line of the form `echo %B %d` would be useful. In that case, the following command would be run: > `echo pierre paul jacques /data` -> It is left as an exercize for the reader to find a use case. +> It is left as an exercise for the reader to find a use case. The word "first" in the following table makes so reference to the case where the singular form parameter is used in a plural form command. We recall one more time that which is the "first" element is not specified, and, most probably, rather unpredictable. @@ -1375,15 +1375,15 @@ ignored else
@@ -997,16 +998,16 @@ Actually, the command defined in the `Exec` key will be executed once, or repeat Though some parameters are not sensible to the count of the selection (e.g. `%c`, the selection count itself), most have two declensions: -* a "singular" one, e.g. `%b`, the basename of the selected item -* a "plural" one, e.g. `%B`, a space-separated list of the basenames of selected items +* a "singular" one, e.g. `%b`, the basename of the selected item +* a "plural" one, e.g. `%B`, a space-separated list of the basenames of selected items When the selection is empty or contains only one element, and from this topic point of view, these two forms are exactly equivalent. When the selection contains more than one item: -* if the first relevant parameter found in the `Exec` key is of a singular form, then the implementation should consider that the command is only able to deal with one item at a time, and thus that it has to be ran one time for each selected item; -* contrarily, if the first relevant parameter found is of the plural form, then the implementation should consider that the command is able to deal with a list of items, and thus the command should be executed only once; -* if all found parameters are "irrelevant", then the default is to consider that the command should be executed only once. +* if the first relevant parameter found in the `Exec` key is of a singular form, then the implementation should consider that the command is only able to deal with one item at a time, and thus that it has to be ran one time for each selected item; +* contrarily, if the first relevant parameter found is of the plural form, then the implementation should consider that the command is able to deal with a list of items, and thus the command should be executed only once; +* if all found parameters are "irrelevant", then the default is to consider that the command should be executed only once. Example: @@ -1379,27 +1380,25 @@ The processus described here is only a sort of meta-algorithm, whose only goal i The implementer might take advantage of preparing once the whole hierarchy of the menus and actions: -* to minimize the time spent in the parsing of all files; -* to identify and eliminate duplicate _desktop_file_id_s, -* to eliminate invalid menus and actions. - -1. as described in desktop_file_ids and invalid `.desktop` files; implementation so obtains a flat list of menus or actions; +* to minimize the time spent in the parsing of all files; +* to identify and eliminate duplicate _desktop_file_id_s, +* to eliminate invalid menus and actions. +1. as described in desktop_file_ids and invalid `.desktop` files; implementation so obtains a flat list of menus or actions; 2. recursively build the hierarchy; this merely consists in the build of the hierarchy as a tree of menus and actions, where each _desktop_file_id_ addressed as the subitem of a menu consumes this same id from the flat list - * if the level-zero order (which is not specified here, but see desktop_file_id addressed in the level zero consumes this same id from the flat list; - * else, if might be reasonable to start with an empty tree; - + * if the level-zero order (which is not specified here, but see desktop_file_id addressed in the level zero consumes this same id from the flat list; + * else, if might be reasonable to start with an empty tree; 3. at the end, implementation stays with: - * the output tree with some menus at the root; - * some actions, left in the input flat list because they were not addressed by any menu; these left actions should be added to the level zero of the hierarchy (though in a unspecified order) - * some menus, left in the input flat list because their subitems were not found; as these menus happen to be empty, they must be considered as invalid. + * the output tree with some menus at the root; + * some actions, left in the input flat list because they were not addressed by any menu; these left actions should be added to the level zero of the hierarchy (though in a unspecified order) + * some menus, left in the input flat list because their subitems were not found; as these menus happen to be empty, they must be considered as invalid. After this built phase, the resultant tree only contains valid (before runtime parameters expansion) menus and actions. So, menus or actions may appear at the level zero of the whole hierarchy for only two reasons: -1. because they are explicitly addressed by the level-zero configuration, if the implementation defines it; this may concern menus and actions; -2. because these items were not addressed by any menu (but this may only concern actions). +1. because they are explicitly addressed by the level-zero configuration, if the implementation defines it; this may concern menus and actions; +2. because these items were not addressed by any menu (but this may only concern actions). ## The level-zero case @@ -1407,7 +1406,7 @@ Though not strictly an action or a menu definition, the level-zero issue might b Ordering the elements which have to be displayed at the level-zero of the Filer context menu is just a particular case of a menu definition. -An implementation might define a `level-zero.directory` file, which would contain the ordered list of level zero items identified by their _desktop_file_id_. +An implementation might define a `level-zero.directory` file, which would contain the ordered list of level zero items identified by their `desktop_file_id`. The `[Desktop Entry]` section of this `level-zero.directory` file would so have only one of the following keys: @@ -1451,19 +1450,19 @@ The name `level-zero.directory` is chosen to not risk any collision with regular ## References -* [Desktop Entry Specification](http://standards.freedesktop.org/desktop-entry-spec/desktop-entry-spec-latest.html) -* [Desktop Menu Specification](http://standards.freedesktop.org/menu-spec/menu-spec-latest.html) -* [XDG Base Directory Specification](http://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html) -* [Creating Konqueror Service Menus](http://developer.kde.org/documentation/tutorials/dot/servicemenus.html) -* [Krusader UserActions](http://www.krusader.org/handbook/useractions.html) -* [Thunar Custom Actions](http://thunar.xfce.org/pwiki/documentation/custom_actions) +* [Desktop Entry Specification](http://standards.freedesktop.org/desktop-entry-spec/desktop-entry-spec-latest.html) +* [Desktop Menu Specification](http://standards.freedesktop.org/menu-spec/menu-spec-latest.html) +* [XDG Base Directory Specification](http://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html) +* [Creating Konqueror Service Menus](http://developer.kde.org/documentation/tutorials/dot/servicemenus.html) +* [Krusader UserActions](http://www.krusader.org/handbook/useractions.html) +* [Thunar Custom Actions](http://thunar.xfce.org/pwiki/documentation/custom_actions) ## Contributors -* Jonas Bähr -* David Faure -* Ted Gould -* Hong Jen Yee "PCMan" -* Michael Pyne -* Liam R. E. Quin -* Pierre Wieser +* Jonas Bähr +* David Faure +* Ted Gould +* Hong Jen Yee "PCMan" +* Michael Pyne +* Liam R. E. Quin +* Pierre Wieser diff --git a/developer/geom_rowr.md b/developer/geom_rowr.md index 7c90c0b5..e9323338 100644 --- a/developer/geom_rowr.md +++ b/developer/geom_rowr.md @@ -2,9 +2,9 @@ The `geom_rowr` kernel module for FreeBSD makes a read-only device writable by combining it with a read-write device. -``` .. note:: - This kernel module is currently under development and is being tested for adoption in helloSystem. -``` +:::{note} +This kernel module is currently under development and is being tested for adoption in helloSystem. +::: ## Use case @@ -27,33 +27,33 @@ As a result, immediately after creating the combined device, it appears to conta Execute the following commands as root: -``` -# Prepare filesystem image -dd if=/dev/zero of=test.img bs=1M count=512 -mdconfig -a -t vnode -f test.img -u 9 -newfs /dev/md9 -mount /dev/md9 /mnt -# Populate the filesystem -cp -R /boot/ /mnt -umount /mnt -mdconfig -d -u 9 - -# Load kernel module -kldload ./geom_rowr.ko -# prepare the read-only device md0 -mdconfig -a -t vnode -o readonly -f test.img -u 0 -# prepare the read-write device md1 -mdconfig -a -t swap -s 512M -u 1 -# Make sure the geom(8) tool will find the .so -cp geom_rowr.so /lib/geom -# Create the new device that combines md0 and md1 -geom rowr create rowr0 md0 md1 -mount /dev/rowr0 /mnt - -# See that the files are already there -ls /mnt -# make changes to the filesystem to see that it is read-write -mv /mnt/*.4th /mnt/lua; rm /mnt/pxeboot +```console +// Prepare filesystem image +# dd if=/dev/zero of=test.img bs=1M count=512 +# mdconfig -a -t vnode -f test.img -u 9 +# newfs /dev/md9 +# mount /dev/md9 /mnt +// Populate the filesystem +# cp -R /boot/ /mnt +# umount /mnt +# mdconfig -d -u 9 + +// Load kernel module +# kldload ./geom_rowr.ko +// prepare the read-only device md0 +# mdconfig -a -t vnode -o readonly -f test.img -u 0 +// prepare the read-write device md1 +# mdconfig -a -t swap -s 512M -u 1 +// Make sure the geom(8) tool will find the .so +# cp geom_rowr.so /lib/geom +// Create the new device that combines md0 and md1 +# geom rowr create rowr0 md0 md1 +# mount /dev/rowr0 /mnt + +// See that the files are already there +# ls /mnt +// make changes to the filesystem to see that it is read-write +# mv /mnt/*.4th /mnt/lua; rm /mnt/pxeboot ``` ## Use in the Live ISO boot process @@ -81,22 +81,22 @@ A swap-backed `md` device consumes close to zero memory when created and grows i Because `reroot` cannot be made to work with `geom_rowr` at this time, we need to use `chroot`. -When using `chroot`, some kernel modules that load firmware (e.g., for Intel WLAN drivers) fail to load the firmware if the places where kernel modules are located - `/boot/kernel` and `/boot/modules` - will look differently inside vs. outside the chroot. +When using `chroot`, some kernel modules that load firmware (e.g., for Intel WLAN drivers) fail to load the firmware if the places where kernel modules are located - {file}`/boot/kernel` and {file}`/boot/modules` - will look differently inside vs. outside the chroot. This can be fixed. Recommended way (to be tested): -Provided that `ramdisk.ufs` does not contain `/boot`, create a symlink on `ramdisk.ufs` from `/boot` to `/sysroot/boot`. The symlink can be made at image creation time or by a script that runs at runtime. This combined with the *default* `kern.module_path` should be enough to create a common view between the kernel and chrooted userland utilities. The places where kernel modules are located - `/boot/kernel` and `/boot/modules` - will look the same inside and outside of the chroot. +Provided that `ramdisk.ufs` does not contain {file}`/boot`, create a symlink on `ramdisk.ufs` from {file}`/boot` to {file}`/sysroot/boot`. The symlink can be made at image creation time or by a script that runs at runtime. This combined with the *default* `kern.module_path` should be enough to create a common view between the kernel and chrooted userland utilities. The places where kernel modules are located - {file}`/boot/kernel` and {file}`/boot/modules` - will look the same inside and outside of the chroot. Alternative way (known to work): -``` -mkdir -p /sysroot/sysroot/boot # Needed? -mount -t nullfs /sysroot/boot /sysroot/sysroot/boot # Needed? +```console +# mkdir -p /sysroot/sysroot/boot # Needed? +# mount -t nullfs /sysroot/boot /sysroot/sysroot/boot # Needed? -echo "==> Set kernel module path for chroot" -sysctl kern.module_path=/sysroot/boot/kernel +# echo "==> Set kernel module path for chroot" +# sysctl kern.module_path=/sysroot/boot/kernel ``` ### ZFS @@ -107,7 +107,7 @@ With ZFS there is a problem unrelated to the `geom_rowr` code. When ZFS performs ## License -``` +```text geom_rowr.ko, geom_rowr.so: Copyright (c) 2021, Jordan Gordeev ``` diff --git a/developer/graphics.md b/developer/graphics.md index 1d7abeb6..97461125 100644 --- a/developer/graphics.md +++ b/developer/graphics.md @@ -6,7 +6,7 @@ helloSystem uses `initgfx` for the automatic configuration of the graphics hardw `initgfx` consists of the following files and directories: -``` +```text /etc/rc.d/initgfx /etc/initgfx_device.db /etc/initgfx_xorg.cfg @@ -29,8 +29,8 @@ driver depending on whether the system was booted via BIOS or EFI. If everything goes well, then after running `sudo sysctl initgfx start` you should have (example: Nvidia): -``` -% cat /usr/local/etc/X11/xorg.conf.d/00-video-initgfx.conf +```console +$ cat /usr/local/etc/X11/xorg.conf.d/00-video-initgfx.conf Section "Device" Identifier "NVIDIA CARD" VendorName "NVIDIA Corporation" @@ -66,7 +66,7 @@ Different versions of the Nvidia drivers exist. Unfortunately the latest version To check this: -``` -% cat /etc/rc.conf | grep initgfx_kmods +```console +$ cat /etc/rc.conf | grep initgfx_kmods initgfx_kmods="/usr/local/nvidia/390/boot/modules/nvidia.ko /usr/local/nvidia/390/boot/modules/nvidia-modeset.ko" ``` diff --git a/developer/linux.md b/developer/linux.md index e3b42315..21748aad 100644 --- a/developer/linux.md +++ b/developer/linux.md @@ -4,9 +4,9 @@ helloSystem is designed for use with helloSystem, which is based on FreeBSD. However, developers may want to verify that the code is reasonably platform independent by building on Linux from time to time. -``` .. note:: - That the code build does not necessarily mean that it works properly on Linux or that all features are implemented for Linux. -``` +:::{note} +That the code build does not necessarily mean that it works properly on Linux or that all features are implemented for Linux. +::: ## Building in a chroot on a FreeBSD host @@ -15,53 +15,53 @@ To verify that the code builds on Linux without needing a different development Beginning with build 0H165, helloSystem ships with an [alpine rc.d script](https://github.com/helloSystem/ISO/blob/experimental/overlays/uzip/hello/files/usr/local/etc/rc.d/alpine). When started for the first time, this downloads a minimal root filesystem. -``` -sudo service linux stop -sudo service debian stop -sudo service alpine onestart -sudo chroot /compat/alpine /bin/sh +```console +$ sudo service linux stop +$ sudo service debian stop +$ sudo service alpine onestart +$ sudo chroot /compat/alpine /bin/sh ``` In the chroot, build the essential helloSystem components -``` -# launch, open, and other essential command line tools that are required -git clone https://github.com/helloSystem/launch -mkdir -p launch/build -cd launch/build -grep ^apk ../README.md | sh -cmake .. -sudo make -j $(nproc) install -cd ../../ - -# Menu -git clone https://github.com/helloSystem/Menu -mkdir -p Menu/build -cd Menu/build -grep ^apk ../README.md | sh -cmake .. -sudo make -j $(nproc) install -cd ../../ - -# Filer -git clone https://github.com/helloSystem/Filer -mkdir -p Filer/build -cd Filer/build -grep ^apk ../README.md | sh -cmake .. -sudo make -j $(nproc) install -cd ../../ +```console +// launch, open, and other essential command line tools that are required +$ git clone https://github.com/helloSystem/launch +$ mkdir -p launch/build +$ cd launch/build +$ grep ^apk ../README.md | sh +$ cmake .. +$ sudo make -j $(nproc) install +$ cd ../../ + +// Menu +$ git clone https://github.com/helloSystem/Menu +$ mkdir -p Menu/build +$ cd Menu/build +$ grep ^apk ../README.md | sh +$ cmake .. +$ sudo make -j $(nproc) install +$ cd ../../ + +// Filer +$ git clone https://github.com/helloSystem/Filer +$ mkdir -p Filer/build +$ cd Filer/build +$ grep ^apk ../README.md | sh +$ cmake .. +$ sudo make -j $(nproc) install +$ cd ../../ ``` After you are done, -``` -sudo service alpine onestop +```console +$ sudo service alpine onestop ``` -``` .. note:: - If the compiler crashes, make sure that /usr/bin/clang++ is being used rather than /usr/bin/c++. This can be edited in CMakeCache.txt. -``` +:::{note} +If the compiler crashes, make sure that {file}`/usr/bin/clang++` is being used rather than {file}`/usr/bin/c++`. This can be edited in CMakeCache.txt. +::: ## Running helloDesktop on Linux @@ -73,13 +73,16 @@ Run Alpine Linux, e.g., in VirtualBox on helloSystem, or on real hardware. * Enable community repo by `sed -i -e 's|^#||g' /etc/apk/repositories` * Install KDE Plasma using `setup-desktop`; set up a user * `rc-update add sddm` and `rc-service sddm start` -* Log into a KDE Plasma session on Alpine Linux. __Important:__ Select X11 session. Wayland doesn't work smoothly +* Log into a KDE Plasma session on Alpine Linux. + :::{important} + Select X11 session. Wayland doesn't work smoothly + ::: * Optionally, install VirtualBox related guest packages using `apk search` and `apk add` * `sudo su` to become root (there is no `sudo` configured on Alpine Linux by default) * Build and `make install` the three core components of helloDesktop (launch, Menu, and Filer) as above * From within the running KDE Plasma session, you can switch to the minimal helloDesktop with -``` +```sh #!/bin/sh launch Menu & @@ -94,18 +97,18 @@ The result will look somewhat like this: ![Screenshot](https://user-images.githubusercontent.com/2480569/200421869-96f81c37-0785-4416-ae43-bee920dd6a3e.png) -``` .. note:: - That the code runs does not necessarily mean that it works properly on Linux or that all features are implemented for Linux. Please keep in mind that for the best desktop experience, you should be using helloSystem which helloDesktop has been designed for. -``` +:::{note} +That the code runs does not necessarily mean that it works properly on Linux or that all features are implemented for Linux. Please keep in mind that for the best desktop experience, you should be using helloSystem which helloDesktop has been designed for. +::: ## Building and running helloDesktop on Raspberry Pi -Loosely follow https://wiki.alpinelinux.org/wiki/Classic_install_or_sys_mode_on_Raspberry_Pi (not all commands seem to be working exactly as written anymore), but also create "Linux Swap" partition. Alternatively, in the running Alpine Linux system +Loosely follow (not all commands seem to be working exactly as written anymore), but also create "Linux Swap" partition. Alternatively, in the running Alpine Linux system -``` -fallocate -l 8G /swapfile -mkswap /swapfile -swapon /swapfile +```console +# fallocate -l 8G /swapfile +# mkswap /swapfile +# swapon /swapfile ``` to have enough RAM or else the compilation will be killed (at least on the 1GB and less RAM models). diff --git a/developer/localization.md b/developer/localization.md index 2fcdfa3d..1a621964 100644 --- a/developer/localization.md +++ b/developer/localization.md @@ -2,9 +2,7 @@ helloSystem is localized on [Hosted Weblate](https://hosted.weblate.org/projects/hellosystem/). - -Translation status - +[![Translation status](https://hosted.weblate.org/widgets/hellosystem/-/multi-auto.svg)](https://hosted.weblate.org/engage/hellosystem/) ## Contributing translations @@ -22,7 +20,7 @@ Follow the best practices for internationalization of Qt projects. To be documen helloSystem uses `tstranslator.py` to translate applications using Qt `.ts` files without the need for compilation. To achieve this, import and set up tstranslator as follows: -``` +```py # Translate this application using Qt .ts files without the need for compilation import tstranslator tstr = tstranslator.TsTranslator(os.path.dirname(__file__) + "/i18n", "") @@ -32,7 +30,7 @@ def tr(input): In the class that defines your MainWindow or Wizard, do the following: -``` +```py class Wizard(QtWidgets.QWizard, object): def __init__(self): (...) @@ -45,18 +43,18 @@ class Wizard(QtWidgets.QWizard, object): To make new strings available for translation, a developer runs in the respective application directory: -``` -cd Resources/ -mkdir -p i18n +```console +$ cd Resources/ +$ mkdir -p i18n -# Create/update .ts file for English -pylupdate5 -noobsolete *.{py,ui} -ts i18n/en.ts +// Create/update .ts file for English +$ pylupdate5 -noobsolete *.{py,ui} -ts i18n/en.ts -# Remove unneeded location tags -xml ed -L -d '//location' i18n/en.ts +// Remove unneeded location tags +$ xml ed -L -d '//location' i18n/en.ts -# Remove translations from en, since en is not to be further translated -xml ed -L -d '//translation' i18n/en.ts +// Remove translations from en, since en is not to be further translated +$ xml ed -L -d '//translation' i18n/en.ts ``` Translators do not need to do this. diff --git a/developer/man.md b/developer/man.md index 737fff5b..477241ae 100644 --- a/developer/man.md +++ b/developer/man.md @@ -2,26 +2,26 @@ Command line tools should be shipped with man pages. -``` .. note:: - To make fullest use of all features, man pages should be written in their native markup language, mdoc. - - However, this has a quite steep learning curve, so the following can be used to get started quickly. -``` +:::{note} +To make fullest use of all features, man pages should be written in their native markup language, mdoc. + +However, this has a quite steep learning curve, so the following can be used to get started quickly. +::: One way to create man pages from Markdown is by using `pandoc` and the template from https://github.com/pragmaticlinuxblog/pandocmanpage. To convert Markdown to man: -``` -pandoc Desktop/launch.1.md -s -t man -o Desktop/launch.1 -/usr/bin/man ~/Desktop/launch.1 +```console +$ pandoc Desktop/launch.1.md -s -t man -o Desktop/launch.1 +$ /usr/bin/man ~/Desktop/launch.1 ``` To convert man to txt: -``` -/usr/bin/man ~/Desktop/launch.1 | col -b > ~/Desktop/launch.txt +```console +$ /usr/bin/man ~/Desktop/launch.1 | col -b > ~/Desktop/launch.txt ``` ## Order of sections diff --git a/developer/menu.md b/developer/menu.md index a7664128..bfbf8580 100644 --- a/developer/menu.md +++ b/developer/menu.md @@ -6,11 +6,11 @@ To provide this unified user experience, it is crucial that all applications can ## Terminology -``` .. note:: - Consistent, up-to-date documentation regarding the subject of global menus is hard to find. +:::{note} +Consistent, up-to-date documentation regarding the subject of global menus is hard to find. - Please consider submitting issues and pull requests if you can contribute to this subject. -``` +Please consider submitting issues and pull requests if you can contribute to this subject. +::: ### Concepts @@ -51,15 +51,15 @@ Those may or may not be used in helloSystem, they are mentioned here to give an The following libraries are involved in allowing applications to show their menu items in the global menu. -``` .. note:: - This list is probably incomplete. +:::{note} +This list is probably incomplete. - Please consider submitting issues and pull requests if you can contribute to this subject. -``` +Please consider submitting issues and pull requests if you can contribute to this subject. +::: ### libappindicator -``` +```text /usr/local/lib/libappindicator3.so.1 /usr/local/lib/libappindicator3.so.1.0.0 /usr/local/lib/libappindicator3.so @@ -77,7 +77,7 @@ The following libraries are involved in allowing applications to show their menu ### libappmenu-gtk-module library from vala-panel-appmenu repository -``` +```text /usr/local/lib/gtk-2.0/modules/libappmenu-gtk-module.so /usr/local/lib/gtk-3.0/modules/libappmenu-gtk-module.so ``` @@ -98,9 +98,9 @@ programs, converts to them MenuModel and send to them AppMenu Currently __not__ used in helloSystem. Do we need it? -``` +:::{note} tbd -``` +::: * Author: tbd * Description: tbd @@ -113,7 +113,7 @@ tbd ### libappmenu-gtk2-parser and libappmenu-gtk3-parser -``` +```text /usr/local/lib/libappmenu-gtk2-parser.so /usr/local/lib/libappmenu-gtk2-parser.so.0 /usr/local/lib/libappmenu-gtk3-parser.so @@ -131,7 +131,7 @@ tbd ### libdbusmenu-glib -``` +```text /usr/local/lib/libdbusmenu-glib.so /usr/local/lib/libdbusmenu-glib.so.4 /usr/local/lib/libdbusmenu-glib.so.4.0.12 @@ -149,7 +149,7 @@ information to be displayed to users of the application through the interface sh ### libdbusmenu-gtk3 -``` +```text /usr/local/lib/libdbusmenu-gtk3.so /usr/local/lib/libdbusmenu-gtk3.so.4 /usr/local/lib/libdbusmenu-gtk3.so.4.0.12 @@ -166,7 +166,7 @@ information to be displayed to users of the application through the interface sh ### libdbusmenu-qt5 -``` +```text /usr/local/lib/libdbusmenu-qt5.so /usr/local/lib/libdbusmenu-qt5.so.2 /usr/local/lib/libdbusmenu-qt5.so.2.6.0 @@ -183,7 +183,7 @@ information to be displayed to users of the application through the interface sh ### Kf5 Appmenu Plugin -``` +```text /usr/local/lib/qt5/plugins/kf5/kded/appmenu.so ``` @@ -198,7 +198,7 @@ information to be displayed to users of the application through the interface sh ### Kf5 Plasma Applet Appmenu Plugin -``` +```text /usr/local/lib/qt5/plugins/plasma/applets/plasma_applet_appmenu.so ``` @@ -213,7 +213,7 @@ information to be displayed to users of the application through the interface sh ### Kf5 Plasma Private libappmenuplugin -``` +```text /usr/local/lib/qt5/qml/org/kde/plasma/private/appmenu/libappmenuplugin.so ``` @@ -228,7 +228,7 @@ information to be displayed to users of the application through the interface sh ### wxGtk libwx_gtk3u_core -``` +```text /usr/local/lib/libwx_gtk3u_core-3.1.so /usr/local/lib/libwx_gtk3u_core-3.1.so.4 /usr/local/lib/libwx_gtk3u_core-3.1.so.4.0.0 @@ -258,7 +258,7 @@ Only if `GTK_MODULES=appmenu-gtk-module` is exported the menus in e.g. Audacity As of 2021, the (undocumented?) `UBUNTU_MENUPROXY` environment variable is referenced in -``` +```text /usr/local/lib/libwx_gtk3u_core-3.1.so.4.0.0 /usr/local/lib/gtk-3.0/modules/libappmenu-gtk-module.so /usr/local/lib/gtk-2.0/modules/libappmenu-gtk-module.so @@ -271,13 +271,13 @@ Audacity is an example for an application that uses `libwx_gtk3u_core-3.1.so.4`. * Apparently setting it to a random value still makes the global menu work for Audacity * According to [this](https://github.com/electron/electron/issues/709#issuecomment-59207492), `UBUNTU_MENUPROXY` should be set to `libappmenu.so`? -``` .. note:: - Please consider submitting issues and pull requests if you know how UBUNTU_MENUPROXY is supposed to work. Is it documented? -``` +:::{note} +Please consider submitting issues and pull requests if you know how UBUNTU_MENUPROXY is supposed to work. Is it documented? +::: Ultimaker Cura (which does not have a working global menu integration by default) contains a note in `/usr/local/lib/python3.7/site-packages/UM/Application.py` saying -``` +```py # For Ubuntu Unity this makes Qt use its own menu bar rather than pass it on to Unity. os.putenv("UBUNTU_MENUPROXY", "0") ``` @@ -310,8 +310,8 @@ Packages of patched Firefox and Thunderbird are available at http://build.schmit helloSystem versions 0.7.0 and up come with this repository enabled. To enable it manually: -``` -cat > /usr/local/etc/pkg/repos/helloDesktop.conf <<\EOF +```console +$ cat > /usr/local/etc/pkg/repos/helloDesktop.conf <<\EOF helloDesktop: { url: "pkg+http://build.schmitz.computer/packages/${ABI}-mozillapatched", mirror_type: "srv", @@ -322,7 +322,7 @@ helloDesktop: { } EOF -cat > /usr/local/etc/ssl/certs/jsm222.cert <<\EOF +$ cat > /usr/local/etc/ssl/certs/jsm222.cert <<\EOF -----BEGIN PUBLIC KEY----- MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEA5gEt92AHUkYkZH2Q2nP3 2/Wu7gxbMEno5iqi1ea327lHmhJB18E0mW9dKYgxz74PbbTAmyaMdY4G1vn3cStp @@ -339,12 +339,12 @@ q9cTv5oaRy9FQy0NdGwGuqUCAwEAAQ== -----END PUBLIC KEY----- EOF -sudo pkg install firefox thunderbird +$ sudo pkg install firefox thunderbird ``` Since the helloDesktop repository has `priority: 100`, you should see: -``` +```console New packages to be INSTALLED: firefox-94.0.1_1,2 [helloDesktop] thunderbird: 91.3.0_1 [helloDesktop] @@ -354,7 +354,7 @@ Note the `helloDesktop`, indicating that these packages will be installed from t ### GMenu-DBusMenu-Proxy -``` +```text /usr/local/bin/gmenudbusmenuproxy ``` @@ -372,9 +372,9 @@ Note the `helloDesktop`, indicating that these packages will be installed from t The __Qt 5 D-Bus Viewer__ utility may be useful in debugging global menus. -``` .. note:: - Please consider submitting issues and pull requests if you can contribute to this subject. -``` +:::{note} +Please consider submitting issues and pull requests if you can contribute to this subject. +::: ### Getting the menus for a Qt application knowing the Xorg window ID @@ -402,11 +402,11 @@ The __Qt 5 D-Bus Viewer__ utility may be useful in debugging global menus. Applications running as root currently cannot show global menus due to the D-Bus architecture. -``` .. note:: - Possibly some sort of proxy would be needed to allow applications that were invoked via `sudo -E` to display their menus in the global menu of the user running the desktop session. - - Please consider contributing ideas and code if you are interested in this topic. -``` +:::{note} +Possibly some sort of proxy would be needed to allow applications that were invoked via `sudo -E` to display their menus in the global menu of the user running the desktop session. + +Please consider contributing ideas and code if you are interested in this topic. +::: ## Implementations for other desktop systems diff --git a/developer/midi.md b/developer/midi.md index 0bc2506b..9b34ca3d 100644 --- a/developer/midi.md +++ b/developer/midi.md @@ -6,41 +6,41 @@ Over a decade ago, someone [wrote](https://forums.freebsd.org/threads/alsa-midi- This page describes how to use USB based hardware MIDI controllers (e.g., keyboards), with helloSystem and FreeBSD. -``` .. note:: - It is a work in progress. Please consider contributing additions and corrections. -``` +:::{note} +It is a work in progress. Please consider contributing additions and corrections. +::: ## Using /dev/umidi* -Whenever a USB based hardware MIDI controller is plugged into the computer, a `/dev/umidi*` device node is created automatically. +Whenever a USB based hardware MIDI controller is plugged into the computer, a {file}`/dev/umidi*` device node is created automatically. ### Testing To test whether input from the MIDI controller arrives, run in a Terminal window: -``` -midicat -d -q rmidi/0.0 -o /dev/null +```console +$ midicat -d -q rmidi/0.0 -o /dev/null ``` As you play some notes on the MIDI controller, you should see MIDI messages appear on the screen. After verifying that this works, exit `midicat`. -Some applications can use `/dev/umidi*` device nodes directly. Some expect the device node to be at `/dev/midi` though, so you need to create a symlink there manually. +Some applications can use {file}`/dev/umidi*` device nodes directly. Some expect the device node to be at {file}`/dev/midi` though, so you need to create a symlink there manually. ### Example application For example, the `fluidsynth` command line tool, can use hardware MIDI controllers in this way directly: -``` -sudo pkg install -y fluidsynth musescore -sudo ln -sf /dev/umidi*.0 /dev/midi -fluidsynth -m oss -a oss SoundFont.sf2 +```console +$ sudo pkg install -y fluidsynth musescore +$ sudo ln -sf /dev/umidi*.0 /dev/midi +$ fluidsynth -m oss -a oss SoundFont.sf2 ``` -Unfortunately, not all applications on FreeBSD can use `/dev/umidi*` device nodes directly in this way. Hence there are other methods to access MIDI controllers. which one you need to use depends on what methods the application in question supports. +Unfortunately, not all applications on FreeBSD can use {file}`/dev/umidi*` device nodes directly in this way. Hence there are other methods to access MIDI controllers. which one you need to use depends on what methods the application in question supports. -``` .. note:: - Applications cannot access /dev/umidi* directly while alsa-seq-server is running. -``` +:::{note} +Applications cannot access /dev/umidi* directly while alsa-seq-server is running. +::: ## Using OSS Raw-MIDI (Open Sound System) @@ -60,23 +60,23 @@ Some applications can use `alsa-seq-server` to access MIDI controllers. For some In order for applications that use `alsa-seq-server` to talk to your MIDI controller, run -``` -sudo pkg install alsa-seq-server alsa-utils -sudo alsa-seq-server -d /dev/umidi* +```console +$ sudo pkg install alsa-seq-server alsa-utils +$ sudo alsa-seq-server -d /dev/umidi* ``` and then run the application. -``` .. note:: - alsa-seq-server was recently updated so that one can run it as a service which will automatically make all MIDI devices available without having to run one instance per MIDI device. The change should appear in FreeBSD packages (and thus in helloSystem) starting in Q2/2022. -``` +:::{note} +alsa-seq-server was recently updated so that one can run it as a service which will automatically make all MIDI devices available without having to run one instance per MIDI device. The change should appear in FreeBSD packages (and thus in helloSystem) starting in Q2/2022. +::: ### Testing To test whether input from the MIDI controller arrives, run in a separate Terminal: -``` -aseqdump -p 0 +```console +$ aseqdump -p 0 Waiting for data. Press Ctrl+C to end. Source Event Ch Data ``` @@ -89,7 +89,7 @@ An example application that can use `alsa-seq-server` to talk to MIDI controller Recompiling LMMS from FreeBSD Ports with the following change regarding `WANT_ALSA` in the `Makefile` allows one to use `alsa-seq-server` to talk to MIDI controllers: -``` +```text CMAKE_OFF= WANT_CALF WANT_CAPS WANT_CMT WANT_SWH WANT_STK \ WANT_TAP WANT_VST CMAKE_ON= WANT_QT5 WANT_ALSA @@ -101,7 +101,7 @@ To use it, select "ALSA-Sequencer (Advanced Linux Sound Architecture)" from the If you see -``` +```console ALSA lib seq_hw.c:466:(snd_seq_hw_open) open /dev/snd/seq failed: No such file or directory cannot open sequencer: No such file or directory ``` diff --git a/developer/monkey-patch.md b/developer/monkey-patch.md index 79179658..45d034db 100644 --- a/developer/monkey-patch.md +++ b/developer/monkey-patch.md @@ -4,9 +4,9 @@ Starting with helloSystem 0.7.0 it is possible to [monkey patch](https://en.wiki With that, it allows for a very rapid development-test cycle for Live ISOs. -``` .. note:: - This feature is currently under active development and its usage is still subject to change. -``` +:::{note} +This feature is currently under active development and its usage is still subject to change. +::: ## Theory of operation @@ -33,7 +33,9 @@ The code inside the file `monkeypatch.sh` on the volume called `MONKEYPATCH` wil ## Example `monkeypatch.sh` file -``` +```shell +#!/bin/sh + # Write a file echo "HELLO MONKEY" > /tmp/MONKEY_WAS_HERE @@ -59,26 +61,26 @@ chmod +x /usr/local/sbin/mount_md A particularly effective way to debug the late boot process (after Xorg has started) is: -``` -mv /usr/local/bin/start-hello /usr/local/bin/start-hello.real -cat > /usr/local/bin/start-hello <<\EOF +```sh +$ mv /usr/local/bin/start-hello /usr/local/bin/start-hello.real +$ cat > /usr/local/bin/start-hello << EOF #!/bin/sh xterm -maximized start-hello.real # xterm -maximized EOF -chmod +x /usr/local/bin/start-hello* +$ chmod +x /usr/local/bin/start-hello* ``` This will allow you to see the commands in `start-hello.real` as they are executed. ## Booting a Live ISO running a different `init_script` -If you would like to test changes to `/boot/init_script` on the ISO without having to re-create it and without having to write the ISO to a device, you can use the `monkey_patch_init_script` feature: +If you would like to test changes to {file}`/boot/init_script` on the ISO without having to re-create it and without having to write the ISO to a device, you can use the `monkey_patch_init_script` feature: -* Boot the ISO but interrupt the bootloader by pressing the Esc key +* Boot the ISO but interrupt the bootloader by pressing the {kbd}`Esc` key * At the boot prompt, enter: `set monkey_patch_init_script=YES` * Optionally, use `unset BOOT_MUTE` so that you can see messages on the screen during boot * Start the system by entering `boot` -The code inside the file `init_script` on the volume called `MONKEYPATCH` will be executed instead of `/boot/init_script` on the ISO. +The code inside the file `init_script` on the volume called `MONKEYPATCH` will be executed instead of {file}`/boot/init_script` on the ISO. diff --git a/developer/ports.md b/developer/ports.md index 79e4ce36..712a9375 100644 --- a/developer/ports.md +++ b/developer/ports.md @@ -1,6 +1,7 @@ # Working with FreeBSD Ports In some situations it may be necessary to make changes to existing software that comes in FreeBSD packages. + This section describes how to make such changes using an example. ## Example @@ -17,81 +18,82 @@ Here is how to do it using FreeBSD Ports: ## Pulling the ports tree -``` -sudo git clone https://git.freebsd.org/ports.git /usr/ports --depth=1 +```console +$ sudo git clone https://git.freebsd.org/ports.git /usr/ports --depth=1 ``` If you are running an end-of-life FreeBSD version such as 12.1, you also need to -``` -export ALLOW_UNSUPPORTED_SYSTEM=1 -# Or in csh -setenv ALLOW_UNSUPPORTED_SYSTEM YES +```console +$ export ALLOW_UNSUPPORTED_SYSTEM=1 +// Or in csh +% setenv ALLOW_UNSUPPORTED_SYSTEM YES ``` ## Building the port without changes Build the port without changes first to ensure it builds and works as expected. -``` -cd /usr/ports/x11-toolkits/qtermwidget/ +```console +$ cd /usr/ports/x11-toolkits/qtermwidget/ -# Install all build-time dependencies from packages -make build-depends-list | cut -c 12- | xargs pkg install -y +// Install all build-time dependencies from packages +$ make build-depends-list | cut -c 12- | xargs pkg install -y -# Build the library -# NOTE: Applications that have a library that is used by nothing but that application are just -# annoying because now you have to deal with two entities rather than one -MAKE_JOBS_UNSAFE=yes sudo -E make -j4 +// Build the library +// NOTE: Applications that have a library that is used by nothing but that application are just +// annoying because now you have to deal with two entities rather than one +$ MAKE_JOBS_UNSAFE=yes sudo -E make -j4 -# Now, the application itself -cd /usr/ports/x11/qterminal +// Now, the application itself +$ cd /usr/ports/x11/qterminal -# Install all build-time dependencies from packages -make build-depends-list | cut -c 12- | xargs pkg install -y +// Install all build-time dependencies from packages +$ make build-depends-list | cut -c 12- | xargs pkg install -y -# Build the application -QTermWidget5_DIR=/usr/ports/x11-toolkits/qtermwidget/work/stage/usr/local/lib/cmake/qtermwidget5/ MAKE_JOBS_UNSAFE=yes sudo -E make -j4 +// Build the application +$ QTermWidget5_DIR=/usr/ports/x11-toolkits/qtermwidget/work/stage/usr/local/lib/cmake/qtermwidget5/ MAKE_JOBS_UNSAFE=yes sudo -E make -j4 -# Run the application with the changed library -LD_LIBRARY_PATH=/usr/ports/x11-toolkits/qtermwidget/work/stage/usr/local/lib/ /usr/ports/x11/qterminal/work/stage/usr/local/bin/qterminal +// Run the application with the changed library +$ LD_LIBRARY_PATH=/usr/ports/x11-toolkits/qtermwidget/work/stage/usr/local/lib/ /usr/ports/x11/qterminal/work/stage/usr/local/bin/qterminal ``` ## Making changes to the port Now make changes to the port. -``` .. note:: - In the ports system you cannot just change the source code because it would be overwritten during the build process. +:::{note} +In the ports system you cannot just change the source code because it would be overwritten during the build process. + You first need to make a copy of the source code, then make the changes in the copy, then create a patch that will get applied automatically at build time. -``` +::: -``` -# Copy the file to be changed -cd /usr/ports/x11-toolkits/qtermwidget -sudo cp work/qtermwidget-*/lib/TerminalDisplay.cpp work/qtermwidget-*/lib/TerminalDisplay.cpp.orig +```console +// Copy the file to be changed +$ cd /usr/ports/x11-toolkits/qtermwidget +$ sudo cp work/qtermwidget-*/lib/TerminalDisplay.cpp work/qtermwidget-*/lib/TerminalDisplay.cpp.orig -# Make the change in the library -sudo nano work/qtermwidget-*/lib/TerminalDisplay.cpp +// Make the change in the library +$ sudo nano work/qtermwidget-*/lib/TerminalDisplay.cpp QChar q(QLatin1Char('\'')); dropText += q + QString(urlText).replace(q, QLatin1String("'\\''")) + q; dropText += QLatin1Char(' '); -# Make a patch -sudo make makepatch +// Make a patch +$ sudo make makepatch -# Build the library again -# sudo make clean # Run this only if the next line does nothing -MAKE_JOBS_UNSAFE=yes sudo -E make -j4 +// Build the library again +$ sudo make clean # Run this only if the next line does nothing +$ MAKE_JOBS_UNSAFE=yes sudo -E make -j4 -# Run the application with the changed library -LD_LIBRARY_PATH=/usr/ports/x11-toolkits/qtermwidget/work/stage/usr/local/lib/ /usr/ports/x11/qterminal/work/stage/usr/local/bin/qterminal +// Run the application with the changed library +$ LD_LIBRARY_PATH=/usr/ports/x11-toolkits/qtermwidget/work/stage/usr/local/lib/ /usr/ports/x11/qterminal/work/stage/usr/local/bin/qterminal ``` As a result we have a patch: -``` -% cat files/patch-lib_TerminalDisplay.cpp +```console +$ cat files/patch-lib_TerminalDisplay.cpp --- lib/TerminalDisplay.cpp.orig 2020-11-03 08:19:26 UTC +++ lib/TerminalDisplay.cpp @@ -3099,7 +3099,9 @@ void TerminalDisplay::dropEvent(QDropEvent* event) @@ -111,16 +113,16 @@ As a result we have a patch: Optionally, make packages for the ports. Note that `make build` needs to have run already before this step. -``` -# Library -cd /usr/ports/x11-toolkits/qtermwidget/ -sudo make package -ls work/pkg - -# Application -cd /usr/ports/x11/qterminal -sudo make package -ls work/pkg +```console +// Library +$ cd /usr/ports/x11-toolkits/qtermwidget/ +$ sudo make package +$ ls work/pkg + +// Application +$ cd /usr/ports/x11/qterminal +$ sudo make package +$ ls work/pkg ``` ## Creating a port from scratch @@ -128,28 +130,28 @@ ls work/pkg The [FreeBSD Porter's Handbook](https://docs.freebsd.org/en/books/porters-handbook/) is the authoritative source on how to write new ports from scratch. This section shows a hands-on example on how to package a set of tools from a GitHub repository. -``` .. note:: - This section is a work in progress. Corrections are welcome. -``` +:::{note} +This section is a work in progress. Corrections are welcome. +::: First, prepare the Ports environment: -``` -sudo su -pkg install portlint -echo DEVELOPER=yes >> /etc/make.conf +```console +$ sudo su +# pkg install portlint +# echo DEVELOPER=yes >> /etc/make.conf ``` Next, create a directory for the new port: -``` -mkdir /usr/ports/sysutils/fluxengine -cd /usr/ports/sysutils/fluxengine +```console +# mkdir /usr/ports/sysutils/fluxengine +# cd /usr/ports/sysutils/fluxengine ``` Create `Makefile` with the following content: -``` +```text # $FreeBSD$ PORTNAME= fluxengine @@ -182,8 +184,8 @@ do-install: Run -``` -make makeplist > pkg-plist +```console +# make makeplist > pkg-plist ``` to create that file. Check and edit it by hand, especially the first line. @@ -197,7 +199,7 @@ Notes Create `pkg-descr` based on the description on the GitHub [README.md](https://github.com/davidgiven/fluxengine): -``` +```text The FluxEngine is a very cheap USB floppy disk interface capable of reading and writing exotic non-PC floppy disk formats. It allows you to use a conventional PC drive to accept Amiga disks, @@ -217,34 +219,34 @@ Notes Create the checksum file by running -``` -make makesum +```console +# make makesum ``` Check the Makefile with -``` -portlint +```console +# portlint ``` and correct any mistakes it reports, then repeat. Once `portlint` says `looks fine`, try to build by running -``` -make +```console +# make ``` Note that the compilation will fail. This is because in this case the application needs to be built with `gmake` rather than `make`. Run tests -``` -make stage -make stage-qa -make package -make install -make deinstall +```console +# make stage +# make stage-qa +# make package +# make install +# make deinstall ``` None of these must produce errors. See [3.4. Testing the Port](https://docs.freebsd.org/en/books/porters-handbook/porting-testing.html) for details. @@ -253,42 +255,43 @@ At this point it may be a good idea to have an experienced FreeBSD Ports develop Once everything looks good, prepare a `.shar` file for submitting it to https://bugs.freebsd.org/submit/: -``` -rm -rf work/ -cd .. -tar cf fluxengine.shar --format shar fluxengine +```console +# rm -rf work/ +# cd .. +# tar cf fluxengine.shar --format shar fluxengine ``` ## Updating existing ports This real-life example shows how to update a port, e.g., `x11/qterminal`. -``` -sudo su -cd /usr/ports -git pull -cd x11/qterminal +```console +$ sudo su +# cd /usr/ports +# git pull +# cd x11/qterminal ``` Change `PORTVERSION= 1.1.0` to `PORTVERSION= 1.2.0`. Turns out that one has to update `x11-toolkits/qtermwidget` and `devel/lxqt-build-tools` too for it to compile. -``` -portlint # Fix errors, if any -rm pkg-plist -make clean -make package reinstall -make makeplist > pkg-plist -nano pkg-plist # Remove first line and check the others -make clean -make package reinstall +```console +# portlint # Fix errors, if any +# rm pkg-plist +# make clean +# make package reinstall +# make makeplist > pkg-plist +# nano pkg-plist # Remove first line and check the others +# make clean +# make package reinstall ``` Finally, once everything is tested, create separate patches for each port with -``` -cd /usr/ports -git diff -U999999 x11/qterminal > /home/user/Desktop/x11_qterminal.diff -git diff -U999999 devel/lxqt-build-tools > /home/user/Desktop/devel_lxqt-build-tools.diff -git diff -U999999 x11-toolkits/qtermwidget > /home/user/Desktop/x11-toolkits_qtermwidget.diff + +```console +# cd /usr/ports +# git diff -U999999 x11/qterminal > /home/user/Desktop/x11_qterminal.diff +# git diff -U999999 devel/lxqt-build-tools > /home/user/Desktop/devel_lxqt-build-tools.diff +# git diff -U999999 x11-toolkits/qtermwidget > /home/user/Desktop/x11-toolkits_qtermwidget.diff ``` Go to https://reviews.freebsd.org/differential/, click "Create Diff", can log in using GitHub credentials, subject `devel/lxqt-build-tools: Update to 0.12.0`, under "Reviewers" add the maintainer. diff --git a/developer/rpi.md b/developer/rpi.md index 0e28ef45..b7c389ef 100644 --- a/developer/rpi.md +++ b/developer/rpi.md @@ -6,7 +6,9 @@ Although we are currently not providing installation images for Raspberry Pi, we The same instructions are roughly applicable to other aarch64 based systems such as rk3399 ones like the PineBook Pro and the [pine64 rockpro64_rk3399](https://bsd-hardware.info/?id=board:pine64-pinebook-pro-rk3399) as well. -> __Note:__ This page is intended for technically advanced users and developers, not for end users. This page is work in progress. Instructions are brief and assume prior knowledge with the subject. +:::{note} +This page is intended for technically advanced users and developers, not for end users. This page is work in progress. Instructions are brief and assume prior knowledge with the subject. +::: This page describes how to run the main components of helloSystem (referred to collectively as helloDesktop) on Raspberry Pi 3 and Raspberry Pi 4 devices, starting with the official FreeBSD 13 image that does not even contain Xorg. @@ -33,7 +35,7 @@ If there is enough interest, we might eventually provide readymade helloSystem i * Copy this file to the microSD card you are running the Raspberry Pi from. You will need it because you will not have an internet browser at hand * Edit `config.txt` in the `MSDOSBOOT` partition to contain the correct resolution for your screen. -``` +```text hdmi_safe=0 disable_overscan=1 display_auto_detect=1 @@ -46,22 +48,23 @@ gpu_mem=512 dtoverlay=vc4-kms-v3d-pi4 ``` -``` .. note:: +:::{note} If, for some reason, the display does not work, simply remove or comment out the `max_framebuffer*` lines and replace them with the following: -``` -``` + +```text framebuffer_width= framebuffer_height= ``` +::: ## Preparing a bootable SSD drive (optional but recommended) * [Update your firmware if USB boot is not working](https://www.raspberrystreet.com/learn/how-to-boot-raspberrypi-from-usb-ssd) * Follow the instructions in the SD card section, but write the image to your SSD -``` .. note:: +:::{note} The Raspberry Pi 4/400 doesn't have a PCIe bus, so booting off an NVMe drive over USB protocol is not supported by the hardware. You will need to use a SATA SSD. This works for either M.2 or traditional drive form factors. -``` +::: ## Booting into the system @@ -76,17 +79,17 @@ We will be doing all subsequent steps on the Raspberry Pi system itself since we * Log in with `root`, password `root` * Install some basic software with `pkg install -y xorg xterm nano openbox fluxbox git-lite` -``` .. note:: +:::{note} `fluxbox` is not strictly needed and can be removed later on, but it gives us a graphical desktop session while we are working on installing helloDesktop -``` +::: ## Starting a graphical session Start Xorg with -``` -echo startfluxbox > ~/.xinitrc -startx +```console +# echo startfluxbox > ~/.xinitrc +# startx ``` Doing it like this is the easiest way since the display `DISPLAY` environment variable and other things will be set automatically. @@ -95,86 +98,86 @@ Doing it like this is the easiest way since the display `DISPLAY` environment va ### Install prerequisites -``` -pkg install -y cmake pkgconf qt5-qmake qt5-buildtools kf5-kdbusaddons kf5-kwindowsystem libdbusmenu-qt5 qt5-concurrent qt5-quickcontrols2 libfm libqtxdg wget +```console +# pkg install -y cmake pkgconf qt5-qmake qt5-buildtools kf5-kdbusaddons kf5-kwindowsystem libdbusmenu-qt5 qt5-concurrent qt5-quickcontrols2 libfm libqtxdg wget ``` ### launch The `launch` command is central to helloSystem and is used to launch applications throughout the system. -``` -git clone https://github.com/helloSystem/launch -cd launch/ -mkdir build -cd build/ -cmake .. -make -j4 -./launch -make install -cd ../../ +```console +# git clone https://github.com/helloSystem/launch +# cd launch/ +# mkdir build +# cd build/ +# cmake .. +# make -j4 +# ./launch +# make install +# cd ../../ ``` ### Menu -``` -git clone https://github.com/helloSystem/Menu -cd Menu -mkdir build -cd build -cmake .. -make -j4 -make install -ln -s /usr/local/bin/menubar /usr/local/bin/Menu # Workaround for the 'launch' command to find it -cd ../../ +```console +# git clone https://github.com/helloSystem/Menu +# cd Menu +# mkdir build +# cd build +# cmake .. +# make -j4 +# make install +# ln -s /usr/local/bin/menubar /usr/local/bin/Menu # Workaround for the 'launch' command to find it +# cd ../../ ``` ### Filer -``` -git clone https://github.com/helloSystem/Filer -cd Filer/ -mkdir build -cd build/ -cmake .. -make -j4 -make install -ln -s /usr/local/bin/filer-qt /usr/local/bin/Filer # Workaround for the 'launch' command to find it -cd ../../ +```console +# git clone https://github.com/helloSystem/Filer +# cd Filer/ +# mkdir build +# cd build/ +# cmake .. +# make -j4 +# make install +# ln -s /usr/local/bin/filer-qt /usr/local/bin/Filer # Workaround for the 'launch' command to find it +# cd ../../ ``` -``` .. note:: +:::{note} It seems like Filer refuses to start if D-Bus is missing. We should change it so that it can also work without D-Bus and at prints a clear warning if D-Bus is missing. Currently all you see if D-Bus is missing is the following: '** (process:3691): WARNING **: The directory '~/Templates' doesn't exist, ignoring it', and then Filer exits. -``` +::: ### Dock -``` -pkg install -y <...> -git clone https://github.com/helloSystem/Dock -cd Dock -mkdir build -cd build -cmake .. -make -j4 -make install -# Currently Dock is installed to /usr/bin/cyber-dock. In the future is should be in /usr/local/bin/. -ln -s /usr/bin/cyber-dock /usr/local/bin/Dock # Workaround for the 'launch' command to find it -cd ../../ +```console +# pkg install -y <...> +# git clone https://github.com/helloSystem/Dock +# cd Dock +# mkdir build +# cd build +# cmake .. +# make -j4 +# make install +// Currently Dock is installed to /usr/bin/cyber-dock. In the future is should be in /usr/local/bin/. +# ln -s /usr/bin/cyber-dock /usr/local/bin/Dock # Workaround for the 'launch' command to find it +# cd ../../ ``` ### QtPlugin -``` -git clone https://github.com/helloSystem/QtPlugin -cd QtPlugin/ -mkdir build -cd build/ -cmake .. -make -j4 -make install -cp ../stylesheet.qss /usr/local/etc/xdg/ -cd ../../ +```console +# git clone https://github.com/helloSystem/QtPlugin +# cd QtPlugin/ +# mkdir build +# cd build/ +# cmake .. +# make -j4 +# make install +# cp ../stylesheet.qss /usr/local/etc/xdg/ +# cd ../../ ``` ### Icons and other assets @@ -183,27 +186,26 @@ Install icons and other helloSystem assets that are not packaged as FreeBSD pack For the system icons: -``` -wget -c -q http://archive.ubuntu.com/ubuntu/pool/universe/x/xubuntu-artwork/xubuntu-icon-theme_16.04.2_all.deb -tar xf xubuntu-icon-theme_16.04.2_all.deb -tar xf data.tar.xz -mkdir -p "${uzip}"/usr/local/share/icons/ -mv ./usr/share/icons/elementary-xfce "${uzip}"/usr/local/share/icons/ -mv ./usr/share/doc/xubuntu-icon-theme/copyright "${uzip}"/usr/local/share/icons/elementary-xfce/ -sed -i -e 's|usr/share|usr/local/share|g' "${uzip}"/usr/local/share/icons/elementary-xfce/copyright -rm "${uzip}"/usr/local/share/icons/elementary-xfce/copyright-e - -wget "https://raw.githubusercontent.com/helloSystem/hello/master/branding/computer-hello.png" -O "${uzip}"/usr/local/share/icons/elementary-xfce/devices/128/computer-hello.png +```console +# wget -c -q http://archive.ubuntu.com/ubuntu/pool/universe/x/xubuntu-artwork/xubuntu-icon-theme_16.04.2_all.deb +# tar xf xubuntu-icon-theme_16.04.2_all.deb +# tar xf data.tar.xz +# mkdir -p "${uzip}"/usr/local/share/icons/ +# mv ./usr/share/icons/elementary-xfce "${uzip}"/usr/local/share/icons/ +# mv ./usr/share/doc/xubuntu-icon-theme/copyright "${uzip}"/usr/local/share/icons/ elementary-xfce/ +# sed -i -e 's|usr/share|usr/local/share|g' "${uzip}"/usr/local/share/icons/elementary-xfce/copyright +# rm "${uzip}"/usr/local/share/icons/elementary-xfce/copyright-e +# wget "https://raw.githubusercontent.com/helloSystem/hello/master/branding/computer-hello.png" -O "${uzip}"/usr/local/share/icons/elementary-xfce/devices/128/computer-hello.png ``` For the system fonts: -``` -wget -c -q https://github.com/ArtifexSoftware/urw-base35-fonts/archive/20200910.zip -unzip -q 20200910.zip -mkdir -p "${uzip}/usr/local/share/fonts/TTF/" -cp -R urw-base35-fonts-20200910/fonts/*.ttf "${uzip}/usr/local/share/fonts/TTF/" -rm -rf urw-base35-fonts-20200910/ 20200910.zip +```console +# wget -c -q https://github.com/ArtifexSoftware/urw-base35-fonts/archive/20200910.zip +# unzip -q 20200910.zip +# mkdir -p "${uzip}/usr/local/share/fonts/TTF/" +# cp -R urw-base35-fonts-20200910/fonts/*.ttf "${uzip}/usr/local/share/fonts/TTF/" +# rm -rf urw-base35-fonts-20200910/ 20200910.zip ``` Proceed similarly for the cursor theme, wallpaper, applications from the helloSystem/Utilities repository, and other assets. @@ -212,13 +214,15 @@ Proceed similarly for the cursor theme, wallpaper, applications from the helloSy Install every package that is not commented out in [packages.hello](https://raw.githubusercontent.com/helloSystem/ISO/experimental/settings/packages.hello) that are installable. -``` .. note:: - Not every package will be installable. This probably means that the package in question has not been compiled for the `aarch64` architecture on FreeBSD 13 yet. -``` +:::{note} +Not every package will be installable. This probably means that the package in question has not been compiled for the `aarch64` architecture on FreeBSD 13 yet. +::: You can use this script to automatically install all listed packages: ```sh +#!/bin/sh + url="https://raw.githubusercontent.com/helloSystem/ISO/experimental/settings/packages.hello" curl -fsS $url | egrep -v '^#' | while read line ; do pkg install -y -U $line || echo "[error] $line cannot be installed" @@ -229,23 +233,23 @@ To enable `automount`, run `service devd restart`. ### Installing overlays -``` -git clone https://github.com/helloSystem/ISO -cp -Rfv ISO/overlays/uzip/hello/files/ / -cp -Rfv ISO/overlays/uzip/localize/files/ / -cp -Rfv ISO/overlays/uzip/openbox-theme/files/ / -cp -Rfv ISO/overlays/uzip/mountarchive/files/ / +```console +# git clone https://github.com/helloSystem/ISO +# cp -Rfv ISO/overlays/uzip/hello/files/ / +# cp -Rfv ISO/overlays/uzip/localize/files/ / +# cp -Rfv ISO/overlays/uzip/openbox-theme/files/ / +# cp -Rfv ISO/overlays/uzip/mountarchive/files/ / ``` -``` .. note:: - If we provided the temporary packages that are used in the helloSystem ISO build process for download, then one could just install those instead of having to do the above. -``` +:::{note} +If we provided the temporary packages that are used in the helloSystem ISO build process for download, then one could just install those instead of having to do the above. +::: ## Adjusting fstab -Edit `/etc/fstab` to look like this: +Edit {file}`/etc/fstab` to look like this: -``` +```text /dev/mmcsd0s2a / ufs rw 0 0 ``` @@ -255,7 +259,7 @@ Otherwise the root device may not be found upon reboot. Filer does not launch and Zeroconf does not work if `/usr/local/bin/dbus-daemon --system` is not running. Hence add the following lines to `/etc/rc.conf' to enable it: -``` +```text dbus_enable="YES" avahi_enable="YES" ``` @@ -266,7 +270,7 @@ and then start it `service dbus start`. Edit the `start-hello` script to use the `launch` command instead of hardcoding `/Applications/...`. -``` +```text ################################# # Details to be inserted here. # This script is work in progress. @@ -275,9 +279,9 @@ Edit the `start-hello` script to use the `launch` command instead of hardcoding ### Starting helloDesktop session -``` -echo start-hello > ~/.xinitrc -killall Xorg +```console +# echo start-hello > ~/.xinitrc +# killall Xorg ``` Type `startx` to start an Xorg session; it should now load a helloDesktop session. @@ -288,31 +292,36 @@ Sometimes it does not load all the way, in this case it is necessary to start xt Added a new user with Applications -> Preferences -> Users -``` -cp /home/user/.openbox* . -cp -r /home/user/.config/* .config/ +```console +# cp /home/user/.openbox* . +# cp -r /home/user/.config/* .config/ ``` ## Improving system performance ### Setting up SWAP for greater system memory capabilities -``` .. note:: - While this will work on an SD card, it will be slow and wear out your drive quickly. Take it from me, SD cards SUCK for quick memory page access. It is highly recommended to use a SATA SSD when using SWAP. This section was adapted from [a guide on nixCraft](https://www.cyberciti.biz/faq/create-a-freebsd-swap-file/). It goes into more detail and even breifly covers encryption. -``` +:::{note} +While this will work on an SD card, it will be slow and wear out your drive quickly. Take it from me, SD cards SUCK for quick memory page access. It is highly recommended to use a SATA SSD when using SWAP. This section was adapted from [a guide on nixCraft](https://www.cyberciti.biz/faq/create-a-freebsd-swap-file/). It goes into more detail and even breifly covers encryption. +::: * Create a SWAP file using -``` -# dd if=/dev/zero of=/swap bs=1M count=8192 -``` -``` .. note:: -This will create a swap file holding up to 8192 MB (8 GB) of memory. To go much further beyond that would recommend some further tweaking. 8 GB should be more than enough. It's easy enough to convert what you want in GB to MB, but for the sake of convenience, multiply how much memory you want in gigabytes (GB) by 1024. For example, if you wanted 4 GB, you'd do 4*1024=4096. -``` + + ```console + # dd if=/dev/zero of=/swap bs=1M count=8192 + ``` + + :::{note} + This will create a swap file holding up to 8192 MB (8 GB) of memory. To go much further beyond that would recommend some further tweaking. 8 GB should be more than enough. It's easy enough to convert what you want in GB to MB, but for the sake of convenience, multiply how much memory you want in gigabytes (GB) by 1024. For example, if you wanted 4 GB, you'd do 4*1024=4096. + ::: + * Run `# chmod 0600 /swap` to give it the correct permissions. * Edit /etc/fstab and append the following line: -``` -md42 none swap sw,file=/swap 0 0 -``` + + ```text + md42 none swap sw,file=/swap 0 0 + ``` + * Run `# swapon -aq` to immediately enable SWAP * Run `$ swapinfo -k` to verify that it's been attached correctly @@ -322,9 +331,9 @@ With an SSD, SWAP, and several GPU enhancements enabled, you should immediately Overclocking is inherently dangerous as you are pushing the device beyond the intended spec. However, it is a very simple and robust machine that will most likely experience no ussues doing this. The Raspberry Pi is very affordable and modular, making the risk of hardware failure less of an issue. The main board can easily be swapped out and EEPROM flashed and you have your whole system back. There's a hard limit to how far you can push your Pi, so don't even worry about overdoing it. No 8 GHz liquid nitrogen overclocks I'm afraid. -To overclock you Raspberry Pi 4 to the max, edit `/boot/msdos/config.txt` and append the following: +To overclock you Raspberry Pi 4 to the max, edit {file}`/boot/msdos/config.txt` and append the following: -``` +```text over_voltage=6 arm_freq=2147 gpu_freq=700 @@ -334,9 +343,9 @@ gpu_freq=700 ## Known issues -``` .. note:: - Any help in improving the situation is appreciated. -``` +:::{note} +Any help in improving the situation is appreciated. +::: Not sure whether `vc4-kms-v3d` is usable with FreeBSD. @@ -346,15 +355,15 @@ Also see: https://papers.freebsd.org/2019/bsdcan/vadot-adventure_in_drmland/ The `slim` package is missing, hence we don't have a login window at the moment. -``` .. note:: - Web browser performance may be improved and the following issues may not be relevant anymore. This will require more user feedback and testing. -``` +:::{note} +Web browser performance may be improved and the following issues may not be relevant anymore. This will require more user feedback and testing. +::: ### Web browser The Falkon browser can be launched, but trying to load more than the most basic web pages such as http://frogfind.com/ leads to an instant crash: -``` +```console # cat /root/.config/falkon/crashlog/Crash-2021-04-17T10:21:20.txt Time: Sa. Apr. 17 10:21:20 2021 Qt version: 5.15.2 (compiled with 5.15.2) @@ -366,9 +375,9 @@ Rendering engine: QtWebEngine #1: 0x499b4994 <_pthread_sigmask+0x524> at /lib/libthr.so.3 ``` -``` .. note:: - The exact same crash also happens on a RockPro64 with 4GB of RAM. -``` +:::{note} +The exact same crash also happens on a RockPro64 with 4GB of RAM. +::: ### RAM compression @@ -380,23 +389,23 @@ Windows also does RAM compression: https://www.tenforums.com/windows-10-news/179 The following seems to "work" but can make the Raspberry Pi unacceptably slow: -``` -mdconfig -a -t malloc -o compress -o reserve -s 700m -u 7 -swapon /dev/md7 +```console +# mdconfig -a -t malloc -o compress -o reserve -s 700m -u 7 +# swapon /dev/md7 ``` -``` .. note:: - Please let us know if you know how to properly use RAM compression on FreeBSD. -``` +:::{note} +Please let us know if you know how to properly use RAM compression on FreeBSD. +::: -``` .. note:: - Do not use ZFS on memory-constrained machines. -``` +:::{note} +Do not use ZFS on memory-constrained machines. +::: ### Missing icons Set `QT_QPA_PLATFORMTHEME` env variable before staring Xorg session. -``` +```console setenv QT_QPA_PLATFORMTHEME panda ``` diff --git a/developer/tracing.md b/developer/tracing.md index b42b8a0e..245ce67f 100644 --- a/developer/tracing.md +++ b/developer/tracing.md @@ -2,21 +2,23 @@ The `dtruss` command line tool can be used to examine what a running process is doing. Other than, e.g., `strace` on Linux, `dtruss` can be used to watch already-running processes. This makes it more suitable to watch processes that have been launched by, e.g., the `launch` command. -``` -sudo pkg install dtrace-toolkit -sudo kldload dtraceall -launch FeatherPad -# In another terminal: ps ax | grep featherpad -# Then use the PID of the featherpad process for the next command: -sudo dtruss -p 1886 -f +```console +$ sudo pkg install dtrace-toolkit +$ sudo kldload dtraceall +$ launch FeatherPad +// In another terminal: +$ ps ax | grep featherpad +// Then use the PID of the featherpad process for the next command: +$ sudo dtruss -p 1886 -f ``` -``` .. note:: - If you get `probe description syscall:::entry does not match any probes`, then possibly you loaded `kldload dtrace` rather than `kldload dtraceall`. -``` +:::{note} +If you get `probe description syscall:::entry does not match any probes`, then possibly you loaded `kldload dtrace` rather than `kldload dtraceall`. +::: The [FreeBSD DTrace Tutorial](https://wiki.freebsd.org/DTrace/Tutorial) has many one-liner examples for tasks like observing + * File Opens * Syscall Counts By Process * Distribution of read() Bytes @@ -30,6 +32,6 @@ The [FreeBSD DTrace Tutorial](https://wiki.freebsd.org/DTrace/Tutorial) has many There is also a full list of [DTrace One-Liners](https://wiki.freebsd.org/DTrace/One-Liners) to pick up more DTrace functionality. -``` .. note:: - In the future a graphical utility might be written to automate common tracing tasks. -``` +:::{note} +In the future a graphical utility might be written to automate common tracing tasks. +::: diff --git a/developer/ux-guidelines.md b/developer/ux-guidelines.md index b7e4622e..f7a42970 100644 --- a/developer/ux-guidelines.md +++ b/developer/ux-guidelines.md @@ -28,7 +28,7 @@ advantage over other menu systems. average distance required to reach the top of a 19 inch diagonal screen, yet the pull-downs still significantly outperformed the walking menus. Therefore, it may be more efficient to place menus at the top of the window -Source: Walker, N & Smelcer, JB 1990, A comparison of selection times from walking and pull-down menus. in JC Chew & J Whiteside (eds), Proceedings of the SIGCHI Conference on Human Factors in Computing Systems, CHI 1990. Association for Computing Machinery, pp. 221-225, 1990 SIGCHI Conference on Human Factors in Computing Systems, CHI 1990, Seattle, United States, 4/1/90. https://dl.acm.org/doi/pdf/10.1145/97243.97277 +Source: Walker, N & Smelcer, JB 1990, A comparison of selection times from walking and pull-down menus. in JC Chew & J Whiteside (eds), Proceedings of the SIGCHI Conference on Human Factors in Computing Systems, CHI 1990. Association for Computing Machinery, pp. 221-225, 1990 SIGCHI Conference on Human Factors in Computing Systems, CHI 1990, Seattle, United States, 4/1/90. ## Avoiding hidden menus hamburger icons diff --git a/index.md b/index.md index de79eec2..50294fea 100644 --- a/index.md +++ b/index.md @@ -1,10 +1,10 @@ -```eval_rst -.. image:: https://raw.githubusercontent.com/helloSystem/hello/1d1e69be8a689c5e0a176df821c14f0b49b241a4/branding/hello_variation.svg - :align: center - :width: 300px +```{image} https://raw.githubusercontent.com/helloSystem/hello/1d1e69be8a689c5e0a176df821c14f0b49b241a4/branding/hello_variation.svg +:alt: The helloSystem logo +:width: 300px +:align: center ``` -```eval_rst +```{eval-rst} .. centered:: Willkommen • Welcome • Bienvenue • Benvenuto • Bienvenido • ようこそ • Mabuhay • Tervetuloa • Välkommen • Добро пожаловать • Hoş geldiniz • Bonvenon • 歡迎 ``` @@ -14,50 +14,54 @@ __helloSystem__ is a desktop system for creators with a focus on simplicity, ele ![Screenshot](https://github.com/helloSystem/hello/blob/master/screenshots/20220121-desktop-0.8.png?raw=true) -```eval_rst -.. toctree:: - :maxdepth: 3 - :caption: User Guide - :hidden: - :glob: - - user/getting-started - user/components - user/troubleshooting - user/feedback +```{toctree} +--- +maxdepth: 3 +caption: User Guide +hidden: true +glob: true +--- + +user/getting-started +user/components +user/troubleshooting +user/feedback + ``` -```eval_rst -.. toctree:: - :caption: Developer Guide - :hidden: - :maxdepth: 2 - :glob: - - developer/ux-guidelines - developer/architecture - developer/boot - developer/geom_rowr - developer/graphics - developer/binary-compatibility - developer/applications - developer/application-bundles - developer/menu - developer/filer-context-menus - developer/developer-tools - developer/midi - developer/specifications - developer/contributing - developer/building - developer/monkey-patch - developer/tracing - developer/localization - developer/ports - developer/base - developer/man - developer/rpi - developer/linux - developer/distributions - developer/acknowledgements - developer/contact +```{toctree} +--- +caption: Developer Guide +hidden: true +maxdepth: 2 +glob: true +--- + +developer/ux-guidelines +developer/architecture +developer/boot +developer/geom_rowr +developer/graphics +developer/binary-compatibility +developer/applications +developer/application-bundles +developer/menu +developer/filer-context-menus +developer/developer-tools +developer/midi +developer/specifications +developer/contributing +developer/building +developer/monkey-patch +developer/tracing +developer/localization +developer/ports +developer/base +developer/man +developer/rpi +developer/linux +developer/distributions +developer/acknowledgements +developer/contact + ``` diff --git a/requirements.txt b/requirements.txt index 0225a94b..2741eaf0 100644 --- a/requirements.txt +++ b/requirements.txt @@ -1,12 +1,10 @@ wheel -sphinx>=3.3.0 -sphinx_rtd_theme +sphinx>=5.0.0 +sphinx_rtd_theme>=0.5.2 sphinx-autobuild -sphinx_git -#sphinx-reredirects -sphinxext-rediraffe -# will only work once a new release is made after sphinx-rtd-theme 0.5.0 sphinx-last-updated-by-git -recommonmark +myst-parser sphinxcontrib-qthelp -sphinx-markdown-tables +# docutils needs to be pinned for now so that lists work +# See https://github.com/readthedocs/sphinx_rtd_theme/issues/1115 for more information +docutils==0.16 diff --git a/user/components.md b/user/components.md index cc7b88db..6bdf4dc5 100644 --- a/user/components.md +++ b/user/components.md @@ -2,10 +2,12 @@ helloSystem consists of the following key components, each of which are described in this section: -```eval_rst -.. toctree:: - :maxdepth: 2 - :glob: - - components/* -``` + +```{toctree} +--- +maxdepth: 2 +glob: true +--- + +components/* +``` diff --git a/user/components/applications.md b/user/components/applications.md index 74957b11..de577603 100644 --- a/user/components/applications.md +++ b/user/components/applications.md @@ -8,10 +8,11 @@ helloSystem comes with some applications out of the box, and some applications n You find the applications in the menu under "System -> Applications", and in the `/Applications` folder on your hard disk, although they can also be placed in other locations if you so desire. -```eval_rst -.. toctree:: - :maxdepth: 2 - :glob: +```{toctree} +--- +maxdepth: 2 +glob: true +--- - applications/* +applications/* ``` diff --git a/user/components/preferences.md b/user/components/preferences.md index 792f9d6d..977f4cd3 100644 --- a/user/components/preferences.md +++ b/user/components/preferences.md @@ -2,10 +2,11 @@ helloSystem comes with the following preferences applications, each of which are described in this section: -```eval_rst -.. toctree:: - :maxdepth: 2 - :glob: +```{toctree} +--- +maxdepth: 2 +glob: true +--- - preferences/* -``` +preferences/* +``` diff --git a/user/components/preferences/boot-environments.md b/user/components/preferences/boot-environments.md index 4f3de5f2..cd967f31 100644 --- a/user/components/preferences/boot-environments.md +++ b/user/components/preferences/boot-environments.md @@ -4,15 +4,15 @@ _Boot Environments_ are bootable clones of snapshots of the working system. Boot Other applications may create Boot Environments automatically before performing critical operations such as major operating system upgrades. -``` .. warning:: - Boot Environments by default do not cover all locations, such as `/home` where your personal data is usually stored. -``` +:::{warning} +Boot Environments by default do not cover all locations, such as `/home` where your personal data is usually stored. +::: The __Boot Environments__ preferences application lets you view, create, remove, mount, and boot into Boot Environments. -``` .. note:: - Boot Environments functionality cannot be used when the system is running from Live media. It can only be used when the system has been installed to a disk. -``` +:::{note} +Boot Environments functionality cannot be used when the system is running from Live media. It can only be used when the system has been installed to a disk. +::: ## Viewing Boot Environments @@ -22,23 +22,23 @@ You will see the available Boot Environments. ## Creating Boot Environments -To create a new Boot Environment, click "New..." and enter a name for the new Boot Environment. +To create a new Boot Environment, click {guilabel}`New...` and enter a name for the new Boot Environment. ## Removing Boot Environments -Select a Boot Environment by clicking on it, and then press "Remove". Note that you cannot remove the currently active Boot Environment. +Select a Boot Environment by clicking on it, and then press {guilabel}`Remove`. Note that you cannot remove the currently active Boot Environment. ## Mounting Boot Environments You can make available, or "mount", existing Boot Environments, e.g., in order to inspect them or to copy files from there. -To do this, select a Boot Environment by clicking on it, and then press "Mount". Note that you cannot mount the currently active Boot Environment since it is already mounted at `/`. +To do this, select a Boot Environment by clicking on it, and then press {guilabel}`Mount`. Note that you cannot mount the currently active Boot Environment since it is already mounted at `/`. The selected Boot Environment will be mounted, and a Filer window will be opened at the mountpoint of the Boot Environment. ## Booting into a Boot Environment -Activate a Boot Environment by checking its checkbox, and then press "Restart...". The computer will restart into the selected Boot Environment. +Activate a Boot Environment by checking its checkbox, and then press {guilabel}`Restart...`. The computer will restart into the selected Boot Environment. ## More Information diff --git a/user/components/preferences/desktop.md b/user/components/preferences/desktop.md index 39b34e0e..443ce1f0 100644 --- a/user/components/preferences/desktop.md +++ b/user/components/preferences/desktop.md @@ -12,4 +12,4 @@ In this section of the __Desktop__ preferences application, you can select a fon ## Advanced -Under the __advanced__ tab of the __Desktop__ preferences application, advanced users can adjust additional aspects of the behavior of the desktop. Most users should leave the defaults. This tab may go away in a future version. +Under the {guilabel}`advanced` tab of the __Desktop__ preferences application, advanced users can adjust additional aspects of the behavior of the desktop. Most users should leave the defaults. This tab may go away in a future version. diff --git a/user/components/preferences/keyboard.md b/user/components/preferences/keyboard.md index 297ed612..bcae23b4 100644 --- a/user/components/preferences/keyboard.md +++ b/user/components/preferences/keyboard.md @@ -1,10 +1,10 @@ # Keyboard -The __Keyboard__ preferences application lets you change the keyboard layout (language) of your attached keyboard, and allows you to set which physical key should act as your ⌘ (command) key. It also lets you disable the Caps Lock key. +The __Keyboard__ preferences application lets you change the keyboard layout (language) of your attached keyboard, and allows you to set which physical key should act as your {kbd}`⌘` (command) key. It also lets you disable the {kbd}`Caps Lock` key. -``` .. note:: - The keyboard layout (language) gets set automatically during system startup if an official Raspberry Pi keyboard is attached or the system is running on Macintosh hardware, which has the prev-lang:kbd EFI key set. -``` +:::{note} +The keyboard layout (language) gets set automatically during system startup if an official Raspberry Pi keyboard is attached or the system is running on Macintosh hardware, which has the `prev-lang:kbd` EFI key set. +::: ## Setting the keyboard layout @@ -12,11 +12,11 @@ Simply click on a language (keyboard layout). The change is effective immediatel ## Selecting a physical key to act as ⌘ (command) -Swapping the keys will result in the key left from the spacebar to act as the ⌘ (command) key (like switchers from the Mac would expect) and therefore is the default. +Swapping the keys will result in the key left from the spacebar to act as the {kbd}`⌘` (command) key (like switchers from the Mac would expect) and therefore is the default. -__If a PC keyboard is attached__, you can select the "Use the Alt key as ⌘" checkbox. This will swap the __Ctrl__ and __Alt__ keys. +__If a PC keyboard is attached__, you can select the {guilabel}`Use the Alt key as ⌘` checkbox. This will swap the {kbd}`Ctrl` and {kbd}`Alt` keys. -__If an Apple keyboard is attached__, you can select the "Use the ⌘ key for menu shortcuts" checkbox. This will swap the __alt ⌥__ and __cmd ⌘__ keys. +__If an Apple keyboard is attached__, you can select the {guilabel}`Use the ⌘ key for menu shortcuts` checkbox. This will swap the {kbd}`alt ⌥` and {kbd}`cmd ⌘` keys. If you prefer the keys not be swapped, simply uncheck the respective checkbox. The change is effective immediately. diff --git a/user/components/preferences/sharing.md b/user/components/preferences/sharing.md index 1fabaa77..ecca57ad 100644 --- a/user/components/preferences/sharing.md +++ b/user/components/preferences/sharing.md @@ -10,11 +10,11 @@ The __Computer Name__ (hostname) is displayed. You can change it. Changes in the ## Remote Login -Check the __Remote Login__ checkbox to make your computer accessible over ssh. +Check the {guilabel}`Remote Login` checkbox to make your computer accessible over ssh. ## Screen Sharing -Check the __Screen Sharing__ checkbox to make the screen of your computer accessible through VNC over ssh and advertise it on the network. This allows another user who has an account on your computer to view the screen, and to control the computer as if they were sitting in front of it. This can be helpful, e.g., for getting help from colleagues. The __Screen Sharing__ checkbox will automatically be unchecked when the computer is restarted or after a connection has been made and has ended. +Check the {guilabel}`Screen Sharing` checkbox to make the screen of your computer accessible through VNC over ssh and advertise it on the network. This allows another user who has an account on your computer to view the screen, and to control the computer as if they were sitting in front of it. This can be helpful, e.g., for getting help from colleagues. The {guilabel}`Screen Sharing` checkbox will automatically be unchecked when the computer is restarted or after a connection has been made and has ended. ## Accessing the screen of remote computers @@ -23,23 +23,24 @@ Check the __Screen Sharing__ checkbox to make the screen of your computer access If Screen Sharing is active on the remote computer, then you can use [SSVNC](http://www.karlrunge.com/x11vnc/ssvnc.html) (available for Windows, Mac OS X, and various Unix-like systems) to access the machine over the local area network. In SSVNC please do: -* Under "VNC Host_Display" please enter: :0 -* Options... -> Check the "Use SSH" box and the "Unix Username & Password" box -* Under "Unix Username" enter the username you have set when you installed helloSystem -* Under "Unix Password" enter the password you have set when you installed helloSystem + +* Under {guilabel}`VNC Host_Display` please enter: `:0` +* {guilabel}`Options...` -> Check the {guilabel}`Use SSH` box and the {guilabel}`Unix Username & Password` box +* Under {guilabel}`Unix Username` enter the username you have set when you installed helloSystem +* Under {guilabel}`Unix Password` enter the password you have set when you installed helloSystem ## Accessing the screen of a remote computer that has Remote Login enabled If Screen Sharing is not active but Remote Login is active on the remote computer, then you can connect over the local area network and enable Screen Sharing as follows. Replace `user` with your username on the remote computer, and `FreeBSD.local.` with the hostname of the remote computer: -``` -ssh -t -L 5900:localhost:5900 user@FreeBSD.local. 'x11vnc -display :0 -auth /home/user/.Xauthority -once -localhost' +```console +$ ssh -t -L 5900:localhost:5900 user@FreeBSD.local. 'x11vnc -display :0 -auth /home/user/.Xauthority -once -localhost' ``` Log into the remote computer. Then start the Remote Desktop client as follows: -``` -ssvncviewer localhost +```console +$ ssvncviewer localhost ``` You should now be able to see and operate the screen. diff --git a/user/components/preferences/shortcuts.md b/user/components/preferences/shortcuts.md index 9c521597..2c0d2b18 100644 --- a/user/components/preferences/shortcuts.md +++ b/user/components/preferences/shortcuts.md @@ -1,47 +1,47 @@ # Shortcut Keys -The __Shortcut Keys__ preferences application lets you view and edit system-wide keyboard shortcuts. +The {guilabel}`Shortcut Keys` preferences application lets you view and edit system-wide keyboard shortcuts. -``` .. note:: - The left Ctrl and Alt keys are swapped in helloSystem by default to make shortcuts feel welcoming to switchers coming from the Mac. -``` +:::{note} +The left {kbd}`Ctrl` and {kbd}`Alt` keys are swapped in helloSystem by default to make shortcuts feel welcoming to switchers coming from the Mac. +::: A __shortcut__ is a key or key combination you can press to invoke a defined action on your computer. Shortcuts can be defined by applications (per-application shortcuts), or can affect the whole system (system-wide shortcuts). -``` .. note:: - The Shortcut Keys preferences application lets you view and edit system-wide keyboard shortcuts only, not per-application shortcuts. Some applications contain similar functionality inside the respective application to view and edit per-application keyboard shortcuts. -``` +:::{note} +The Shortcut Keys preferences application lets you view and edit system-wide keyboard shortcuts only, not per-application shortcuts. Some applications contain similar functionality inside the respective application to view and edit per-application keyboard shortcuts. +::: ## The ⌘ key -The ⌘ key, also known as Command, is the key left to the spacebar on helloSystem, unless you have configured your system differently. +The {kbd}`⌘` key, also known as __Command__, is the key left to the spacebar on helloSystem, unless you have configured your system differently. -``` .. note:: - Non-native software may refer to the Command key as "Ctrl". This is a known cosmetic issue. -``` +:::{note} +Non-native software may refer to the Command key as "Ctrl". This is a known cosmetic issue. +::: ## Default shortcuts -Open the __Shortcut Keys__ preferences application to view the default system-wide shortcuts. +Open the {guilabel}`Shortcut Keys` preferences application to view the default system-wide shortcuts. Notable default shortcuts include: -* Press `⌘Space` to __search in the Menu__ (e.g., to launch applications or to execute commands in the frontmost application) -* Press `Ctrl⌘Esc` and click on an application window to __forcefully quit an application__ that is malfunctioning -* Press `⌘⇧3` or the __PrtScn__ key on your keyboard to __take a screenshot__ -* Press `⌘⇧H` to go to the Home folder -* Press `⌘⇧A` to go to the Applications folder -* Press `⌘⇧U` to go to the Utilities folder -* Press `Ctrl⌘T` to open a Terminal -* Press `Ctrl⌘I` to open the internet browser +* Press {kbd}`⌘` + {kbd}`Space` to __search in the Menu__ (e.g., to launch applications or to execute commands in the frontmost application) +* Press {kbd}`Ctrl` + {kbd}`⌘` + {kbd}`Esc` and click on an application window to __forcefully quit an application__ that is malfunctioning +* Press {kbd}`⌘` + {kbd}`⇧` + {kbd}`3` or the {kbd}`PrtScn` key on your keyboard to __take a screenshot__ +* Press {kbd}`⌘` + {kbd}`⇧` + {kbd}`H` to go to the Home folder +* Press {kbd}`⌘` + {kbd}`⇧` + {kbd}`A` to go to the Applications folder +* Press {kbd}`⌘` + {kbd}`⇧` + {kbd}`U` to go to the Utilities folder +* Press {kbd}`Ctrl` + {kbd}`⌘` + {kbd}`T` to open a Terminal +* Press {kbd}`Ctrl` + {kbd}`⌘` + {kbd}`I` to open the internet browser This list is not exhaustive. ## Viewing shortcuts -For a complete list of system-wide shortcuts, please open the __Shortcut Keys__ preferences application to view the default shortcuts. +For a complete list of system-wide shortcuts, please open the {guilabel}`Shortcut Keys` preferences application to view the default shortcuts. ## Editing shortcuts -Use the buttons in the __Shortcut Keys__ preferences application to add, remove, and modify system-wide shortcuts. +Use the buttons in the {guilabel}`Shortcut Keys` preferences application to add, remove, and modify system-wide shortcuts. diff --git a/user/components/preferences/wireless-networks.md b/user/components/preferences/wireless-networks.md index 7cf4a7ea..1f94af73 100644 --- a/user/components/preferences/wireless-networks.md +++ b/user/components/preferences/wireless-networks.md @@ -1,9 +1,9 @@ # Wireless Networks -The __Wireless Networks__ preferences application lets you connect to wireless local area networks (WLANs). +The {guilabel}`Wireless Networks` preferences application lets you connect to wireless local area networks (WLANs). It is possible to use more than one wireless network card. -``` .. note:: - Please consider using the Hardware Probe utility in case your network card is not detected by the Wireless Networks preferences application. -``` +:::{note} +Please consider using the Hardware Probe utility in case your network card is not detected by the Wireless Networks preferences application. +::: diff --git a/user/components/system.md b/user/components/system.md index a54d3435..e85bcbbd 100644 --- a/user/components/system.md +++ b/user/components/system.md @@ -2,10 +2,11 @@ helloSystem comes with the following system components, each of which are described in this section: -```eval_rst -.. toctree:: - :maxdepth: 2 - :glob: +```{toctree} +--- +maxdepth: 2 +glob: true +--- - system/* +system/* ``` diff --git a/user/components/system/launch.md b/user/components/system/launch.md index 83590ace..fcf8cbbe 100644 --- a/user/components/system/launch.md +++ b/user/components/system/launch.md @@ -1,43 +1,39 @@ - # launch +# launch - ```eval_rst - .. epigraph:: +```{epigraph} +"It’s not just what it looks like and feels like. Design is how it works." - "It’s not just what it looks like and feels like. Design is how it works." - - -- Steve Jobs +-- Steve Jobs ``` - The `launch` command is used to launch graphical applications on helloSystem. When you select an application from the [Menu](menu.md) or the [Dock](dock.md), then the `launch` command is invoked to actually launch the application. - - ```eval_rst - .. hint:: - - As an end user who is using the graphical user interface exclusively, you will not need to interact with the `launch` command directly and can skip this section. - ``` - - ## Background - - On UNIX systems, applications are typically launched by entering the name of the executable file, which is searched in a fixed list of directories determined by the `$PATH` environment variable. - - Many graphical desktop environments use `.desktop` files to integrate applications with the system. While this has traditionally worked well for installed applications, it does not work well for dynamically changing applications that are moved in the filesystem, such as `.app` bundles or `.AppDir` directories. Also, it does not handle multiple versions of the same application gracefully. Hence, helloSystem uses the `launch` command to launch graphical applications. This has the following advantages: - - * You do not need to know the path to the application to be launched, even if the application is not on the `$PATH` - * If multiple versions of an application are available on the system, the most recent one will be launched automatically (unless specified otherwise by the user) __(to be implemented)__ - * If something goes wrong and the application cannot be launched, then a graphical error message will be shown on the screen - - ![Graphical error message if something goes wrong](https://pbs.twimg.com/media/EoLKXl7WEAAWCtQ?format=png) +The {command}`launch` command is used to launch graphical applications on helloSystem. When you select an application from the [Menu](menu.md) or the [Dock](dock.md), then the {command}`launch` command is invoked to actually launch the application. - ## Using the `launch` command +:::{hint} +As an end user who is using the graphical user interface exclusively, you will not need to interact with the {command}`launch` command directly and can skip this section. +::: - Whenever possible, graphical applications should be launched through the `launch` command on helloSystem. +## Background - There are several ways in which the `launch` command can be invoked: - - * `launch /Applications/Filer.app` - * `launch Filer.app` - * `launch Filer` +On UNIX systems, applications are typically launched by entering the name of the executable file, which is searched in a fixed list of directories determined by the `$PATH` environment variable. +Many graphical desktop environments use `.desktop` files to integrate applications with the system. While this has traditionally worked well for installed applications, it does not work well for dynamically changing applications that are moved in the filesystem, such as `.app` bundles or `.AppDir` directories. Also, it does not handle multiple versions of the same application gracefully. Hence, helloSystem uses the {command}`launch` command to launch graphical applications. This has the following advantages: + +* You do not need to know the path to the application to be launched, even if the application is not on the `$PATH` +* If multiple versions of an application are available on the system, the most recent one will be launched automatically (unless specified otherwise by the user) __(to be implemented)__ +* If something goes wrong and the application cannot be launched, then a graphical error message will be shown on the screen + +![Graphical error message if something goes wrong](https://pbs.twimg.com/media/EoLKXl7WEAAWCtQ?format=png) + +## Using the launch command + +Whenever possible, graphical applications should be launched through the {command}`launch` command on helloSystem. + +There are several ways in which the {command}`launch` command can be invoked: + +* `launch /Applications/Filer.app` +* `launch Filer.app` +* `launch Filer` + Note that capitalization can have subtle effects: * `launch audacity` launches `audacity` from the `$PATH` if it exists anywhere on the `$PATH` diff --git a/user/components/system/menu.md b/user/components/system/menu.md index 912f2860..dbdcad70 100644 --- a/user/components/system/menu.md +++ b/user/components/system/menu.md @@ -25,7 +25,7 @@ Select "Unhide all" to get all windows back on screen. Select an application from "Applications", "Utilities", or "Preferences" in the "Applications" menu. -A quicker way to launch an application is to press Alt+Space, enter a few characters of the application name, select one of the matches from the list, and press the Enter key. +A quicker way to launch an application is to press {kbd}`Alt+Space`, enter a few characters of the application name, select one of the matches from the list, and press the Enter key. ## Shutting down @@ -33,7 +33,7 @@ To shut down your computer, select "Log Out" from the "System" menu, then click ## Searching in application menus -Click on "Search" in the menu bar, or press __Alt+Space__. Then enter a few characters of the menu entry you would like to execute, select one of the matches from the list, and press the Enter key. If only one choice remains left as you are typing, the remaining entry automatically gets selected. +Click on "Search" in the menu bar, or press {kbd}`Alt+Space`. Then enter a few characters of the menu entry you would like to execute, select one of the matches from the list, and press the Enter key. If only one choice remains left as you are typing, the remaining entry automatically gets selected. ## Date and time diff --git a/user/components/utilities.md b/user/components/utilities.md index 1b1a8de6..03270a8d 100644 --- a/user/components/utilities.md +++ b/user/components/utilities.md @@ -2,10 +2,11 @@ helloSystem comes with the following utilities, each of which are described in this section: -```eval_rst -.. toctree:: - :maxdepth: 2 - :glob: +```{toctree} +--- +maxdepth: 2 +glob: true +--- - utilities/* +utilities/* ``` diff --git a/user/components/utilities/create-live-media.md b/user/components/utilities/create-live-media.md index dbbd0d26..29173a18 100644 --- a/user/components/utilities/create-live-media.md +++ b/user/components/utilities/create-live-media.md @@ -15,20 +15,20 @@ In order to create a Live medium, you need * A fast internet connection (a typical download is around 2 GiB) * A suitable external storage device, e.g., a USB3 device. USB2 devices can be used but performance may be degraded. On some systems, other storage media such as SD cards or microSD cards can be used. Consult the documentation that came with your computer to determine which type of media can be used to start your computer. -``` .. note:: - The **Create Live Media** utility cannot be used on other operating systems such as Windows, Linux, or macOS. - - If you would like to create Live Media for helloSystem using one of those operating systems, you can use applications that can write images to USB storage devices, such as [balenaEtcher](https://www.balena.io/etcher/). -``` +:::{note} +The **Create Live Media** utility cannot be used on other operating systems such as Windows, Linux, or macOS. + +If you would like to create Live Media for helloSystem using one of those operating systems, you can use applications that can write images to USB storage devices, such as [balenaEtcher](https://www.balena.io/etcher/). +::: ## Downloading and writing Live Media The __Create Live Media__ utility downloads and writes a Live ISO image in one go to a storage medium. Open the __Create Live Media__ utility and follow the instructions on screen. -``` .. warning:: - The **Create Live Media** utility will overwrite the entire contents of the selected device, including all of its pre-existing partitions. Take extra caution when selecting the target device. - - This operation cannot be undone. -``` +:::{warning} +The **Create Live Media** utility will overwrite the entire contents of the selected device, including all of its pre-existing partitions. Take extra caution when selecting the target device. + +This operation cannot be undone. +::: Once the image has been written to the device successfully, you can restart your computer to start from the Live Medium, or remove the device and insert it into another computer to start that computer from the Live Medium. diff --git a/user/components/utilities/hardware-probe.md b/user/components/utilities/hardware-probe.md index af91839f..c394d810 100644 --- a/user/components/utilities/hardware-probe.md +++ b/user/components/utilities/hardware-probe.md @@ -16,11 +16,11 @@ Private information (including the username, machine's hostname, IP addresses, M The tool uploads 32-byte prefix of salted SHA512 hash of MAC addresses/UUIDs and serial numbers to properly identify unique computers and hard drives. All the data is uploaded securely via HTTPS. -``` .. note:: - By using this utility to upload your hardware probe, you agree that information about your hardware will be uploaded to a publicly visible database. +:::{note} +By using this utility to upload your hardware probe, you agree that information about your hardware will be uploaded to a publicly visible database. - Do not use this utility if you do not agree with this. -``` +Do not use this utility if you do not agree with this. +::: By uploading your hardware probe you confirm uploading of 32-byte prefix of salted SHA512 hash of MAC addresses and serial numbers to prevent duplication of computers in the database. diff --git a/user/components/utilities/install.md b/user/components/utilities/install.md index 67d076f6..24f7f9af 100644 --- a/user/components/utilities/install.md +++ b/user/components/utilities/install.md @@ -4,9 +4,9 @@ Once you have tried out helloSystem from the live medium, you may want to instal The __Install FreeBSD__ utility lets you install helloSystem on your computer from a running Live system. -``` .. note:: - The utility is called **Install FreeBSD** to signify that helloSystem contains a largely unmodified FreeBSD core operating system. It might be renamed "Install helloSystem" in the future. -``` +:::{note} +The utility is called **Install FreeBSD** to signify that helloSystem contains a largely unmodified FreeBSD core operating system. It might be renamed "Install helloSystem" in the future. +::: ![Install FreeBSD](https://user-images.githubusercontent.com/2480569/93003377-7d77c480-f53e-11ea-9e2d-aed1b41a17df.png) @@ -24,11 +24,11 @@ Start your computer from a helloSystem Live Medium. Open the __Install FreeBSD__ The installer starts by presenting a summary of FreeBSD. Click on "Continue". To install the software, you must agree to the terms of the software license agreement. Click on "Continue" to proceed. Click on a destination disk on which the operating system should be installed. A warning will inform you that the entire disk will be erased. Confirm whether you want to do this by clicking on the appropriate button. -``` .. warning:: - The **Install FreeBSD** utility will overwrite the entire contents of the selected device, including all of its pre-existing partitions. Take extra caution when selecting the target device. +:::{warning} +The **Install FreeBSD** utility will overwrite the entire contents of the selected device, including all of its pre-existing partitions. Take extra caution when selecting the target device. - This operation cannot be undone. -``` +This operation cannot be undone. +::: If you are really sure that you have selected the correct device, click "Continue". diff --git a/user/components/utilities/remote-assistance.md b/user/components/utilities/remote-assistance.md index d14c9dab..87e3c97f 100644 --- a/user/components/utilities/remote-assistance.md +++ b/user/components/utilities/remote-assistance.md @@ -2,9 +2,9 @@ The __Remote Assistance__ utility allows a peer on the Internet to access and control your computer using the encrypted peer-to-peer Tox protocol. This can be helpful, e.g., to receive help from a friend. -``` .. warning:: - Running the **Remote Assistance** utility will give your peer access to the screen, mouse, and keyboard of your computer, and read-write to any ports that may be open on your machine. Only share the ID with people you trust. -``` +:::{warning} +Running the **Remote Assistance** utility will give your peer access to the screen, mouse, and keyboard of your computer, and read-write to any ports that may be open on your machine. Only share the ID with people you trust. +::: ## Receiving Remote Assistance diff --git a/user/components/utilities/update.md b/user/components/utilities/update.md index 5d5e429b..68baa26d 100644 --- a/user/components/utilities/update.md +++ b/user/components/utilities/update.md @@ -2,9 +2,9 @@ Once you have installed the system to the hard disk in your computer, or an externally attached storage device, you may want to keep it recent by running the __Update__ utility from time to time. -``` .. note:: - This utility is currently in **Developer Preview** status and is intended for developers and testers. Only use it if you have a backup of your system or if you are running on a test system that you can set up from scratch if needed. -``` +:::{note} +This utility is currently in **Developer Preview** status and is intended for developers and testers. Only use it if you have a backup of your system or if you are running on a test system that you can set up from scratch if needed. +::: This utility * Creates a new Boot Environment (bootable partial snapshot). __This is not a full replacement for a backup__ but should allow you to roll back to the state before the update, should something go wrong diff --git a/user/getting-started.md b/user/getting-started.md index 27a320d6..85f0337a 100644 --- a/user/getting-started.md +++ b/user/getting-started.md @@ -23,8 +23,9 @@ The **helloSystem 0.8.0** ISO image is available for download [here](https://git Experimental and pre-release images are available for download [here](https://github.com/helloSystem/ISO/releases). -> :warning: **Important**
Experimental images get built automatically whenever source code is committed. Not every build is tested. Builds marked as "Pre-Release" are strictly for developers, may be broken and may not even boot. - +:::{important} +Experimental images get built automatically whenever source code is committed. Not every build is tested. Builds marked as "Pre-Release" are strictly for developers, may be broken and may not even boot. +::: ## Creating Live Media @@ -34,8 +35,8 @@ helloSystem comes with a __Create Live Media__ utility that allows to write ISO If you are not running helloSystem yet or would like to use the command line, the following command should work on all BSD flavors: -``` -sudo dd if= of=/dev/daX bs=4m status=progress +```console +$ sudo dd if= of=/dev/daX bs=4m status=progress ``` On GNU-style systems (e.g., most Linux distributions), `status=progress` does not work and can be left away. @@ -81,18 +82,16 @@ Detailed information on #FreeBSD wireless network card compatibility is availabl ## Virtualization environments -> :warning: **Note**:
We recommend running helloSystem on real hardware ("bare metal") if possible. This should give you the best possible performance and hardware support. +:::{note} +We recommend running helloSystem on real hardware ("bare metal") if possible. This should give you the best possible performance and hardware support. +::: Users have reported success in running helloSystem in the following virtualization environments: * VirtualBox host (on FreeBSD and on macOS), known to work in BIOS and EFI modes - * VMware Workstation works in BIOS and EFI modes (see below) - * QEMU host (on Linux), works in both BIOS and EFI modes (see below). Note that for acceptable performance, QEMU needs KVM which is currently not available on FreeBSD hosts yet - * Parallels host, reported to work in EFI mode (see below) - * Proxmox VE Please note: @@ -109,7 +108,7 @@ Please report back about the results on your virtualization environment. Create an 8 GiB (or larger) `hello.img` image file on which you can install the system: -``` +```console $ pwd /home/user $ mkdir -p .qemu/hello @@ -118,8 +117,8 @@ $ fallocate -l $(( 8*1024*1024*1024 )) .qemu/hello/hello.img Then, boot helloSystem: -``` -qemu-system-x86_64 -machine type=q35,accel=kvm \ +```console +$ qemu-system-x86_64 -machine type=q35,accel=kvm \ -enable-kvm -cpu host -smp 2 -m 4096 \ -device virtio-net,netdev=vmnic -netdev user,id=vmnic,hostfwd=tcp::5222-:22 \ -vga std -soundhw hda -no-quit \ @@ -144,7 +143,7 @@ To boot/install hello in UEFI mode, first install [OVMF Open Virtual Machine Fir Then add these two `qemu-system-x86_64` options: -``` +```text -bios /usr/share/edk2/ovmf/OVMF_CODE.fd \ -smbios type=0,vendor=0vendor,version=0version,date=0date,release=0.0,uefi=on \ ``` @@ -173,11 +172,15 @@ To set resolution, press F2 at boot to access OVMF settings. Select 'Device Mana ### VMware Workstation Tested on VMware Workstation 16.2.1 -> :warning: **Installation Issue**
For best results while installing, please set your CPU to 1 socket, and no more than 4 cores.
After installation, you can set the CPU socket and core count to your desire. +:::{admonition} Installation issue +:class: warning + +For best results while installing, please set your CPU to 1 socket, and no more than 4 cores + +After installation, you can set the CPU socket and core count to your desire. +::: * Memory: 4GB * Processors: 4 (1 socket, 4 cores) * Hard Disk: At least 8GB * Guest Operating System Version: FreeBSD 12 64-bit - - diff --git a/user/troubleshooting.md b/user/troubleshooting.md index 5170eb4e..1227b09a 100644 --- a/user/troubleshooting.md +++ b/user/troubleshooting.md @@ -6,7 +6,7 @@ It can take up to five minutes to start the system in Live mode. If you see the FreeBSD logo on screen for more than five minutes, then something might be wrong and you might need to restart the computer. -If – after five minutes – you're reluctant to stop the computer, you can occasionally [key Ctrl-T](https://hellosystem.github.io/docs/developer/boot.html#seeing-what-the-system-is-doing-while-the-graphical-boot-screen-is-shown) to get some information about what the computer is doing. If there is no change from one snippet to the next, across three or more snippets, you may reasonably assume that the computer needs to be restarted. +If – after five minutes – you're reluctant to stop the computer, you can occasionally [key {kbd}`Ctrl-T`](https://hellosystem.github.io/docs/developer/boot.html#seeing-what-the-system-is-doing-while-the-graphical-boot-screen-is-shown) to get some information about what the computer is doing. If there is no change from one snippet to the next, across three or more snippets, you may reasonably assume that the computer needs to be restarted. * Please restart the computer. If normal use of the power button is not effective, press and hold. * Then, please [start the computer in verbose mode](https://hellosystem.github.io/docs/developer/boot.html#boot-in-verbose-mode) to see any relevant error messages that may help in resolving the issue. @@ -16,7 +16,7 @@ If – after five minutes – you're reluctant to stop the computer, you can occ This means that Xorg has been started but for some reason the login manager `slim` or the helloDesktop startup script `start-hello` cannot run. * Boot in verbose mode -* Press Ctrl+Alt+F2 +* Press {kbd}`Ctrl+Alt+F2` * Log in * `sudo killall Xorg` * `sudo service dbus restart` @@ -38,15 +38,15 @@ If this does not work: When debugging application issues, it can be helpful to see what an application is actually doing. For example, if we are interested in which libraries with "menu" in their name `firefox` is loading, we can run -``` -LD_DEBUG=libs firefox 2>&1 | grep -i menu +```console +$ LD_DEBUG=libs firefox 2>&1 | grep -i menu ``` Or, if we are interested in which activities with "menu" in their name `firefox` is doing, we can run -``` -sudo sysctl security.bsd.unprivileged_proc_debug=1 -truss firefox 2>&1 | grep -e menu +```console +$ sudo sysctl security.bsd.unprivileged_proc_debug=1 +$ truss firefox 2>&1 | grep -e menu ``` ## Other issues From afba57ac69a48c36e8285196eafb6cc22dc488d2 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ciar=C3=A1n=20Ainsworth?= Date: Mon, 6 Feb 2023 20:21:10 +0100 Subject: [PATCH 530/592] chore: fix epub cover and TOC (#49) --- conf.py | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/conf.py b/conf.py index 8572031d..cf03017b 100644 --- a/conf.py +++ b/conf.py @@ -81,7 +81,8 @@ html_show_sphinx = False html_logo = "_static/hello_logo.png" -epub_cover = ('_static/hello_logo.png', 'epub-cover.html') +epub_cover = ('./_static/hello_logo.png', 'epub-cover.html') +epub_tocscope = "includehidden" # Add any paths that contain custom static files (such as style sheets) here, # relative to this directory. They are copied after the builtin static files, From 84fc59fa3ecdd765e46074ff76b74dab0931d408 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 6 Feb 2023 22:01:03 +0100 Subject: [PATCH 531/592] Revert "chore: fix epub cover and TOC (#49)" (#50) This reverts commit afba57ac69a48c36e8285196eafb6cc22dc488d2. --- conf.py | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/conf.py b/conf.py index cf03017b..8572031d 100644 --- a/conf.py +++ b/conf.py @@ -81,8 +81,7 @@ html_show_sphinx = False html_logo = "_static/hello_logo.png" -epub_cover = ('./_static/hello_logo.png', 'epub-cover.html') -epub_tocscope = "includehidden" +epub_cover = ('_static/hello_logo.png', 'epub-cover.html') # Add any paths that contain custom static files (such as style sheets) here, # relative to this directory. They are copied after the builtin static files, From 70c61c2abc5b798c91f408f9408b216e4b4a1d39 Mon Sep 17 00:00:00 2001 From: probonopd Date: Fri, 17 Feb 2023 20:48:15 +0100 Subject: [PATCH 532/592] Update dock.md --- user/components/system/dock.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/user/components/system/dock.md b/user/components/system/dock.md index 2ddfab88..d97b1224 100644 --- a/user/components/system/dock.md +++ b/user/components/system/dock.md @@ -4,6 +4,8 @@ The __Dock__ is a quick way to launch the most commonly used applications, and a It typically sits at the bottom of the screen. +As of helloSystem 0.8.0, the Dock is not started automatically anymore, but you can run it by double-clicking its icon in /System. + ## Launching applications To launch an application, click on it in the Dock. From 70d77ee6f6f38d8c50f1f927b66726b2fdf5f525 Mon Sep 17 00:00:00 2001 From: probonopd Date: Fri, 17 Feb 2023 20:49:34 +0100 Subject: [PATCH 533/592] Update dock.md --- user/components/system/dock.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/user/components/system/dock.md b/user/components/system/dock.md index d97b1224..cc14e76a 100644 --- a/user/components/system/dock.md +++ b/user/components/system/dock.md @@ -4,7 +4,7 @@ The __Dock__ is a quick way to launch the most commonly used applications, and a It typically sits at the bottom of the screen. -As of helloSystem 0.8.0, the Dock is not started automatically anymore, but you can run it by double-clicking its icon in /System. +As of helloSystem 0.8.0, the Dock is not started automatically anymore, but you can run it by double-clicking its icon in /System. You can also put a symlink into /Applications/Autostart if you like, or start it programmatically with `launch Dock`. ## Launching applications From b5943218d28064f9cd2152b36378d61f7a9c9340 Mon Sep 17 00:00:00 2001 From: probonopd Date: Fri, 17 Feb 2023 20:50:51 +0100 Subject: [PATCH 534/592] Update dock.md --- user/components/system/dock.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/user/components/system/dock.md b/user/components/system/dock.md index cc14e76a..15ca0be3 100644 --- a/user/components/system/dock.md +++ b/user/components/system/dock.md @@ -4,7 +4,7 @@ The __Dock__ is a quick way to launch the most commonly used applications, and a It typically sits at the bottom of the screen. -As of helloSystem 0.8.0, the Dock is not started automatically anymore, but you can run it by double-clicking its icon in /System. You can also put a symlink into /Applications/Autostart if you like, or start it programmatically with `launch Dock`. +As of helloSystem 0.8.0, the Dock is not started automatically anymore, but you can run it by double-clicking its icon in /System. You can also put a symlink into /Applications/Autostart if you like (`sudo ln -s /System/Dock.app /Applications/Autostart/`), or start it programmatically with `launch Dock`. ## Launching applications From a7fda5281fb8040a541b2fbfabdb113459f090ef Mon Sep 17 00:00:00 2001 From: probonopd Date: Tue, 21 Feb 2023 19:12:23 +0100 Subject: [PATCH 535/592] Update install.md --- user/components/utilities/install.md | 15 ++++++++------- 1 file changed, 8 insertions(+), 7 deletions(-) diff --git a/user/components/utilities/install.md b/user/components/utilities/install.md index 24f7f9af..654057ff 100644 --- a/user/components/utilities/install.md +++ b/user/components/utilities/install.md @@ -1,16 +1,16 @@ -# Install FreeBSD +# Install helloSystem Once you have tried out helloSystem from the live medium, you may want to install the system to the hard disk in your computer, or an externally attached storage device. -The __Install FreeBSD__ utility lets you install helloSystem on your computer from a running Live system. +The __Install helloSystem utility lets you install helloSystem on your computer from a running Live system. :::{note} -The utility is called **Install FreeBSD** to signify that helloSystem contains a largely unmodified FreeBSD core operating system. It might be renamed "Install helloSystem" in the future. +The utility is called **Install helloSystem** to signify that helloSystem contains a largely unmodified FreeBSD core operating system. It might be renamed "Install helloSystem" in the future. ::: ![Install FreeBSD](https://user-images.githubusercontent.com/2480569/93003377-7d77c480-f53e-11ea-9e2d-aed1b41a17df.png) -When you install helloSystem using the __Install FreeBSD__ utility, the installed system will behave like the Live system in most aspects. +When you install helloSystem using the __Install helloSystem utility, the installed system will behave like the Live system in most aspects. ## Prerequisites @@ -20,12 +20,12 @@ When you install helloSystem using the __Install FreeBSD__ utility, the installe ## Installing helloSystem -Start your computer from a helloSystem Live Medium. Open the __Install FreeBSD__ utility and follow the instructions on screen. +Start your computer from a helloSystem Live Medium. Open the __Install helloSystem utility and follow the instructions on screen. -The installer starts by presenting a summary of FreeBSD. Click on "Continue". To install the software, you must agree to the terms of the software license agreement. Click on "Continue" to proceed. Click on a destination disk on which the operating system should be installed. A warning will inform you that the entire disk will be erased. Confirm whether you want to do this by clicking on the appropriate button. +The installer starts by presenting a summary. Click on "Continue". To install the software, you must agree to the terms of the software license agreement. Click on "Continue" to proceed. Click on a destination disk on which the operating system should be installed. A warning will inform you that the entire disk will be erased. Confirm whether you want to do this by clicking on the appropriate button. :::{warning} -The **Install FreeBSD** utility will overwrite the entire contents of the selected device, including all of its pre-existing partitions. Take extra caution when selecting the target device. +The **Install helloSystem** utility will overwrite the entire contents of the selected device, including all of its pre-existing partitions. Take extra caution when selecting the target device. This operation cannot be undone. ::: @@ -40,6 +40,7 @@ In the next step, you will create an account for the main user of the computer. * The field __Computer Name__ will be automatically populated with a suggested computer name (hostname). This name will be used to identify your computer on the local area network. It must not contain any special characters such as blanks. You can override the suggested default if you like. Example: `Johns-TravelMate-B117-M` * Check the checkbox __Enable users to log in over the network (ssh)__ if you would like to allow accessing the computer remotely. By default, this requires a password to be set for the computer account * Check the checkbox __Set time zone based on current location__ if you would like timezone on the installed system to be set automatically. This feature requires an active internet connection +* Check the checkbox __Disable swap (recommended for USB sticks and SD cards)__ if you are installing the operating system to a medium on which no swap space should be used. This may be advisable on small system disks, and when installing to slower flash based media such as USB sticks and SD cards Click "Continue" to proceed. The system will be installed to the selected disk. This process typically takes a couple of minutes depending on your system configuration, during which a progress bar will be shown. From 1cb893c2a5e97083217aca47d78ed9945bebc62e Mon Sep 17 00:00:00 2001 From: probonopd Date: Tue, 21 Feb 2023 23:44:00 +0100 Subject: [PATCH 536/592] Update getting-started.md --- user/getting-started.md | 6 ------ 1 file changed, 6 deletions(-) diff --git a/user/getting-started.md b/user/getting-started.md index 85f0337a..77817e33 100644 --- a/user/getting-started.md +++ b/user/getting-started.md @@ -1,9 +1,5 @@ # Getting started -## Status - -hello is currently being developed. It is not yet available for general use, but advanced users can try out continuous builds of pre-alpha ISO images that can be booted from DVD or USB storage media. - ## System requirements * 2 GHz dual core Intel/AMD 64-bit processor @@ -12,8 +8,6 @@ hello is currently being developed. It is not yet available for general use, but * Either a CD/DVD drive or a USB port for booting the installer media * On non-Macintosh hardware, a [Raspberry Pi keyboard](https://static.raspberrypi.org/files/product-briefs/210108_Product_Brief_Keyboard_and_Mouse.pdf) is recommended as it allows the keyboard and system language to be detected automatically if it is attached while the system is starting up. On Macintosh hardware, the `prev-lang:kbd` EFI variable is usually set and is used to detect the keyboard and system language. Note that the key left to the space bar is used as the Command key (Alt key on PC keyboards, Apple key on Apple keyboards). -In the future, there may also be builds for other processor architectures. We would like to bring down the RAM requirement considerably. - Please refer to [FreeBSD Hardware Compatibility](https://www.freebsd.org/doc/en_US.ISO8859-1/books/faq/hardware.html) for more information on individual components. ## Downloading From d200bea75b944abf693dda2a5579f0feaedea67d Mon Sep 17 00:00:00 2001 From: probonopd Date: Wed, 22 Feb 2023 20:24:33 +0100 Subject: [PATCH 537/592] Update boot.md --- developer/boot.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/developer/boot.md b/developer/boot.md index 7382acb7..9275016a 100644 --- a/developer/boot.md +++ b/developer/boot.md @@ -72,7 +72,7 @@ $ sudo chmod +x /usr/local/etc/rc.d/late-start $ sudo service late-start disable_early_services ``` -Check which services are still enabled, should now be treatly reduced: +Check which services are still enabled, should now be greatly reduced: ```console $ grep -r 'enable="YES"' /etc/rc.conf* @@ -86,6 +86,10 @@ $ grep -r 'enable="YES"' /etc/rc.conf* Reboot. The graphical desktop (including a usable mouse pointer) should appear ~10 seconds faster, but the network will start to work only after ~10 seconds. +:::{note} +This starts services like sshd; you need to edit the {file}`/usr/local/etc/rc.d/late-start` script to only start the services you would like to be started. +::: + ## Debugging the Live system boot process The following has been tested on experimental helloSystem 0.8.0 builds. From 1bb8e28855388afc3d612dec26372861347afae0 Mon Sep 17 00:00:00 2001 From: probonopd Date: Wed, 22 Feb 2023 23:07:18 +0100 Subject: [PATCH 538/592] Reviewer's Guide [ci skip] --- index.md | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/index.md b/index.md index 50294fea..bd928249 100644 --- a/index.md +++ b/index.md @@ -65,3 +65,14 @@ developer/acknowledgements developer/contact ``` + +```{toctree} +--- +caption: Reviewer's Guide +hidden: true +maxdepth: 2 +glob: true +--- + +reviewer/guide +``` From cb1bf91129a060f3cfafb0dbfd311306b1bcbd36 Mon Sep 17 00:00:00 2001 From: probonopd Date: Wed, 22 Feb 2023 23:07:52 +0100 Subject: [PATCH 539/592] Create guide.md --- reviewer/guide.md | 79 +++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 79 insertions(+) create mode 100644 reviewer/guide.md diff --git a/reviewer/guide.md b/reviewer/guide.md new file mode 100644 index 00000000..1ac460ac --- /dev/null +++ b/reviewer/guide.md @@ -0,0 +1,79 @@ +# Reviewer's Guide + +## Introduction +HelloSystem is an open-source operating system based on FreeBSD. Its goal is to provide a stable, user-friendly, and visually appealing system for desktop and laptop computers. The system is designed to be easy to use, highly customizable, and efficient, with an emphasis on minimalism and simplicity. + +The purpose of this reviewer's guide is to provide an overview of helloSystem, as well as to offer guidance on how to use the system's features and capabilities. The guide includes information on system requirements, installation, user interface, features, performance, support options, and more. + +Whether you are a new user looking to explore helloSystem for the first time, or an experienced user seeking to learn more about its features and capabilities, this guide should provide you with a comprehensive understanding of the system and its functionality. + +## System Requirements +To run helloSystem, you will need a system that meets the following minimum requirements: + +- 64-bit x86 processor +- 4 GB of RAM +- 30 GB of available hard disk space +- Graphics card capable of 1024x768 resolution + +For optimal performance, we recommend the following: + +- 8 GB of RAM or more +- Graphics card capable of 1920x1080 resolution or higher + +Please note that helloSystem is not currently compatible with ARM-based processors. + +When reviewing or benchmarking helloSystem, it is important to note that virtual machines may not provide an accurate representation of the system's stability, feature set, and performance. Therefore, we recommend that reviewers use real hardware for these purposes. Running helloSystem on actual hardware will provide a more authentic experience and allow reviewers to test the system's capabilities in a more realistic environment. Additionally, using real hardware will help to ensure that the system's hardware support is properly evaluated. For these reasons, we strongly advise against conducting tests and benchmarks in a virtual environment, even though VirtualBox guest drivers are preinstalled. + +## Installation + +Installing helloSystem is a relatively straightforward process. Follow these steps to install helloSystem on your system: + +1. Download the helloSystem ISO file from the helloSystem website. +2. Burn the ISO file to a USB drive or DVD. +3. Insert the USB drive or DVD into your computer and boot from it. +4. Follow the on-screen instructions to install helloSystem. + +helloSystem is designed to be installed on a dedicated SSD, and for the sake of simplicity currently cannot be installed alongside other operating systems on the same disk. Additionally, if you are running helloSystem on a device with a UEFI firmware, you may need to disable Secure Boot in order to boot into helloSystem. + +If you encounter any issues during the installation process, please consult the helloSystem documentation or contact the [helloSystem discussion forum](https://github.com/helloSystem/hello/discussions/) for assistance. + +## User Interface + +The helloSystem user interface is designed to be intuitive, functional, and customizable, with a range of features and tools to meet the needs of both new and experienced users. Here are some key concepts: + +- Command key being left to the spacebar: On systems with a Mac-style keyboard, the Command key is located to the left of the spacebar, which can be more comfortable for Mac users. + +- Global menu bar: helloSystem features a global menu bar, which is a menu bar that is located at the top of the screen, rather than within the application window. This provides for a consistent user experience across applications, even if those applications are written in non-native frameworks such as Gtk or Electron. + +- Keyboard layout and language autodetection: When using a Mac or Raspberry Pi Keyboard and Hub, helloSystem will automatically detect the keyboard layout and language, making it easy to type in your preferred language. + +- Menu search and launcher functionality: helloSystem includes a powerful menu search and launcher, which can be used to quickly find and launch applications, files, and commands. It is located in the top right corner of the global menu bar. + +- Application bundle structure: Applications on helloSystem are structured as self-contained bundles, which can be easily installed, removed, and updated. + +- Launch command using a database: helloSystem uses a database to manage launch commands, rather than relying on traditional XDG desktop files, which can provide better performance and reliability. + +- Source code editability for many Utilities: Many of the utilities included with helloSystem have their source code included, making it easy for users to customize and contribute to the system. + +- "Under Construction": The "Under Construction" section of the menu provides access to various utilities and tools that are currently in development, and are looking for contributors to help bring them to completion. + +- Create Live Media tool: helloSystem includes a tool for creating live media, which can be used to create a bootable USB or DVD to try helloSystem without installing it on your system. + + +## Features +- Detailed list of features in helloSystem +- Purpose and functionality of each feature +- Examples of how to use each feature + +## Performance +- Details of helloSystem's performance +- Benchmarks or tests conducted +- Comparisons to other similar operating systems + +## Support +- Explanation of support options available for helloSystem +- Contact information for support (e.g., email or forums) + +## Conclusion +- Summary of key points in the reviewer's guide +- Overall impression of helloSystem From 4296a166b060f2c821f257d46e26b6186ed1e829 Mon Sep 17 00:00:00 2001 From: probonopd Date: Wed, 22 Feb 2023 23:18:34 +0100 Subject: [PATCH 540/592] Update guide.md --- reviewer/guide.md | 21 +++++++++++---------- 1 file changed, 11 insertions(+), 10 deletions(-) diff --git a/reviewer/guide.md b/reviewer/guide.md index 1ac460ac..381f7a1a 100644 --- a/reviewer/guide.md +++ b/reviewer/guide.md @@ -39,26 +39,27 @@ If you encounter any issues during the installation process, please consult the ## User Interface -The helloSystem user interface is designed to be intuitive, functional, and customizable, with a range of features and tools to meet the needs of both new and experienced users. Here are some key concepts: +The six-part series on [Linux desktop usability](https://medium.com/@probonopd/make-it-simple-linux-desktop-usability-part-1-5fa0fb369b42) by helloSystem's founder eventually lead to the design and development of helloSystem. The series explored aspects of desktop usability, from user interface design to application packaging and distribution. The insights expressed in the series helped inform the design decisions behind helloSystem, with a focus on simplicity, ease of use, and discoverability. The indended result is a user-friendly and efficient operating system that is easy to use and customize, even for non-technical users. -- Command key being left to the spacebar: On systems with a Mac-style keyboard, the Command key is located to the left of the spacebar, which can be more comfortable for Mac users. +The helloSystem user interface is designed to be intuitive, functional, and discoverable, with a range of features and tools to meet the needs of both new and experienced users. Here are some key concepts: -- Global menu bar: helloSystem features a global menu bar, which is a menu bar that is located at the top of the screen, rather than within the application window. This provides for a consistent user experience across applications, even if those applications are written in non-native frameworks such as Gtk or Electron. +- **Command key** left to the spacebar: On systems with a Mac-style keyboard, the Command key is located to the left of the spacebar, which can be more comfortable for Mac users. When helloSystem is used with a PC keyboard, the Alt key functions as the Command key, being located in the same physical location on the keyboard. -- Keyboard layout and language autodetection: When using a Mac or Raspberry Pi Keyboard and Hub, helloSystem will automatically detect the keyboard layout and language, making it easy to type in your preferred language. +- **Global menu bar**: helloSystem features a global menu bar, which is a menu bar that is located at the top of the screen, rather than within the application window. This provides for a consistent user experience across applications, even if those applications are written in non-native frameworks such as Gtk or Electron. -- Menu search and launcher functionality: helloSystem includes a powerful menu search and launcher, which can be used to quickly find and launch applications, files, and commands. It is located in the top right corner of the global menu bar. +- **Keyboard layout and language autodetection**: When using a Mac or a [Raspberry Pi Keyboard and Hub](https://www.raspberrypi.com/products/raspberry-pi-keyboard-and-hub/), helloSystem will automatically detect the keyboard layout and language, removing the need to configure it manually. -- Application bundle structure: Applications on helloSystem are structured as self-contained bundles, which can be easily installed, removed, and updated. +- **Menu search and launcher**: helloSystem includes a powerful menu search and launcher, which can be used to quickly find and launch applications, files, and menu commands. It is located in the top right corner of the global menu bar and can be a true productivity booster, as it allows the system to be operated virtually only by using the keyboard. -- Launch command using a database: helloSystem uses a database to manage launch commands, rather than relying on traditional XDG desktop files, which can provide better performance and reliability. +- **Application bundles**: Applications on helloSystem are structured as self-contained bundles, which can be easily installed, removed, and updated. -- Source code editability for many Utilities: Many of the utilities included with helloSystem have their source code included, making it easy for users to customize and contribute to the system. +- **`launch` command using a database**: helloSystem uses a database to manage launch commands, rather than relying on traditional XDG desktop files, which will provide better functionality, e.g., for applications that can be freely moved around in the fileystem without the need to update `.desktop` files. -- "Under Construction": The "Under Construction" section of the menu provides access to various utilities and tools that are currently in development, and are looking for contributors to help bring them to completion. +- **Source code editability** for many Utilities: Many of the utilities included with helloSystem have their source code included and do not need to be compiled, making it easy for users to customize and contribute to the system. Right-click on an application icon and choose "Show Contents" to see and edit the source code. -- Create Live Media tool: helloSystem includes a tool for creating live media, which can be used to create a bootable USB or DVD to try helloSystem without installing it on your system. +- **Under Construction**: The "Under Construction" section of the menu provides access to various utilities and tools that are currently in development, and are looking for contributors to help bring them to completion. +- **Create Live Media** utility: helloSystem includes a tool for creating live media, which can be used to create a bootable USB or DVD to try helloSystem without installing it on your system. It can also burn the latest, frequently released, experimental ISO builds directly to USB sticks. ## Features - Detailed list of features in helloSystem From a6047d24add71e9c5e78d82346c09b9cdbc26841 Mon Sep 17 00:00:00 2001 From: probonopd Date: Wed, 22 Feb 2023 23:30:58 +0100 Subject: [PATCH 541/592] Update guide.md --- reviewer/guide.md | 42 ++++++++++++++++++++++-------------------- 1 file changed, 22 insertions(+), 20 deletions(-) diff --git a/reviewer/guide.md b/reviewer/guide.md index 381f7a1a..7c6c444c 100644 --- a/reviewer/guide.md +++ b/reviewer/guide.md @@ -8,21 +8,23 @@ The purpose of this reviewer's guide is to provide an overview of helloSystem, a Whether you are a new user looking to explore helloSystem for the first time, or an experienced user seeking to learn more about its features and capabilities, this guide should provide you with a comprehensive understanding of the system and its functionality. ## System Requirements + To run helloSystem, you will need a system that meets the following minimum requirements: - 64-bit x86 processor -- 4 GB of RAM -- 30 GB of available hard disk space +- 2 GB of RAM +- Dedicated storage device with at least 10 GB of available space - Graphics card capable of 1024x768 resolution For optimal performance, we recommend the following: -- 8 GB of RAM or more +- 4 GB of RAM or more +- Dedicated SSD with at least 120 GB of available space - Graphics card capable of 1920x1080 resolution or higher -Please note that helloSystem is not currently compatible with ARM-based processors. +Please note that helloSystem is not currently available for computers with ARM-based processors, although there are build instructions for Raspberry Pi. -When reviewing or benchmarking helloSystem, it is important to note that virtual machines may not provide an accurate representation of the system's stability, feature set, and performance. Therefore, we recommend that reviewers use real hardware for these purposes. Running helloSystem on actual hardware will provide a more authentic experience and allow reviewers to test the system's capabilities in a more realistic environment. Additionally, using real hardware will help to ensure that the system's hardware support is properly evaluated. For these reasons, we strongly advise against conducting tests and benchmarks in a virtual environment, even though VirtualBox guest drivers are preinstalled. +When reviewing or benchmarking helloSystem, it is important to note that virtual machines may not provide an accurate representation of the system's stability, feature set, and performance. Therefore, **we recommend that reviewers use real hardware** for these purposes. Running helloSystem on actual hardware will provide a more authentic experience and allow reviewers to test the system's capabilities in a more realistic environment. Additionally, using real hardware will help to ensure that the system's hardware support is properly evaluated. For these reasons, we strongly advise against conducting tests and benchmarks in a virtual environment, even though VirtualBox guest drivers are preinstalled. ## Installation @@ -57,24 +59,24 @@ The helloSystem user interface is designed to be intuitive, functional, and disc - **Source code editability** for many Utilities: Many of the utilities included with helloSystem have their source code included and do not need to be compiled, making it easy for users to customize and contribute to the system. Right-click on an application icon and choose "Show Contents" to see and edit the source code. -- **Under Construction**: The "Under Construction" section of the menu provides access to various utilities and tools that are currently in development, and are looking for contributors to help bring them to completion. +## Features -- **Create Live Media** utility: helloSystem includes a tool for creating live media, which can be used to create a bootable USB or DVD to try helloSystem without installing it on your system. It can also burn the latest, frequently released, experimental ISO builds directly to USB sticks. +- **Resource efficiency**: helloSystem is designed to be lightweight and efficient, with moderate resource usage, making it suitable for use on a range of hardware configurations. Compare the RAM usage to other similar systems. -## Features -- Detailed list of features in helloSystem -- Purpose and functionality of each feature -- Examples of how to use each feature +- **Graphics and media support**: helloSystem includes a range of appliactions and features designed to support graphics artists, designers, videographers, makers with 3D printers, and other creative professionals, without requiring them to think much about the operating system. + +- **Under Construction**: The "Under Construction" section of the menu provides access to various utilities and tools that are currently in development, and are looking for contributors to help bring them to completion. helloSystem does not hide its open source nature, and invites power users to join the development fun. -## Performance -- Details of helloSystem's performance -- Benchmarks or tests conducted -- Comparisons to other similar operating systems +- **Create Live Media** utility: helloSystem includes a tool for creating live media, which can be used to create a bootable USB or DVD to try helloSystem without installing it on your system. It can also burn the latest, frequently released, experimental ISO builds directly to USB sticks. ## Support -- Explanation of support options available for helloSystem -- Contact information for support (e.g., email or forums) -## Conclusion -- Summary of key points in the reviewer's guide -- Overall impression of helloSystem +helloSystem is a community-driven project. If you encounter any issues or have questions about helloSystem, there are several resources available to help you get support and connect with the community: + +- Official website: The helloSystem website (https://hellosystem.github.io/) provides a range of resources and information about the operating system, including documentation for users and for developers. + +- Issue tracker: If you encounter a bug or have an issue with helloSystem, please submit a report to the issue tracker (https://github.com/helloSystem/ISO/issues) on the project's GitHub page. This is a great way to get help and connect with the development team and the broader helloSystem community. + +- Discussions: The helloSystem forum (https://github.com/helloSystem/hello/discussions/) provides a platform for users to connect with each other and discuss topics related to helloSystem, including troubleshooting, brainstorming, and development. + +- IRC channel: For more immediate assistance, you can join the helloSystem IRC channel (`#hellosystem`) on the [Libera.Chat](https://libera.chat/) network. This is a great way to connect with other users and developers in real time. From a21195558fac6ed243def649b33aa6b234678665 Mon Sep 17 00:00:00 2001 From: probonopd Date: Wed, 22 Feb 2023 23:31:58 +0100 Subject: [PATCH 542/592] Update guide.md --- reviewer/guide.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/reviewer/guide.md b/reviewer/guide.md index 7c6c444c..b500baf6 100644 --- a/reviewer/guide.md +++ b/reviewer/guide.md @@ -73,10 +73,10 @@ The helloSystem user interface is designed to be intuitive, functional, and disc helloSystem is a community-driven project. If you encounter any issues or have questions about helloSystem, there are several resources available to help you get support and connect with the community: -- Official website: The helloSystem website (https://hellosystem.github.io/) provides a range of resources and information about the operating system, including documentation for users and for developers. +- **Official website**: The helloSystem website (https://hellosystem.github.io/) provides a range of resources and information about the operating system, including documentation for users and for developers. -- Issue tracker: If you encounter a bug or have an issue with helloSystem, please submit a report to the issue tracker (https://github.com/helloSystem/ISO/issues) on the project's GitHub page. This is a great way to get help and connect with the development team and the broader helloSystem community. +- **Issue tracker**: If you encounter a bug or have an issue with helloSystem, please submit a report to the issue tracker (https://github.com/helloSystem/ISO/issues) on the project's GitHub page. This is a great way to get help and connect with the development team and the broader helloSystem community. -- Discussions: The helloSystem forum (https://github.com/helloSystem/hello/discussions/) provides a platform for users to connect with each other and discuss topics related to helloSystem, including troubleshooting, brainstorming, and development. +- **Discussions**: The helloSystem forum (https://github.com/helloSystem/hello/discussions/) provides a platform for users to connect with each other and discuss topics related to helloSystem, including troubleshooting, brainstorming, and development. -- IRC channel: For more immediate assistance, you can join the helloSystem IRC channel (`#hellosystem`) on the [Libera.Chat](https://libera.chat/) network. This is a great way to connect with other users and developers in real time. +- **IRC channel**: For more immediate assistance, you can join the helloSystem IRC channel (`#hellosystem`) on the [Libera.Chat](https://libera.chat/) network. This is a great way to connect with other users and developers in real time. Please stay in the channel for several days, as many contributors cannot be there 24/7. From 72ffa7fed3cc63d3b883d9aaa594a71ef51cb758 Mon Sep 17 00:00:00 2001 From: probonopd Date: Wed, 22 Feb 2023 23:32:20 +0100 Subject: [PATCH 543/592] Update guide.md --- reviewer/guide.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/reviewer/guide.md b/reviewer/guide.md index b500baf6..7a472783 100644 --- a/reviewer/guide.md +++ b/reviewer/guide.md @@ -1,4 +1,4 @@ -# Reviewer's Guide +# Reviewer Guide ## Introduction HelloSystem is an open-source operating system based on FreeBSD. Its goal is to provide a stable, user-friendly, and visually appealing system for desktop and laptop computers. The system is designed to be easy to use, highly customizable, and efficient, with an emphasis on minimalism and simplicity. From 4b47c2b034a6633ecdacc7da39b170b96a0ed505 Mon Sep 17 00:00:00 2001 From: probonopd Date: Wed, 22 Feb 2023 23:32:37 +0100 Subject: [PATCH 544/592] Update index.md --- index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.md b/index.md index bd928249..00179fbf 100644 --- a/index.md +++ b/index.md @@ -68,7 +68,7 @@ developer/contact ```{toctree} --- -caption: Reviewer's Guide +caption: Reviewer Guide hidden: true maxdepth: 2 glob: true From 57203fecd3de44e2b58d5f82a201d25431a28173 Mon Sep 17 00:00:00 2001 From: probonopd Date: Wed, 22 Feb 2023 23:44:07 +0100 Subject: [PATCH 545/592] Update guide.md --- reviewer/guide.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/reviewer/guide.md b/reviewer/guide.md index 7a472783..22790789 100644 --- a/reviewer/guide.md +++ b/reviewer/guide.md @@ -1,11 +1,12 @@ # Reviewer Guide ## Introduction -HelloSystem is an open-source operating system based on FreeBSD. Its goal is to provide a stable, user-friendly, and visually appealing system for desktop and laptop computers. The system is designed to be easy to use, highly customizable, and efficient, with an emphasis on minimalism and simplicity. -The purpose of this reviewer's guide is to provide an overview of helloSystem, as well as to offer guidance on how to use the system's features and capabilities. The guide includes information on system requirements, installation, user interface, features, performance, support options, and more. +helloSystem is an open-source operating system based on FreeBSD. Its goal is to provide a friendly, highly usable, and visually appealing system for desktop and notebook computers. The system is designed to be easy to use, efficient, with an emphasis on minimalism and simplicity. -Whether you are a new user looking to explore helloSystem for the first time, or an experienced user seeking to learn more about its features and capabilities, this guide should provide you with a comprehensive understanding of the system and its functionality. +Its target audience are switchers from the Mac platform who like the overall usablity concepts dating back to groundbreaking work done at Xerox PARC and at Apple in the 70s and 80s, but who may increasingly be alienated by the restrictions and complications put in place in modern-day commercial operating systems. + +The purpose of this reviewer's guide is to provide an overview of helloSystem, as well as to offer guidance on how to use the system's features and capabilities. The guide includes information on system requirements, installation, user interface, features, performance, support options, and more. When reviewing helloSystem, try to look at it from a perspective of long-time Mac users, particularly those who are doing creative work like graphics, design, video editing, or 3D modeling and printing. This guide should provide you with a comprehensive understanding of the system and its functionality and should give you a starting point for your own exploration. ## System Requirements From 3a411928c5dc65c5ae337ed4b3de6cea62a91326 Mon Sep 17 00:00:00 2001 From: probonopd Date: Wed, 22 Feb 2023 23:57:18 +0100 Subject: [PATCH 546/592] Update guide.md --- reviewer/guide.md | 18 ++++++++++++++++-- 1 file changed, 16 insertions(+), 2 deletions(-) diff --git a/reviewer/guide.md b/reviewer/guide.md index 22790789..2dd7731a 100644 --- a/reviewer/guide.md +++ b/reviewer/guide.md @@ -4,9 +4,9 @@ helloSystem is an open-source operating system based on FreeBSD. Its goal is to provide a friendly, highly usable, and visually appealing system for desktop and notebook computers. The system is designed to be easy to use, efficient, with an emphasis on minimalism and simplicity. -Its target audience are switchers from the Mac platform who like the overall usablity concepts dating back to groundbreaking work done at Xerox PARC and at Apple in the 70s and 80s, but who may increasingly be alienated by the restrictions and complications put in place in modern-day commercial operating systems. +Its target audience are switchers from the Mac platform, to which it aims to provide an environment in which they can feel instantly at home. -The purpose of this reviewer's guide is to provide an overview of helloSystem, as well as to offer guidance on how to use the system's features and capabilities. The guide includes information on system requirements, installation, user interface, features, performance, support options, and more. When reviewing helloSystem, try to look at it from a perspective of long-time Mac users, particularly those who are doing creative work like graphics, design, video editing, or 3D modeling and printing. This guide should provide you with a comprehensive understanding of the system and its functionality and should give you a starting point for your own exploration. +The purpose of this reviewer's guide is to provide an overview of helloSystem, as well as to offer guidance on how to use the system's features and capabilities. The guide includes information on system requirements, installation, user interface, features, performance, support options, and more. When reviewing helloSystem, try to look at it from a perspective of long-time Mac users, particularly those who are doing creative work like graphics, design, video editing, or 3D modeling and printing but would like to do so using open source applications. This guide should provide you with a comprehensive understanding of the system and its functionality and should give you a starting point for your own exploration. ## System Requirements @@ -70,6 +70,20 @@ The helloSystem user interface is designed to be intuitive, functional, and disc - **Create Live Media** utility: helloSystem includes a tool for creating live media, which can be used to create a bootable USB or DVD to try helloSystem without installing it on your system. It can also burn the latest, frequently released, experimental ISO builds directly to USB sticks. +## Particularities + +* Please refer to the global menu bar at the top of the screen in helloSystem as the "Menu", as those who have grown up using a Macintosh will likely feel right at home with this naming convention. Avoid terminology like "panel", as the target audience of helloSystem may not be familiar with it. Similarly, please refer to the "desktop", "documents", and "folders" rather than the "wallpaper", "files", and "directories". + +* The file manager in helloSystem, Filer, is intentionally kept simple and is aspiring to grow into a truly [spatial](https://arstechnica.com/gadgets/2003/04/finder/) file manager over time. Which means that every document and folder has one physical location on the screen, and one location only. When opening an empty folder, it will show a blank window. This is because there is nothing to display in an empty folder, much like how a text editor shows a blank window when opening a new text file. + +* helloSystem uses black text on white background. With the intoduction of modern graphical user interfaces, black text on white background (like paper, "WYSIWYG") was a revelation compared to the amber or green screens of MS-DOS PCs. + +* In helloSystem, there is no concept of "launchers." Instead, it uses symlinks to applications, which can be created by dragging and dropping an application from its folder to the desktop. Keep in mind that helloSystem aims to keep things simple and straightforward for switchers from the Mac, who don't have conceptions of "launchers". + +* The Dock is not used by default in helloSystem, although it is still available in `/System` for those who really need it. While the Dock was a later addition to the Mac OS X experience, helloSystem allows users to switch between applications like on Classic systems, saving precious screen real estate at the bottom of the screen. + +* In helloSystem, there is no unified control panel. Instead, there are individual preferences applications located in `/Applications/Preferences`. This is simpler and more similar to the control panels found in System 7. + ## Support helloSystem is a community-driven project. If you encounter any issues or have questions about helloSystem, there are several resources available to help you get support and connect with the community: From f388fe2a539ae6e3bad106a3805ad1bcb5cf5c75 Mon Sep 17 00:00:00 2001 From: probonopd Date: Thu, 23 Feb 2023 00:03:33 +0100 Subject: [PATCH 547/592] Update guide.md --- reviewer/guide.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/reviewer/guide.md b/reviewer/guide.md index 2dd7731a..06912e3c 100644 --- a/reviewer/guide.md +++ b/reviewer/guide.md @@ -6,7 +6,7 @@ helloSystem is an open-source operating system based on FreeBSD. Its goal is to Its target audience are switchers from the Mac platform, to which it aims to provide an environment in which they can feel instantly at home. -The purpose of this reviewer's guide is to provide an overview of helloSystem, as well as to offer guidance on how to use the system's features and capabilities. The guide includes information on system requirements, installation, user interface, features, performance, support options, and more. When reviewing helloSystem, try to look at it from a perspective of long-time Mac users, particularly those who are doing creative work like graphics, design, video editing, or 3D modeling and printing but would like to do so using open source applications. This guide should provide you with a comprehensive understanding of the system and its functionality and should give you a starting point for your own exploration. +The purpose of this guide is to provide an overview of helloSystem, as well as to offer guidance on how to use the system's features and capabilities. The guide includes information on system requirements, installation, user interface, features, performance, support options, and more. When reviewing helloSystem, try to look at it from a perspective of long-time Mac users, particularly those who are doing creative work like graphics, design, video editing, or 3D modeling and printing but who would like to do so using open source applications. This guide should provide you with a thorough understanding of the system and its functionality and should give you a starting point for your own exploration. ## System Requirements From c69e6a4883357abfab5c2597ea2b58e947b3720c Mon Sep 17 00:00:00 2001 From: probonopd Date: Thu, 23 Feb 2023 00:06:36 +0100 Subject: [PATCH 548/592] Update index.md --- index.md | 21 ++++++++++----------- 1 file changed, 10 insertions(+), 11 deletions(-) diff --git a/index.md b/index.md index 00179fbf..8713ebcc 100644 --- a/index.md +++ b/index.md @@ -26,7 +26,17 @@ user/getting-started user/components user/troubleshooting user/feedback +``` +```{toctree} +--- +caption: Reviewer Guide +hidden: true +maxdepth: 2 +glob: true +--- + +reviewer/guide ``` ```{toctree} @@ -65,14 +75,3 @@ developer/acknowledgements developer/contact ``` - -```{toctree} ---- -caption: Reviewer Guide -hidden: true -maxdepth: 2 -glob: true ---- - -reviewer/guide -``` From 0b2c0680680880ff7b268040daafb99c5a88ddb7 Mon Sep 17 00:00:00 2001 From: probonopd Date: Thu, 23 Feb 2023 01:00:59 +0100 Subject: [PATCH 549/592] Update guide.md --- reviewer/guide.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/reviewer/guide.md b/reviewer/guide.md index 06912e3c..c461c01d 100644 --- a/reviewer/guide.md +++ b/reviewer/guide.md @@ -68,6 +68,8 @@ The helloSystem user interface is designed to be intuitive, functional, and disc - **Under Construction**: The "Under Construction" section of the menu provides access to various utilities and tools that are currently in development, and are looking for contributors to help bring them to completion. helloSystem does not hide its open source nature, and invites power users to join the development fun. +- **Zeroconf (mDNS-SD)** is used throughout the system to advertise and browse network resources, like servers, printers, and the like. + - **Create Live Media** utility: helloSystem includes a tool for creating live media, which can be used to create a bootable USB or DVD to try helloSystem without installing it on your system. It can also burn the latest, frequently released, experimental ISO builds directly to USB sticks. ## Particularities From 832ae08a801d9714472a974b907e9f2b32ed24b5 Mon Sep 17 00:00:00 2001 From: probonopd Date: Thu, 23 Feb 2023 01:01:50 +0100 Subject: [PATCH 550/592] Update guide.md --- reviewer/guide.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/reviewer/guide.md b/reviewer/guide.md index c461c01d..3b4778dc 100644 --- a/reviewer/guide.md +++ b/reviewer/guide.md @@ -68,7 +68,7 @@ The helloSystem user interface is designed to be intuitive, functional, and disc - **Under Construction**: The "Under Construction" section of the menu provides access to various utilities and tools that are currently in development, and are looking for contributors to help bring them to completion. helloSystem does not hide its open source nature, and invites power users to join the development fun. -- **Zeroconf (mDNS-SD)** is used throughout the system to advertise and browse network resources, like servers, printers, and the like. +- **Zeroconf (mDNS-SD)**: helloSystem makes use of this technology throughout the system to advertise and browse network resources, like servers, printers, and the like. - **Create Live Media** utility: helloSystem includes a tool for creating live media, which can be used to create a bootable USB or DVD to try helloSystem without installing it on your system. It can also burn the latest, frequently released, experimental ISO builds directly to USB sticks. From 72808bcdc7ba13335fd1cfee3f3a4e40b3c0f2a4 Mon Sep 17 00:00:00 2001 From: probonopd Date: Fri, 24 Feb 2023 21:33:28 +0100 Subject: [PATCH 551/592] Modifying bootloader scripts --- developer/boot.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/developer/boot.md b/developer/boot.md index 9275016a..428b1d26 100644 --- a/developer/boot.md +++ b/developer/boot.md @@ -253,3 +253,17 @@ Please note that if any errors are displayed on the screen during the boot proce ::: To see boot messages, set `boot_mute="NO"` in {file}`/boot/loader.conf` or at the bootloader prompt. + + +## Modifying bootloader scripts + +The bootloader executes lua scripts as part of the boot process. This is not documented extensively in the FreeBSD documentation. + +The `/boot` directory also contains files referring to 4th, those are all unused, misleading, and can be removed. + +To work on the lua scripts, it is useful to +* Use VirtualBox +* Install helloSystem to a virtual hard disk +* In the installed system, edit `/boot/loader.conf` to contain `beastie_disable=NO` and increase the timeout + +One can then edit the scripts in `/boot/lua`, and boot the virtual machine quickly into single user mode, make edits, and repeat. From 515a51cd874c4852e5e8c861a064b02fffd995b3 Mon Sep 17 00:00:00 2001 From: probonopd Date: Fri, 24 Feb 2023 21:48:06 +0100 Subject: [PATCH 552/592] Update boot.md --- developer/boot.md | 17 +++++++++++++++-- 1 file changed, 15 insertions(+), 2 deletions(-) diff --git a/developer/boot.md b/developer/boot.md index 428b1d26..080af3a1 100644 --- a/developer/boot.md +++ b/developer/boot.md @@ -259,11 +259,24 @@ To see boot messages, set `boot_mute="NO"` in {file}`/boot/loader.conf` or at th The bootloader executes lua scripts as part of the boot process. This is not documented extensively in the FreeBSD documentation. -The `/boot` directory also contains files referring to 4th, those are all unused, misleading, and can be removed. - To work on the lua scripts, it is useful to * Use VirtualBox * Install helloSystem to a virtual hard disk * In the installed system, edit `/boot/loader.conf` to contain `beastie_disable=NO` and increase the timeout +The `/boot` directory also contains files referring to 4th, those are all unused, misleading, and can be removed. Besides files with `4th` in their name this also includes files ending in `.rc`. + +``` +mount -uw / +cd /boot +find . -name '*4th*' -exec rm {} \; +rm *.rc +``` + +Removing the misleading files makes it easier to see which code actually gets executed. All the scripting is essentially happening in `/boot/lua`. + One can then edit the scripts in `/boot/lua`, and boot the virtual machine quickly into single user mode, make edits, and repeat. + +It seems that `/boot/lua/loader.lua` is the entry point that is hardcoded into the bootloader. + +So if we would like to run a "hello world", we would need to place it at that path. From a3871c7c83c7979763ab1829495e9066a19d6371 Mon Sep 17 00:00:00 2001 From: probonopd Date: Fri, 24 Feb 2023 21:55:51 +0100 Subject: [PATCH 553/592] Update boot.md --- developer/boot.md | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+) diff --git a/developer/boot.md b/developer/boot.md index 080af3a1..c1dcc6a7 100644 --- a/developer/boot.md +++ b/developer/boot.md @@ -280,3 +280,28 @@ One can then edit the scripts in `/boot/lua`, and boot the virtual machine quick It seems that `/boot/lua/loader.lua` is the entry point that is hardcoded into the bootloader. So if we would like to run a "hello world", we would need to place it at that path. + +`/boot/lua/loader.lua` includes other lua files, e.g., `local core = require("core")`. + +`/boot/lua/core.lua` contains the following function: + +``` +function core.isMenuSkipped() + return string.lower(loader.getenv("beastie_disable") or "") == "yes" +end +``` + +`/boot/lua/loader.lua` uses this function to display the boot menu if `beastie_disable` is not set: + +``` +if not core.isMenuSkipped() then + require("menu").run() +else + -- Load kernel/modules before we go + config.loadelf() +end +``` + +Perhaps we can +* Change the `if` condition to a key being pressed, so that the boot menu is not shown if the defined key is not being pressed +* Set the font color to black, so that the loading of the kernel and modules is done without any visible text on the screen From fd59cf61b1a8d159489c59853ca24776e81a7487 Mon Sep 17 00:00:00 2001 From: probonopd Date: Fri, 24 Feb 2023 22:00:12 +0100 Subject: [PATCH 554/592] Update boot.md --- developer/boot.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/developer/boot.md b/developer/boot.md index c1dcc6a7..b6924ccc 100644 --- a/developer/boot.md +++ b/developer/boot.md @@ -302,6 +302,14 @@ else end ``` +Directly above this, there is + +``` +try_include("local") +``` + +which seems to suggest that we can hook in our own code there by creating a new file `/boot/lua/local.lua` with our custom code. + Perhaps we can * Change the `if` condition to a key being pressed, so that the boot menu is not shown if the defined key is not being pressed * Set the font color to black, so that the loading of the kernel and modules is done without any visible text on the screen From df0ba04471872e1f90f4e20309fd150f6c41d408 Mon Sep 17 00:00:00 2001 From: probonopd Date: Fri, 24 Feb 2023 22:05:51 +0100 Subject: [PATCH 555/592] Update boot.md --- developer/boot.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/developer/boot.md b/developer/boot.md index b6924ccc..db7ade02 100644 --- a/developer/boot.md +++ b/developer/boot.md @@ -312,4 +312,6 @@ which seems to suggest that we can hook in our own code there by creating a new Perhaps we can * Change the `if` condition to a key being pressed, so that the boot menu is not shown if the defined key is not being pressed -* Set the font color to black, so that the loading of the kernel and modules is done without any visible text on the screen +* Ideally, we can, e.g., boot into single user mode if the user holds down "s" during boot, or verbose mode if the user holds down "v". `/boot/lua/core.lua` contains convenient functions for setting variables like `boot_verbose` and `boot_single`. +* Unset our dark grey on light grey color scheme if verbose or single user boot is requested +* Set the font color of the bootloader to black, so that the loading of the kernel and modules is done without any visible text on the screen; unless verbose boot is requested From b69216aa745df65ce5b69e776ada667109531572 Mon Sep 17 00:00:00 2001 From: probonopd Date: Fri, 24 Feb 2023 22:07:11 +0100 Subject: [PATCH 556/592] Update boot.md --- developer/boot.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/developer/boot.md b/developer/boot.md index db7ade02..001307d5 100644 --- a/developer/boot.md +++ b/developer/boot.md @@ -264,6 +264,8 @@ To work on the lua scripts, it is useful to * Install helloSystem to a virtual hard disk * In the installed system, edit `/boot/loader.conf` to contain `beastie_disable=NO` and increase the timeout +Possibly there is also a way to use a lua interpreter on the booted system to work on and debug the lua scripts, but this is currently unknown. + The `/boot` directory also contains files referring to 4th, those are all unused, misleading, and can be removed. Besides files with `4th` in their name this also includes files ending in `.rc`. ``` From b073b382b92be032bb377f837cfd5d3bc63c44a1 Mon Sep 17 00:00:00 2001 From: probonopd Date: Fri, 24 Feb 2023 22:08:55 +0100 Subject: [PATCH 557/592] Update boot.md --- developer/boot.md | 16 +++++++++++++++- 1 file changed, 15 insertions(+), 1 deletion(-) diff --git a/developer/boot.md b/developer/boot.md index 001307d5..5c8ac3f3 100644 --- a/developer/boot.md +++ b/developer/boot.md @@ -264,7 +264,21 @@ To work on the lua scripts, it is useful to * Install helloSystem to a virtual hard disk * In the installed system, edit `/boot/loader.conf` to contain `beastie_disable=NO` and increase the timeout -Possibly there is also a way to use a lua interpreter on the booted system to work on and debug the lua scripts, but this is currently unknown. +Possibly there is also a way to use a lua interpreter on the booted system to work on and debug the lua scripts, but this is currently unknown. The following does not seem to work: + +``` +% lua54 ./loader.lua +lua54: ./core.lua:447: attempt to index a nil value (global 'loader') +stack traceback: + ./core.lua:447: in field 'isSystem386' + ./core.lua:56: in local 'recordDefaults' + ./core.lua:525: in main chunk + [C]: in function 'require' + ./cli.lua:31: in main chunk + [C]: in function 'require' + ./loader.lua:36: in main chunk + [C]: in ? +``` The `/boot` directory also contains files referring to 4th, those are all unused, misleading, and can be removed. Besides files with `4th` in their name this also includes files ending in `.rc`. From 34f935c4d2f3c7e5711d0b65ee59aabdac0c78d0 Mon Sep 17 00:00:00 2001 From: probonopd Date: Fri, 24 Feb 2023 22:27:07 +0100 Subject: [PATCH 558/592] Update boot.md --- developer/boot.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/developer/boot.md b/developer/boot.md index 5c8ac3f3..4685f139 100644 --- a/developer/boot.md +++ b/developer/boot.md @@ -326,6 +326,9 @@ try_include("local") which seems to suggest that we can hook in our own code there by creating a new file `/boot/lua/local.lua` with our custom code. +* https://man.freebsd.org/cgi/man.cgi?query=core.lua documents the functions in `core.lua` +* https://man.freebsd.org/cgi/man.cgi?query=menu.lua&sektion=8 documents `menu.lua`, including an example for how to replace the default boot menu with a simple boot menu, and en example for how to add another option to the default FreeBSD welcome menu + Perhaps we can * Change the `if` condition to a key being pressed, so that the boot menu is not shown if the defined key is not being pressed * Ideally, we can, e.g., boot into single user mode if the user holds down "s" during boot, or verbose mode if the user holds down "v". `/boot/lua/core.lua` contains convenient functions for setting variables like `boot_verbose` and `boot_single`. From c8e9192223442768158b1350b431468e654d1016 Mon Sep 17 00:00:00 2001 From: probonopd Date: Fri, 24 Feb 2023 22:31:04 +0100 Subject: [PATCH 559/592] Update boot.md --- developer/boot.md | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) diff --git a/developer/boot.md b/developer/boot.md index 4685f139..e27c468b 100644 --- a/developer/boot.md +++ b/developer/boot.md @@ -324,7 +324,17 @@ Directly above this, there is try_include("local") ``` -which seems to suggest that we can hook in our own code there by creating a new file `/boot/lua/local.lua` with our custom code. +which seems to suggest that we can hook in our own code there by creating a new file `/boot/lua/local.lua` with our custom code: + +``` +local color = require("color") + +-- loader.* functions are not part of normal lua, where are they documented? + +printc("Hello World", COLOR_BLUE) + +loader.delay(5*1000*1000) +``` * https://man.freebsd.org/cgi/man.cgi?query=core.lua documents the functions in `core.lua` * https://man.freebsd.org/cgi/man.cgi?query=menu.lua&sektion=8 documents `menu.lua`, including an example for how to replace the default boot menu with a simple boot menu, and en example for how to add another option to the default FreeBSD welcome menu From cce39f09bde4032159800cee8b25b2d2ca599265 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 25 Feb 2023 01:43:15 +0100 Subject: [PATCH 560/592] Update boot.md --- developer/boot.md | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/developer/boot.md b/developer/boot.md index e27c468b..363585c9 100644 --- a/developer/boot.md +++ b/developer/boot.md @@ -339,8 +339,9 @@ loader.delay(5*1000*1000) * https://man.freebsd.org/cgi/man.cgi?query=core.lua documents the functions in `core.lua` * https://man.freebsd.org/cgi/man.cgi?query=menu.lua&sektion=8 documents `menu.lua`, including an example for how to replace the default boot menu with a simple boot menu, and en example for how to add another option to the default FreeBSD welcome menu -Perhaps we can -* Change the `if` condition to a key being pressed, so that the boot menu is not shown if the defined key is not being pressed -* Ideally, we can, e.g., boot into single user mode if the user holds down "s" during boot, or verbose mode if the user holds down "v". `/boot/lua/core.lua` contains convenient functions for setting variables like `boot_verbose` and `boot_single`. -* Unset our dark grey on light grey color scheme if verbose or single user boot is requested -* Set the font color of the bootloader to black, so that the loading of the kernel and modules is done without any visible text on the screen; unless verbose boot is requested +This allows us to +* Load the kernel and modules without showing text on screen +* Boot in verbose mode if the `V` key is pressed +* Boot in single user mode if the `S` key is pressed +* Show the FreeBSD bootloader menu if backspace is pressed +* Adjust colors for verbose and single user boot From 16e57641ca76117d2ce50c06a4436d9e609665b8 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 25 Feb 2023 13:17:13 +0100 Subject: [PATCH 561/592] Update boot.md --- developer/boot.md | 32 ++++++++++++++++++++++++++++++++ 1 file changed, 32 insertions(+) diff --git a/developer/boot.md b/developer/boot.md index 363585c9..c28075c5 100644 --- a/developer/boot.md +++ b/developer/boot.md @@ -345,3 +345,35 @@ This allows us to * Boot in single user mode if the `S` key is pressed * Show the FreeBSD bootloader menu if backspace is pressed * Adjust colors for verbose and single user boot + +The lua environment in the FreeBSD bootloader has some functions starting with `loader.` that seem to be undocumented, but we can list them by looking at the source code: + +* `loader.command()` +* `loader.perform()` +* `loader.command_error()` +* `loader.interpret()` +* `loader.parse()` +* `loader.getchar()` +* `loader.ischar()` +* `loader.gets()` +* `loader.time()` +* `loader.delay()` +* `loader.getenv()` +* `loader.setenv()` +* `loader.unsetenv()` +* `loader.printc()` +* `loader.openfile()` +* `loader.closefile()` +* `loader.readfile()` +* `loader.writefile()` +* `loader.term_putimage()` +* `loader.fb_putimage()` +* `loader.fb_setpixel()` +* `loader.fb_line()` +* `loader.fb_bezier()` +* `loader.fb_drawrect()` +* `loader.term_drawrect()` + +This list was generated with + +`grep -r '^lua_' /usr/src/stand/liblua/*.c | cut -d ":" -f 2 | sed -e 's|lua_|loader.|g' | sed -e 's|loader.State \*L||g' | sed -e 's|^|* \`|g' | sed -e 's|)|)\`|g'`. From 0be2a4f6976a6dd0fc3a6accc7802fded79249ca Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 25 Feb 2023 13:18:14 +0100 Subject: [PATCH 562/592] Update boot.md --- developer/boot.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/developer/boot.md b/developer/boot.md index c28075c5..5a751332 100644 --- a/developer/boot.md +++ b/developer/boot.md @@ -374,6 +374,8 @@ The lua environment in the FreeBSD bootloader has some functions starting with ` * `loader.fb_drawrect()` * `loader.term_drawrect()` -This list was generated with +This list was generated on a system on which the FreeBSD source code is installed in `/usr/src` using the following command: -`grep -r '^lua_' /usr/src/stand/liblua/*.c | cut -d ":" -f 2 | sed -e 's|lua_|loader.|g' | sed -e 's|loader.State \*L||g' | sed -e 's|^|* \`|g' | sed -e 's|)|)\`|g'`. +``` +grep -r '^lua_' /usr/src/stand/liblua/*.c | cut -d ":" -f 2 | sed -e 's|lua_|loader.|g' | sed -e 's|loader.State \*L||g' | sed -e 's|^|* \`|g' | sed -e 's|)|)\`|g' +``` From 3f552bf58f30825bb0ebe0eb78db08f58270fe94 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 25 Feb 2023 13:19:53 +0100 Subject: [PATCH 563/592] Update boot.md --- developer/boot.md | 40 ++++++++++++++++++++-------------------- 1 file changed, 20 insertions(+), 20 deletions(-) diff --git a/developer/boot.md b/developer/boot.md index 5a751332..e2a9cfc9 100644 --- a/developer/boot.md +++ b/developer/boot.md @@ -348,34 +348,34 @@ This allows us to The lua environment in the FreeBSD bootloader has some functions starting with `loader.` that seem to be undocumented, but we can list them by looking at the source code: -* `loader.command()` -* `loader.perform()` +* `loader.closefile()` * `loader.command_error()` -* `loader.interpret()` -* `loader.parse()` -* `loader.getchar()` -* `loader.ischar()` -* `loader.gets()` -* `loader.time()` +* `loader.command()` * `loader.delay()` +* `loader.fb_bezier()` +* `loader.fb_drawrect()` +* `loader.fb_line()` +* `loader.fb_putimage()` +* `loader.fb_setpixel()` +* `loader.getchar()` * `loader.getenv()` -* `loader.setenv()` -* `loader.unsetenv()` -* `loader.printc()` +* `loader.gets()` +* `loader.interpret()` +* `loader.ischar()` * `loader.openfile()` -* `loader.closefile()` +* `loader.parse()` +* `loader.perform()` +* `loader.printc()` * `loader.readfile()` -* `loader.writefile()` -* `loader.term_putimage()` -* `loader.fb_putimage()` -* `loader.fb_setpixel()` -* `loader.fb_line()` -* `loader.fb_bezier()` -* `loader.fb_drawrect()` +* `loader.setenv()` * `loader.term_drawrect()` +* `loader.term_putimage()` +* `loader.time()` +* `loader.unsetenv()` +* `loader.writefile()` This list was generated on a system on which the FreeBSD source code is installed in `/usr/src` using the following command: ``` -grep -r '^lua_' /usr/src/stand/liblua/*.c | cut -d ":" -f 2 | sed -e 's|lua_|loader.|g' | sed -e 's|loader.State \*L||g' | sed -e 's|^|* \`|g' | sed -e 's|)|)\`|g' +grep -r '^lua_' /usr/src/stand/liblua/*.c | cut -d ":" -f 2 | sed -e 's|lua_|loader.|g' | sed -e 's|loader.State \*L||g' | sed -e 's|^|* \`|g' | sed -e 's|)|)\`|g' | sort ``` From 7b73105afc024eaef29362be4de8b4cadb474311 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 25 Feb 2023 13:21:14 +0100 Subject: [PATCH 564/592] Update boot.md --- developer/boot.md | 40 ++++++++++++++++++++-------------------- 1 file changed, 20 insertions(+), 20 deletions(-) diff --git a/developer/boot.md b/developer/boot.md index e2a9cfc9..5a751332 100644 --- a/developer/boot.md +++ b/developer/boot.md @@ -348,34 +348,34 @@ This allows us to The lua environment in the FreeBSD bootloader has some functions starting with `loader.` that seem to be undocumented, but we can list them by looking at the source code: -* `loader.closefile()` -* `loader.command_error()` * `loader.command()` -* `loader.delay()` -* `loader.fb_bezier()` -* `loader.fb_drawrect()` -* `loader.fb_line()` -* `loader.fb_putimage()` -* `loader.fb_setpixel()` -* `loader.getchar()` -* `loader.getenv()` -* `loader.gets()` +* `loader.perform()` +* `loader.command_error()` * `loader.interpret()` -* `loader.ischar()` -* `loader.openfile()` * `loader.parse()` -* `loader.perform()` -* `loader.printc()` -* `loader.readfile()` -* `loader.setenv()` -* `loader.term_drawrect()` -* `loader.term_putimage()` +* `loader.getchar()` +* `loader.ischar()` +* `loader.gets()` * `loader.time()` +* `loader.delay()` +* `loader.getenv()` +* `loader.setenv()` * `loader.unsetenv()` +* `loader.printc()` +* `loader.openfile()` +* `loader.closefile()` +* `loader.readfile()` * `loader.writefile()` +* `loader.term_putimage()` +* `loader.fb_putimage()` +* `loader.fb_setpixel()` +* `loader.fb_line()` +* `loader.fb_bezier()` +* `loader.fb_drawrect()` +* `loader.term_drawrect()` This list was generated on a system on which the FreeBSD source code is installed in `/usr/src` using the following command: ``` -grep -r '^lua_' /usr/src/stand/liblua/*.c | cut -d ":" -f 2 | sed -e 's|lua_|loader.|g' | sed -e 's|loader.State \*L||g' | sed -e 's|^|* \`|g' | sed -e 's|)|)\`|g' | sort +grep -r '^lua_' /usr/src/stand/liblua/*.c | cut -d ":" -f 2 | sed -e 's|lua_|loader.|g' | sed -e 's|loader.State \*L||g' | sed -e 's|^|* \`|g' | sed -e 's|)|)\`|g' ``` From f0b47911b892bc38bf409af664557f7a6c2340c0 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 25 Feb 2023 13:22:11 +0100 Subject: [PATCH 565/592] Update boot.md --- developer/boot.md | 10 +--------- 1 file changed, 1 insertion(+), 9 deletions(-) diff --git a/developer/boot.md b/developer/boot.md index 5a751332..9086703d 100644 --- a/developer/boot.md +++ b/developer/boot.md @@ -326,15 +326,7 @@ try_include("local") which seems to suggest that we can hook in our own code there by creating a new file `/boot/lua/local.lua` with our custom code: -``` -local color = require("color") - --- loader.* functions are not part of normal lua, where are they documented? - -printc("Hello World", COLOR_BLUE) - -loader.delay(5*1000*1000) -``` +https://github.com/helloSystem/ISO/blob/experimental/overlays/boot/boot/lua/local.lua * https://man.freebsd.org/cgi/man.cgi?query=core.lua documents the functions in `core.lua` * https://man.freebsd.org/cgi/man.cgi?query=menu.lua&sektion=8 documents `menu.lua`, including an example for how to replace the default boot menu with a simple boot menu, and en example for how to add another option to the default FreeBSD welcome menu From a5de08da88eaf76bbfb7c1a54169cf12dcd541f1 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 26 Feb 2023 00:50:44 +0100 Subject: [PATCH 566/592] Update boot.md --- developer/boot.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/developer/boot.md b/developer/boot.md index 9086703d..f89bfffd 100644 --- a/developer/boot.md +++ b/developer/boot.md @@ -193,6 +193,9 @@ Example: `load: 0.62 cmd: sleep 1739 [nanslp] 2.97r 0.00u 0.00s 0% 2168k` If you would like to observe the details of the boot process, you can start your computer in __verbose mode__. This allows you to inspect the Live system early boot process and to enter commands manually that would otherwise be executed automatically. +Since helloSystem 0.8.1: To boot in verbose mode, press the "k" key as soon as the screen becomes grey. + +Before helloSystem 0.8.1: 1. While the bootloader is running, keep the {kbd}`Backspace` key pressed until you see an `OK` prompt (alternatively, for a short time during boot, it says `Hit [Enter] to boot immediately, or any other key for command prompt.`. Press the {kbd}`Esc` key on your keyboard immediately when you see this) 2. Type `unset boot_mute` and press the {kbd}`Enter` key. This disables the graphical splash screen and results in boot messages being shown 3. Type `boot -v` and press the {kbd}`Enter` key. This results in the system being booted in verbose mode @@ -203,6 +206,9 @@ The computer should boot into a graphical desktop. If your computer hangs during booting, you can boot into __verbose single-user mode__. This allows advanced users, administrators, and developers to inspect the Live system early boot process and to enter commands manually that would otherwise be executed automatically. +Since helloSystem 0.8.1: To boot in verbose single-user mode, press the "s" key as soon as the screen becomes grey. + +Before helloSystem 0.8.1: 1. While the bootloader is running, keep the {kbd}`Backspace` key pressed until you see an `OK` prompt (alternatively, for a short time during boot, it says `Hit [Enter] to boot immediately, or any other key for command prompt.`. Press the {kbd}`Esc` key on your keyboard immediately when you see this) 1. Type `unset boot_mute` and press the {kbd}`Enter` key. This disables the graphical splash screen and results in boot messages being shown 1. Type `boot -v -s` and press the {kbd}`Enter` key. This results in the system being booted in verbose single-user mode From b90a1f2748d6ff41fb54d47bc13f1dcd6aa8bc02 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 26 Feb 2023 00:51:17 +0100 Subject: [PATCH 567/592] Update boot.md --- developer/boot.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/developer/boot.md b/developer/boot.md index f89bfffd..4aa2dadc 100644 --- a/developer/boot.md +++ b/developer/boot.md @@ -193,7 +193,7 @@ Example: `load: 0.62 cmd: sleep 1739 [nanslp] 2.97r 0.00u 0.00s 0% 2168k` If you would like to observe the details of the boot process, you can start your computer in __verbose mode__. This allows you to inspect the Live system early boot process and to enter commands manually that would otherwise be executed automatically. -Since helloSystem 0.8.1: To boot in verbose mode, press the "k" key as soon as the screen becomes grey. +Since helloSystem 0.8.1: To boot in verbose mode, press the "v" key as soon as the screen becomes grey. Before helloSystem 0.8.1: 1. While the bootloader is running, keep the {kbd}`Backspace` key pressed until you see an `OK` prompt (alternatively, for a short time during boot, it says `Hit [Enter] to boot immediately, or any other key for command prompt.`. Press the {kbd}`Esc` key on your keyboard immediately when you see this) From 23533ac8f8354aeedfdc1d3bc655e99c5f5acb3d Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 26 Feb 2023 00:53:56 +0100 Subject: [PATCH 568/592] Update boot.md --- developer/boot.md | 14 +------------- 1 file changed, 1 insertion(+), 13 deletions(-) diff --git a/developer/boot.md b/developer/boot.md index 4aa2dadc..50464d9c 100644 --- a/developer/boot.md +++ b/developer/boot.md @@ -92,19 +92,7 @@ This starts services like sshd; you need to edit the {file}`/usr/local/etc/rc.d/ ## Debugging the Live system boot process -The following has been tested on experimental helloSystem 0.8.0 builds. - -Press the Backspace key on your keyboard during early boot until you see the `OK` prompt. - -![bootloader](https://user-images.githubusercontent.com/2480569/202910570-9bcc21c5-d9f4-4c3f-b8c0-b07b7e36f35e.png) - -Enter - -```console -OK boot -s -``` - -to boot in single user mode. The system will boot to the first stage Live system prompt: +As soon as the screen becomes grey, press "s" to boot in single-user mode. The system will boot to the first stage Live system prompt: ![livefirstsingleprompt](https://user-images.githubusercontent.com/2480569/202910574-22c0e284-8717-4ae0-9489-68cc23995e1d.png) From dff071df1defa18c209a08ae32d5b481bcb261c5 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 26 Feb 2023 00:57:08 +0100 Subject: [PATCH 569/592] Update boot-environments.md --- user/components/preferences/boot-environments.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/user/components/preferences/boot-environments.md b/user/components/preferences/boot-environments.md index cd967f31..34187001 100644 --- a/user/components/preferences/boot-environments.md +++ b/user/components/preferences/boot-environments.md @@ -40,6 +40,8 @@ The selected Boot Environment will be mounted, and a Filer window will be opened Activate a Boot Environment by checking its checkbox, and then press {guilabel}`Restart...`. The computer will restart into the selected Boot Environment. +You can also select which Boot Environment to start into from the bootloader. Starting with helloSystem 0.8.1, press the Backspace key as soon as the screen becomes grey. Then use the FreeBSD bootloader menu to choose a Boot Environment and to start the system. Note that choosing a Boot Environment this way does not change the default Boot Environment, and will affect the current boot only. + ## More Information Advanced users can use the `bectl` command on the command line, which the __Boot Environments__ preferences application is using under the hood. From daa6c864892de87bfecd17dfd80df1e81c0f9fee Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 26 Feb 2023 00:59:55 +0100 Subject: [PATCH 570/592] Update boot.md [ci skip] --- developer/boot.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/developer/boot.md b/developer/boot.md index 50464d9c..4190a670 100644 --- a/developer/boot.md +++ b/developer/boot.md @@ -181,7 +181,7 @@ Example: `load: 0.62 cmd: sleep 1739 [nanslp] 2.97r 0.00u 0.00s 0% 2168k` If you would like to observe the details of the boot process, you can start your computer in __verbose mode__. This allows you to inspect the Live system early boot process and to enter commands manually that would otherwise be executed automatically. -Since helloSystem 0.8.1: To boot in verbose mode, press the "v" key as soon as the screen becomes grey. +Since helloSystem 0.8.1: To boot in verbose mode, press the {kbd}`v` key on your keyboard as soon as the screen becomes grey. Before helloSystem 0.8.1: 1. While the bootloader is running, keep the {kbd}`Backspace` key pressed until you see an `OK` prompt (alternatively, for a short time during boot, it says `Hit [Enter] to boot immediately, or any other key for command prompt.`. Press the {kbd}`Esc` key on your keyboard immediately when you see this) @@ -194,7 +194,7 @@ The computer should boot into a graphical desktop. If your computer hangs during booting, you can boot into __verbose single-user mode__. This allows advanced users, administrators, and developers to inspect the Live system early boot process and to enter commands manually that would otherwise be executed automatically. -Since helloSystem 0.8.1: To boot in verbose single-user mode, press the "s" key as soon as the screen becomes grey. +Since helloSystem 0.8.1: To boot in verbose single-user mode, press the {kbd}`s` key on your keyboard as soon as the screen becomes grey. Before helloSystem 0.8.1: 1. While the bootloader is running, keep the {kbd}`Backspace` key pressed until you see an `OK` prompt (alternatively, for a short time during boot, it says `Hit [Enter] to boot immediately, or any other key for command prompt.`. Press the {kbd}`Esc` key on your keyboard immediately when you see this) From bda37ea2710ec0b82ebc7b54697a351abe839f48 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 26 Feb 2023 01:00:45 +0100 Subject: [PATCH 571/592] Update boot-environments.md --- user/components/preferences/boot-environments.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/user/components/preferences/boot-environments.md b/user/components/preferences/boot-environments.md index 34187001..45016e44 100644 --- a/user/components/preferences/boot-environments.md +++ b/user/components/preferences/boot-environments.md @@ -40,7 +40,7 @@ The selected Boot Environment will be mounted, and a Filer window will be opened Activate a Boot Environment by checking its checkbox, and then press {guilabel}`Restart...`. The computer will restart into the selected Boot Environment. -You can also select which Boot Environment to start into from the bootloader. Starting with helloSystem 0.8.1, press the Backspace key as soon as the screen becomes grey. Then use the FreeBSD bootloader menu to choose a Boot Environment and to start the system. Note that choosing a Boot Environment this way does not change the default Boot Environment, and will affect the current boot only. +You can also select which Boot Environment to start into from the bootloader. Starting with helloSystem 0.8.1, press the press the {kbd}`Backsapce` key on your keyboard as soon as the screen becomes grey. Then use the FreeBSD bootloader menu to choose a Boot Environment and to start the system. Note that choosing a Boot Environment this way does not change the default Boot Environment, and will affect the current boot only. ## More Information From 973d730d4679fd14063e02c276fca66f81f92c43 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 26 Feb 2023 02:34:16 +0100 Subject: [PATCH 572/592] Auto-updating links to latest release [ci skip] --- user/getting-started.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/user/getting-started.md b/user/getting-started.md index 77817e33..04937f94 100644 --- a/user/getting-started.md +++ b/user/getting-started.md @@ -6,17 +6,16 @@ * 2 GiB RAM system memory (4 GiB recommended; before 0.7.0: 4 GiB minimum) * VGA capable of 1024x768 screen resolution * Either a CD/DVD drive or a USB port for booting the installer media -* On non-Macintosh hardware, a [Raspberry Pi keyboard](https://static.raspberrypi.org/files/product-briefs/210108_Product_Brief_Keyboard_and_Mouse.pdf) is recommended as it allows the keyboard and system language to be detected automatically if it is attached while the system is starting up. On Macintosh hardware, the `prev-lang:kbd` EFI variable is usually set and is used to detect the keyboard and system language. Note that the key left to the space bar is used as the Command key (Alt key on PC keyboards, Apple key on Apple keyboards). +* On non-Macintosh hardware, a [Raspberry Pi Keyboard and Hub]([https://static.raspberrypi.org/files/product-briefs/210108_Product_Brief_Keyboard_and_Mouse.pdf](https://www.raspberrypi.com/products/raspberry-pi-keyboard-and-hub/)) is recommended as it allows the keyboard and system language to be detected automatically if it is attached while the system is starting up. On Macintosh hardware, the `prev-lang:kbd` EFI variable is usually set and is used to detect the keyboard and system language. Note that the key left to the space bar is used as the Command key (Alt key on PC keyboards, Apple key on Apple keyboards). Please refer to [FreeBSD Hardware Compatibility](https://www.freebsd.org/doc/en_US.ISO8859-1/books/faq/hardware.html) for more information on individual components. ## Downloading -The **helloSystem 0.8.0** ISO image is available for download [here](https://github.com/helloSystem/ISO/releases/tag/r0.8.0). +The latest helloSystem release ISO image is available for download [here](https://github.com/helloSystem/ISO/releases/latest). Experimental and pre-release images are available for download [here](https://github.com/helloSystem/ISO/releases). - :::{important} Experimental images get built automatically whenever source code is committed. Not every build is tested. Builds marked as "Pre-Release" are strictly for developers, may be broken and may not even boot. ::: From 5a1b1bea6d3c70df1b6b6d1918998a44ffb64805 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 26 Feb 2023 02:49:30 +0100 Subject: [PATCH 573/592] Use badges for download links --- user/getting-started.md | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/user/getting-started.md b/user/getting-started.md index 04937f94..2f69350d 100644 --- a/user/getting-started.md +++ b/user/getting-started.md @@ -12,9 +12,13 @@ Please refer to [FreeBSD Hardware Compatibility](https://www.freebsd.org/doc/en_ ## Downloading -The latest helloSystem release ISO image is available for download [here](https://github.com/helloSystem/ISO/releases/latest). +The latest helloSystem release ISO image is available for download here: -Experimental and pre-release images are available for download [here](https://github.com/helloSystem/ISO/releases). +[![GitHub release (latest by date)](https://img.shields.io/github/v/release/helloSystem/ISO)](https://github.com/helloSystem/ISO/releases/latest) + +Experimental and pre-release images are available for download here: + +[![GitHub release (latest SemVer including pre-releases)](https://img.shields.io/github/v/release/helloSystem/ISO?include_prereleases)](https://github.com/helloSystem/ISO/releases) :::{important} Experimental images get built automatically whenever source code is committed. Not every build is tested. Builds marked as "Pre-Release" are strictly for developers, may be broken and may not even boot. From ad89d72a5a7831a670503e98036f37b2150e4dad Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 26 Feb 2023 02:55:50 +0100 Subject: [PATCH 574/592] Update getting-started.md [ci skip] --- user/getting-started.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/user/getting-started.md b/user/getting-started.md index 2f69350d..e88b2ed7 100644 --- a/user/getting-started.md +++ b/user/getting-started.md @@ -61,6 +61,8 @@ hello is known to boot to a graphical desktop on the following machines. Auxilia helloSystem developers currently have access to the following hardware: +* [Framework Mainboard](https://frame.work/de/de/products/mainboard) (11th Gen Intel® Core™) +* Acer TravelMate B117 * Acer Revo RL85 * Dell Inc. OptiPlex 780 From c2cd756c2355906684d0adeebd15a34e981b2e63 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 26 Feb 2023 03:00:21 +0100 Subject: [PATCH 575/592] Update getting-started.md [ci skip] --- user/getting-started.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/user/getting-started.md b/user/getting-started.md index e88b2ed7..873511ab 100644 --- a/user/getting-started.md +++ b/user/getting-started.md @@ -28,7 +28,7 @@ Experimental images get built automatically whenever source code is committed. N The ISO file needs to be written to a device, e.g., to a USB stick, in order to a computer being able to start from it. This will overwrite and destroy all data on that device. -helloSystem comes with a __Create Live Media__ utility that allows to write ISO files to a device easily. +If you are already running helloSystem, then you can use the built-in __Create Live Media__ utility to download and write live media. If you are not running helloSystem yet or would like to use the command line, the following command should work on all BSD flavors: From 30b9ab6e78dfae0ea5b413a1fd0b2c6d77de29e5 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 26 Feb 2023 11:42:10 +0100 Subject: [PATCH 576/592] Update guide.md --- reviewer/guide.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/reviewer/guide.md b/reviewer/guide.md index 3b4778dc..bb8901c3 100644 --- a/reviewer/guide.md +++ b/reviewer/guide.md @@ -2,7 +2,7 @@ ## Introduction -helloSystem is an open-source operating system based on FreeBSD. Its goal is to provide a friendly, highly usable, and visually appealing system for desktop and notebook computers. The system is designed to be easy to use, efficient, with an emphasis on minimalism and simplicity. +helloSystem is an open-source operating system that builds on FreeBSD as a rock solid foundation. Its goal is to provide a friendly, highly usable, and visually appealing system for desktop and notebook computers. The system is designed to be easy to use, efficient, with an emphasis on minimalism and simplicity. Its target audience are switchers from the Mac platform, to which it aims to provide an environment in which they can feel instantly at home. @@ -42,7 +42,7 @@ If you encounter any issues during the installation process, please consult the ## User Interface -The six-part series on [Linux desktop usability](https://medium.com/@probonopd/make-it-simple-linux-desktop-usability-part-1-5fa0fb369b42) by helloSystem's founder eventually lead to the design and development of helloSystem. The series explored aspects of desktop usability, from user interface design to application packaging and distribution. The insights expressed in the series helped inform the design decisions behind helloSystem, with a focus on simplicity, ease of use, and discoverability. The indended result is a user-friendly and efficient operating system that is easy to use and customize, even for non-technical users. +The six-part series on [Linux desktop usability](https://medium.com/@probonopd/make-it-simple-linux-desktop-usability-part-1-5fa0fb369b42) by helloSystem's founder eventually lead to the design and development of helloSystem. The series explored aspects of desktop usability, from user interface design to application packaging and distribution. The insights expressed in the series helped inform the design decisions behind helloSystem, with a focus on simplicity, ease of use, and discoverability. The intended result is a user-friendly and efficient operating system that is easy to use and customize, even for non-technical users. The helloSystem user interface is designed to be intuitive, functional, and discoverable, with a range of features and tools to meet the needs of both new and experienced users. Here are some key concepts: @@ -52,7 +52,7 @@ The helloSystem user interface is designed to be intuitive, functional, and disc - **Keyboard layout and language autodetection**: When using a Mac or a [Raspberry Pi Keyboard and Hub](https://www.raspberrypi.com/products/raspberry-pi-keyboard-and-hub/), helloSystem will automatically detect the keyboard layout and language, removing the need to configure it manually. -- **Menu search and launcher**: helloSystem includes a powerful menu search and launcher, which can be used to quickly find and launch applications, files, and menu commands. It is located in the top right corner of the global menu bar and can be a true productivity booster, as it allows the system to be operated virtually only by using the keyboard. +- **Menu search and launcher**: helloSystem includes a powerful menu search and launcher, which can be used to quickly find and launch applications, files, and menu commands. It is located in the top left corner of the global menu bar and can be a true productivity booster, as it allows the system to be operated virtually only by using the keyboard. - **Application bundles**: Applications on helloSystem are structured as self-contained bundles, which can be easily installed, removed, and updated. From 23b6022efd846df02f72d8f1d2f0c1d8e5b3ae99 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 12 Mar 2023 13:21:49 +0100 Subject: [PATCH 577/592] Update menu.md --- user/components/system/menu.md | 17 ++++++++++++++++- 1 file changed, 16 insertions(+), 1 deletion(-) diff --git a/user/components/system/menu.md b/user/components/system/menu.md index dbdcad70..56fa65a2 100644 --- a/user/components/system/menu.md +++ b/user/components/system/menu.md @@ -9,6 +9,9 @@ The menu bar at the top of the screen lets you perform, among others, the follow * Launch applications * Shut down your computer * Search in application menus +* Search for documents and folders on your computer +* Open folders at certain paths +* Perform calculations * See date and time ## Getting computer information @@ -33,7 +36,19 @@ To shut down your computer, select "Log Out" from the "System" menu, then click ## Searching in application menus -Click on "Search" in the menu bar, or press {kbd}`Alt+Space`. Then enter a few characters of the menu entry you would like to execute, select one of the matches from the list, and press the Enter key. If only one choice remains left as you are typing, the remaining entry automatically gets selected. +Click on "Search" in the menu bar, or press {kbd}`Command+Space`. Then enter a few characters of the menu entry you would like to execute, select one of the matches from the list, and press the Enter key. + +## Searching for documents and folders on your computer + +Click on "Search" in the menu bar, or press {kbd}`Command+Space`. Then enter a few characters of the document or folder name, select one of the matches from the list, and press the Enter key. + +## Opening folders at certain paths + +Click on "Search" in the menu bar, or press {kbd}`Command+Space`. Then enter `/` or `~` followed by a folder name, select one of the matches from the list, and press the Enter key. + +## Performing calculations + +Starting with helloSystem 0.8.2, you can perform calculations using the Menu. Click on "Search" in the menu bar, or press {kbd}`Command+Space`. Then enter a mathematical statement like `2+2` or `sqrt(2)`. The result of the calculation will be shown in the menu. ## Date and time From b4e9bf1fed71b7b866a79f476b03a7ad5fab6b6a Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 12 Mar 2023 13:31:01 +0100 Subject: [PATCH 578/592] Update menu.md --- user/components/system/menu.md | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/user/components/system/menu.md b/user/components/system/menu.md index 56fa65a2..1d007d2d 100644 --- a/user/components/system/menu.md +++ b/user/components/system/menu.md @@ -1,7 +1,5 @@ # Menu -![Menu](https://pbs.twimg.com/media/EniEQ0uXIAEA2O5?format=png) - The menu bar at the top of the screen lets you perform, among others, the following functions: * Get information about your computer @@ -48,7 +46,7 @@ Click on "Search" in the menu bar, or press {kbd}`Command+Space`. Then enter `/` ## Performing calculations -Starting with helloSystem 0.8.2, you can perform calculations using the Menu. Click on "Search" in the menu bar, or press {kbd}`Command+Space`. Then enter a mathematical statement like `2+2` or `sqrt(2)`. The result of the calculation will be shown in the menu. +Starting with helloSystem 0.8.2, you can perform calculations using the Menu. Click on "Search" in the menu bar, or press {kbd}`Command+Space`. Then enter a mathematical statement like `2+2` or `sqrt(2)`. The result of the calculation will be shown in the menu. See these [examples](https://github.com/Qalculate/libqalculate#features) for the type of calculations that can be performed. ## Date and time From 9724b034c53611c9ae267e24f2c63225eedbebd0 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 12 Mar 2023 14:43:32 +0100 Subject: [PATCH 579/592] Update acknowledgements.md --- developer/acknowledgements.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/developer/acknowledgements.md b/developer/acknowledgements.md index 6da137bc..5a723dd8 100644 --- a/developer/acknowledgements.md +++ b/developer/acknowledgements.md @@ -133,7 +133,7 @@ __[alphamodh0](https://github.com/alphamodh0)__ ## Luna Jernberg __[bittin](https://github.com/bittin)__ -* Translated helloSystem installer to Swedish +* Swedish translator ## Framework Computer Inc __[FrameworkComputer](https://github.com/FrameworkComputer)__ From a2b08faf4c46fe3583b1d24bbcd9eeb1bdef8099 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 18 Jun 2023 19:55:53 +0200 Subject: [PATCH 580/592] Hierosme --- developer/acknowledgements.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/developer/acknowledgements.md b/developer/acknowledgements.md index 5a723dd8..aa4147f6 100644 --- a/developer/acknowledgements.md +++ b/developer/acknowledgements.md @@ -138,3 +138,8 @@ __[bittin](https://github.com/bittin)__ ## Framework Computer Inc __[FrameworkComputer](https://github.com/FrameworkComputer)__ * Donated a Framework Mainboard (i5-1135G7) through the Developer Mainboard Program + +## Jérôme Ornech +__[Hierosme](https://github.com/Hierosme)__ +* Rewrote Processes.app ([#159](https://github.com/helloSystem/Utilities/pull/159)) +* Wrote Network Utility.app From 20b77ac4e8806f764b2c4f2fa8b3c7189a09f58c Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 18 Jun 2023 21:57:07 +0200 Subject: [PATCH 581/592] Tuux --- developer/acknowledgements.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/developer/acknowledgements.md b/developer/acknowledgements.md index aa4147f6..49e5fcf1 100644 --- a/developer/acknowledgements.md +++ b/developer/acknowledgements.md @@ -140,6 +140,6 @@ __[FrameworkComputer](https://github.com/FrameworkComputer)__ * Donated a Framework Mainboard (i5-1135G7) through the Developer Mainboard Program ## Jérôme Ornech -__[Hierosme](https://github.com/Hierosme)__ +__[Hierosme](https://github.com/Hierosme)__ alias __[Tuuux](https://gitlab.com/Tuuux/)__ * Rewrote Processes.app ([#159](https://github.com/helloSystem/Utilities/pull/159)) * Wrote Network Utility.app From 92317c4931e8875dceb351c42d6084dff53fc236 Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 26 Jun 2023 22:12:02 +0200 Subject: [PATCH 582/592] 800x600 screen resolution is the minimum --- user/getting-started.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/user/getting-started.md b/user/getting-started.md index 873511ab..bab116ce 100644 --- a/user/getting-started.md +++ b/user/getting-started.md @@ -4,7 +4,7 @@ * 2 GHz dual core Intel/AMD 64-bit processor * 2 GiB RAM system memory (4 GiB recommended; before 0.7.0: 4 GiB minimum) -* VGA capable of 1024x768 screen resolution +* VGA capable of 800x600 screen resolution (1024x768 or more recommended) * Either a CD/DVD drive or a USB port for booting the installer media * On non-Macintosh hardware, a [Raspberry Pi Keyboard and Hub]([https://static.raspberrypi.org/files/product-briefs/210108_Product_Brief_Keyboard_and_Mouse.pdf](https://www.raspberrypi.com/products/raspberry-pi-keyboard-and-hub/)) is recommended as it allows the keyboard and system language to be detected automatically if it is attached while the system is starting up. On Macintosh hardware, the `prev-lang:kbd` EFI variable is usually set and is used to detect the keyboard and system language. Note that the key left to the space bar is used as the Command key (Alt key on PC keyboards, Apple key on Apple keyboards). From b8e12186384bfa9533a92c885f6f9a5ca2208481 Mon Sep 17 00:00:00 2001 From: Ben Iofel Date: Sat, 26 Aug 2023 03:03:34 -0400 Subject: [PATCH 583/592] Fix raspi keyboard & hub link (#51) --- user/getting-started.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/user/getting-started.md b/user/getting-started.md index bab116ce..6424cde4 100644 --- a/user/getting-started.md +++ b/user/getting-started.md @@ -6,7 +6,7 @@ * 2 GiB RAM system memory (4 GiB recommended; before 0.7.0: 4 GiB minimum) * VGA capable of 800x600 screen resolution (1024x768 or more recommended) * Either a CD/DVD drive or a USB port for booting the installer media -* On non-Macintosh hardware, a [Raspberry Pi Keyboard and Hub]([https://static.raspberrypi.org/files/product-briefs/210108_Product_Brief_Keyboard_and_Mouse.pdf](https://www.raspberrypi.com/products/raspberry-pi-keyboard-and-hub/)) is recommended as it allows the keyboard and system language to be detected automatically if it is attached while the system is starting up. On Macintosh hardware, the `prev-lang:kbd` EFI variable is usually set and is used to detect the keyboard and system language. Note that the key left to the space bar is used as the Command key (Alt key on PC keyboards, Apple key on Apple keyboards). +* On non-Macintosh hardware, a [Raspberry Pi Keyboard and Hub](https://www.raspberrypi.com/products/raspberry-pi-keyboard-and-hub/) is recommended as it allows the keyboard and system language to be detected automatically if it is attached while the system is starting up. On Macintosh hardware, the `prev-lang:kbd` EFI variable is usually set and is used to detect the keyboard and system language. Note that the key left to the space bar is used as the Command key (Alt key on PC keyboards, Apple key on Apple keyboards). Please refer to [FreeBSD Hardware Compatibility](https://www.freebsd.org/doc/en_US.ISO8859-1/books/faq/hardware.html) for more information on individual components. From b397cec1f1b5abfc53ff743de9004d21816556ba Mon Sep 17 00:00:00 2001 From: probonopd Date: Sun, 3 Sep 2023 11:11:56 +0200 Subject: [PATCH 584/592] Remoev sha; package does not exist anymore --- developer/building.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/developer/building.md b/developer/building.md index eb57c90e..7596384c 100644 --- a/developer/building.md +++ b/developer/building.md @@ -12,7 +12,7 @@ However, it is also possible to build the ISO locally, which is especially handy ## System requirements for building -* A FreeBSD or helloSystem installed on the computer. The FreeBSD version needs to match the FreeBSD version of the helloSystem ISO being built (e.g., `12.2-RELEASE`) +* A FreeBSD or helloSystem installed on the computer. The FreeBSD version needs to match the FreeBSD version of the helloSystem ISO being built (e.g., `13.2-RELEASE`) * 2 GHz dual core processor * 4 GiB RAM (system memory) * 50 GB of hard-drive space @@ -22,7 +22,7 @@ However, it is also possible to build the ISO locally, which is especially handy ## Building the Live ISO ```console -$ sudo pkg install -y pkg git-lite zsync wget sha bash zip devel/py-xdg librsvg2 ca_root_nss +$ sudo pkg install -y pkg git-lite zsync wget bash zip devel/py-xdg librsvg2 ca_root_nss $ git clone https://github.com/helloSystem/ISO $ cd ISO $ sudo ./build.sh hello From 4118aca33506ba4716083d432630b3255e11dda4 Mon Sep 17 00:00:00 2001 From: Ostap Brehin Date: Sat, 16 Sep 2023 09:43:57 +0100 Subject: [PATCH 585/592] Add Ukrainian translation to the welcome text (#52) --- index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.md b/index.md index 8713ebcc..51e6137c 100644 --- a/index.md +++ b/index.md @@ -5,7 +5,7 @@ ``` ```{eval-rst} -.. centered:: Willkommen • Welcome • Bienvenue • Benvenuto • Bienvenido • ようこそ • Mabuhay • Tervetuloa • Välkommen • Добро пожаловать • Hoş geldiniz • Bonvenon • 歡迎 +.. centered:: Willkommen • Welcome • Bienvenue • Benvenuto • Bienvenido • ようこそ • Mabuhay • Tervetuloa • Välkommen • Добро пожаловать • Hoş geldiniz • Bonvenon • 歡迎 • Ласкаво просимо ``` # hello From 8ddf99ccc82a176e3cde0cc79bd752d7e7f426e9 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 30 Sep 2023 12:49:47 +0200 Subject: [PATCH 586/592] Update contributing.md --- developer/contributing.md | 20 -------------------- 1 file changed, 20 deletions(-) diff --git a/developer/contributing.md b/developer/contributing.md index 7e6a8930..f0ef9067 100644 --- a/developer/contributing.md +++ b/developer/contributing.md @@ -28,23 +28,3 @@ This is a small, purely volunteer-driven project, so your contributions are _hig Here is what we need help with: [Issues flagged with help-wanted](https://github.com/search?q=org%3AhelloSystem+is%3Aissue+is%3Aopen+label%3A%22help+wanted%22), and of course other contributions are also welcome. Maybe you'd like to look into one of these: [Issues flagged with good-first-issue](https://github.com/search?q=org%3AhelloSystem+is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22&type=). - -### FreeBSD related topics - -Skills/resources we don't currently have and would highly appreciate help with - -|Skillset needed|Topic|Status|Rationale|Contact| -|---|---|---|---|---| -|FreeBSD kernel|Overhaul/bugfixing for unionfs.ko to create a read-write root filesystem|Idea|Save time and RAM by not having to copy the whole root filesystem to RAM|probonopd| -|OpenZFS|A way to combine read-only (Live ISO) with read-write (ramdisk) to create a read-write root filesystem|Idea|Save time and RAM by not having to copy the whole root filesystem to RAM|probonopd| -|FreeBSD build system|Kernel-related packages built for each FreeBSD version ([details](https://github.com/furybsd/furybsd-livecd/issues/241))|idea|Xorg fails on 12.2-RELEASE|probonopd| -|FreeBSD Linuxulator|Make it possible for Linux applications to use FreeBSD D-Bus|Idea|Have Linux applications to use the [global menu](https://github.com/helloSystem/Menu) that is running on FreeBSD|probonopd| -|FreeBSD kernel, Golang|Enable Go-based FUSE filesystems for FreeBSD ([issue](https://github.com/jacobsa/fuse/issues/91))|Idea|Packages that are images rather than archives: Experiment with [distr1](http://distr1.org/) concepts on FreeBSD|probonopd| -|Qt, OpenZFS|ZFS snapshot, clone integration into the file manager|Idea|Expose the power of ZFS to non-technical users|probonopd| - -### Qt related topics - -|Skillset needed|Topic|Status|Rationale|Contact| -|---|---|---|---|---| -|Qt|Improve the Filer (file manager)||Please see https://github.com/helloSystem/Filer/issues|probonopd| -|Qt|Improve the Menu (global menu bar)||Please see https://github.com/helloSystem/Menu/issues|probonopd| From 8bfe6c19b0cca28d1a0441f97331da6a2c5fa3a6 Mon Sep 17 00:00:00 2001 From: probonopd Date: Wed, 15 Nov 2023 00:35:02 +0100 Subject: [PATCH 587/592] Update shortcuts.md --- user/components/preferences/shortcuts.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/user/components/preferences/shortcuts.md b/user/components/preferences/shortcuts.md index 2c0d2b18..c22fd740 100644 --- a/user/components/preferences/shortcuts.md +++ b/user/components/preferences/shortcuts.md @@ -1,5 +1,9 @@ # Shortcut Keys +:::{note} +The Shortcut Keys preferences application has been removed following the switch to KWin, which comes with `kglobalaccel`. This area still needs work. +::: + The {guilabel}`Shortcut Keys` preferences application lets you view and edit system-wide keyboard shortcuts. From 6d7453a4ce4884dc6cdb0de477f8e1fbd2fb772b Mon Sep 17 00:00:00 2001 From: Konstantin Date: Mon, 25 Mar 2024 23:53:54 +0300 Subject: [PATCH 588/592] some clarification about global menus (#53) Co-authored-by: Konstantin --- developer/menu.md | 27 +++++++++++++-------------- 1 file changed, 13 insertions(+), 14 deletions(-) diff --git a/developer/menu.md b/developer/menu.md index bfbf8580..7705d69c 100644 --- a/developer/menu.md +++ b/developer/menu.md @@ -27,10 +27,10 @@ APIs can be described in specifications, protocols, and interfaces. * [__StatusNotifierItem spec__](https://www.freedesktop.org/wiki/Specifications/StatusNotifierItem/): "This specification defines the management of visual items, usually icons used for reporting the status of an application to the user or provide a quick access to common actions performed by that application." Similar to what "tray icons" do on Windows. * [__DBusMenu protocol__](): Protocol for which implementations exist for Glib, Gtk, Qt (starting with Qt 2). Applications can export and import their menus (question: only indicators or all menus?) using this protocol. The specification used to be at https://people.canonical.com/~agateau/dbusmenu/spec/index.html but the link is dead as of 2020. On https://agateau.com/2009/statusnotifieritem-and-dbusmenu/ it is described as: "The goal of DBusMenu is to make it possible for applications using the StatusNotifierItem spec to send their menus over DBus, so that the workspace can display them in a consistent way, regardless of whether the application is written using Qt, GTK or another toolkit." Possibly it has significantly evolved since then? According to [__@ximion__](https://github.com/ximion), DBusMenu is a spec that transfers menus to status notifiers, and in combination with `com.canonical.AppMenu.Registrar` can be used for global menus. -* [__org.gtk.Menus interface__](https://wiki.gnome.org/Projects/GLib/GApplication/DBusAPI#org.gtk.Menus): An interface defined by Gnome that "is primarily concerned with three things: communicating menus to the client, establishing links between menus and other menus, and notifying clients of changes". Note that "To do so, it employs a number of D-Bus interfaces. These interfaces are currently considered private implementation details of GApplication and subject to change - therefore they are not documented in the GIO documentation." ([Source](https://wiki.gnome.org/Projects/GLib/GApplication/DBusAPI#org.gtk.Menus)). __How does it relate to the DBusMenu protocol, does it have an overlapping scope or is it a complement?__ According to [__@ximion__](https://github.com/ximion), the `org.gtk.Menus` interface has nothing to do with DBusMenu and was only for the Gnome Shell global menu (deprecated in Gnome). __Why was it deprecated in Gnome Shell and what is the replacement?__ -* [__com.canonical.AppMenu.Registrar D-Bus Service__](): `com.canonical.AppMenu.Registrar`, an interface to register a menu from an application's window to be displayed in another window. This manages that association between XWindow Window IDs and the dbus address and object that provides the menu using the dbusmenu dbus interface. ([Source](https://github.com/KDE/plasma-workspace/blob/master/appmenu/com.canonical.AppMenu.Registrar.xml)). "Appmenu registrar allows other applications to access any active window's application menu tree. Such a registrar is extremely useful for, e.g. implementing global menus (application menus appear in the top panel bar of the desktop environment, and for adding an application menu browser or search engine to HUDs" ([Source](https://packages.debian.org/buster/appmenu-registrar)). __How does it relate to the DBusMenu protocol, does it have an overlapping scope or is it a complement?__ +* [__org.gtk.Menus interface__](https://wiki.gnome.org/Projects/GLib/GApplication/DBusAPI#org.gtk.Menus): An interface defined by Gnome that "is primarily concerned with three things: communicating menus to the client, establishing links between menus and other menus, and notifying clients of changes". Note that "To do so, it employs a number of D-Bus interfaces. These interfaces are currently considered private implementation details of GApplication and subject to change - therefore they are not documented in the GIO documentation." ([Source](https://wiki.gnome.org/Projects/GLib/GApplication/DBusAPI#org.gtk.Menus)). __How does it relate to the DBusMenu protocol, does it have an overlapping scope or is it a complement?__ According to [__@ximion__](https://github.com/ximion), the `org.gtk.Menus` interface has nothing to do with DBusMenu and was only for the Gnome Shell global menu (deprecated in Gnome). It is deprecated in Gnome Shell only, but it still used in Gtk 4.12. GNOME wants to remove a concept of menu from their apps. +* [__com.canonical.AppMenu.Registrar D-Bus Service__](): `com.canonical.AppMenu.Registrar`, an interface to register a menu from an application's window to be displayed in another window. This manages that association between XWindow Window IDs and the dbus address and object that provides the menu using the dbusmenu dbus interface. ([Source](https://github.com/KDE/plasma-workspace/blob/master/appmenu/com.canonical.AppMenu.Registrar.xml)). "Appmenu registrar allows other applications to access any active window's application menu tree. Such a registrar is extremely useful for, e.g. implementing global menus (application menus appear in the top panel bar of the desktop environment, and for adding an application menu browser or search engine to HUDs" ([Source](https://packages.debian.org/buster/appmenu-registrar)). It serves as a central point of storing of registered menus and its mapping to windows (on X11, it is usually an X11 Window Number, I do not designed registrar for Wayland). If we need to work over DBus protocol * [__org/appmenu D-Bus Methods__](): tbd -* [__org.kde.plasma.gmenu_dbusmenu_proxy D-Bus service__](): tbd. Translates Gtk menus to KDE-style menus? +* [__org.kde.plasma.gmenu_dbusmenu_proxy D-Bus service__](): Translates o`org.gtk.Menus` menus to `com.canonical.dbusmenu` menus, because Qt and KDE can use only the latter. ### Implementations @@ -43,7 +43,7 @@ Those may or may not be used in helloSystem, they are mentioned here to give an * [__dbusmenu__](https://wiki.ubuntu.com/DesktopExperienceTeam/ApplicationIndicators#Software_Architecture): Library by Canonical implementing the transport protocol between the applications and the panel * [__libappindicator__](https://wiki.ubuntu.com/DesktopExperienceTeam/ApplicationIndicators#Software_Architecture): Library by Canonical to register icons and menus and internally uses dbusmenu to publish context menus over dbus. Needed for some applications (e.g., screenkey) to show icons in the upper right hand corner of the menu (system tray/notification area). The same as [`indicator-application`](https://launchpad.net/indicator-application)? According to @sunweaver, libappindicator is unmaintained as of late 2022 and [libayatana-appindicator](https://github.com/AyatanaIndicators/libayatana-appindicator) is the current upstream * [__MenuModel__](): Used by Gtk -* [__JAyatana__](): Supposedly allows for displaying global menus in Java Swing applications (such as Netbeans and the JetBrains suite of IDEs) +* [__JAyatana__](): Supposedly allows for displaying global menus in Java Swing applications (such as Netbeans). JetBrains now supports Global Menus without JAyatana. * [__Airyx DBusKit__](https://github.com/mszoek/airyx/tree/main/DBusKit): Airyx DBusKit implements a subset of D-Bus needed to support sending menus of **AppKit** applications to the global menu bar * [__GNUstep libs-dbuskit__](https://github.com/gnustep/libs-dbuskit): The DBusKit framework provides GNUstep Objective-C applications with bindings for the D-Bus inter-process communication system @@ -70,7 +70,7 @@ Please consider submitting issues and pull requests if you can contribute to thi * Description: A library to allow applications to export a menu into the Unity Menu bar. Based on KSNI it also works in KDE and will fallback to generic Systray support if none of those are available. * Bugtracker: https://launchpad.net/libappindicator * Purpose: Needed for some applications (e.g., `screenkey`) to show icons in the upper right hand corner of the menu (system tray/notification area) -* Theory of operation: tbd +* Theory of operation: operated on DBusMenu protocol, and it used by some programs to implement StatusNotifier tray. * Status: active * Issues: tbd * Installed by package: `libappindicator` @@ -89,15 +89,14 @@ Desktop Environment, but it lives on as part of the Vala project. * Purpose: Make Gtk applications export their menus to a global menu bar * Theory of operation: Gtk module that strips menus from all Gtk programs, converts to them MenuModel and send to them AppMenu -(sometimes called a global menu bar). `unity-gtk-module` is used as a backend, and thus must also be installed +(sometimes called a global menu bar). It was a fork of `unity-gtk-module`, but now it is completely separate. * Status: active -* Issues: Only if `GTK_MODULES=appmenu-gtk-module` is exported the menus in e.g. Audacity get shown in the global menu bar. Supposedly used by Firefox and Chrome. Upstream documentation [advises](https://github.com/rilian-la-te/vala-panel-appmenu#post-build-instructions) "Install `libdbusmenu-glib libdbusmenu-gtk3 libdbusmenu-gtk2` to get Chromium/Google Chrome to work" +* Issues: Only if `GTK_MODULES=appmenu-gtk-module` is exported the menus in e.g. Audacity get shown in the global menu bar. Supposedly used by Chrome. Upstream documentation [advises](https://github.com/rilian-la-te/vala-panel-appmenu#post-build-instructions) "Install `libdbusmenu-glib libdbusmenu-gtk3 libdbusmenu-gtk2` to get Chromium/Google Chrome to work". Firefox can use Global Menu only if built with Ubuntu patches. If not - there is no possibility to use Global Menu in Firefox. * Installed by package: `appmenu-gtk-module` ### unity-gtk-module -Currently __not__ used in helloSystem. Do we need it? - +If you use `appmenu-gtk-module`, then you do not need this, because `appmenu-gtk-module` has same fuctionality. :::{note} tbd ::: @@ -245,8 +244,8 @@ information to be displayed to users of the application through the interface sh ## Files involved -* `/usr/local/share/dbus-1/interfaces/com.canonical.AppMenu.Registrar.xml` (comes with the `plasma5-plasma-workspace` package). Unclear whether it is needed for the correct functioning of Global Menus (or for some applications to detect that they are running on a system that is capable of displaying them). Unclear what it is needed for. Unclear how multiple packages could provide this file (if more than one package is installed on the system that contains an application that can display the Global Menu). -* `com.canonical.dbusmenu.xml` (Is it needed? What for?) +* `/usr/local/share/dbus-1/interfaces/com.canonical.AppMenu.Registrar.xml` (comes with the `plasma5-plasma-workspace` package). It is needed for the correct functioning of Global Menus - it is served as main point of storing dictionary (keyed by XWindow) of a `com.canonical.dbusmenu` object. It is needed for all applications using that protocol. There should be only one registrar running, but installed - as many of you want. +* `com.canonical.dbusmenu.xml` - it is a reference XML of Canonical DBusMenu protocol, used by StatusNotifier trays and by Qt applications with Global Menu. ## Environment variables involved @@ -384,8 +383,7 @@ Please consider submitting issues and pull requests if you can contribute to thi * We see `_KDE_NET_WM_APPMENU_OBJECT_PATH(STRING) = "/MenuBar/1"` and `_KDE_NET_WM_APPMENU_SERVICE_NAME(STRING) = ":1.59"` (actual numbers might be different from this example) * Open Qt 5 D-Bus Viewer * Under "Services", click on ":1:59", under "Methods", click on "MenuBar/", "1/" -* __Then what? How can one get the actual menus?__ -* Which standards/specifications is this following? Is this documented somewhere? +* KDE follows `com.canonical.dbusmenu` protocol, you can see its definition in XML file mentioned earlier. ### Getting the menus for a Gtk application @@ -396,7 +394,7 @@ Please consider submitting issues and pull requests if you can contribute to thi * Under "Services", click on "org.gimp.GIMP.UI", under "Methods", click on "org/", "appmenu/", "gtk/", "window/", "0/", "org.gtk.Actions/", "Method: DescribeAll" * __Qt 5 D-Bus Viewer crashes__ * __Then what? How can one get the actual menus?__ -* Which standards/specifications is this following? Is this documented somewhere? +* GTK applications followed `org.gtk.Menus` and `org.gtk.Actions` protocol, you can see how it works inside KDE's gmenu-dbusmenu-proxy. ## Limitations @@ -412,3 +410,4 @@ Please consider contributing ideas and code if you are interested in this topic. * [Fildem](https://github.com/gonzaarcr/Fildem) for GNOME * [CutefishOS](https://twitter.com/cutefishos/status/1401420887568441345) +* [vala-panel-appmenu](https://gitlab.com/vala-panel-project/vala-panel-appmenu) for XFCE and MATE. From 60d3f41bedc29b49f3d9bf9fccb8b7a785eab6fd Mon Sep 17 00:00:00 2001 From: dsk502 <35393307+dsk502@users.noreply.github.com> Date: Sun, 14 Apr 2024 22:46:31 +0800 Subject: [PATCH 589/592] Update building.md (#54) [ci skip] Change git-lite to git --- developer/building.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/developer/building.md b/developer/building.md index 7596384c..2b7f5bd1 100644 --- a/developer/building.md +++ b/developer/building.md @@ -22,7 +22,7 @@ However, it is also possible to build the ISO locally, which is especially handy ## Building the Live ISO ```console -$ sudo pkg install -y pkg git-lite zsync wget bash zip devel/py-xdg librsvg2 ca_root_nss +$ sudo pkg install -y pkg git zsync wget bash zip devel/py-xdg librsvg2 ca_root_nss $ git clone https://github.com/helloSystem/ISO $ cd ISO $ sudo ./build.sh hello From 8c770d67021f394ab65a73583b1d0423f979fac8 Mon Sep 17 00:00:00 2001 From: ykla Date: Sat, 5 Apr 2025 14:35:23 +0800 Subject: [PATCH 590/592] Add simplified Chinese translation to the welcome text (#55) --- index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.md b/index.md index 51e6137c..95be57e5 100644 --- a/index.md +++ b/index.md @@ -5,7 +5,7 @@ ``` ```{eval-rst} -.. centered:: Willkommen • Welcome • Bienvenue • Benvenuto • Bienvenido • ようこそ • Mabuhay • Tervetuloa • Välkommen • Добро пожаловать • Hoş geldiniz • Bonvenon • 歡迎 • Ласкаво просимо +.. centered:: Willkommen • Welcome • Bienvenue • Benvenuto • Bienvenido • ようこそ • Mabuhay • Tervetuloa • Välkommen • Добро пожаловать • Hoş geldiniz • Bonvenon • 歡迎 • Ласкаво просимо • 欢迎 ``` # hello From 98b34ea9d361b05a3d468356bfe5bc4c538d5253 Mon Sep 17 00:00:00 2001 From: probonopd Date: Sat, 5 Jul 2025 08:43:16 +0200 Subject: [PATCH 591/592] Update ports.md --- developer/ports.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/developer/ports.md b/developer/ports.md index 712a9375..e76f2955 100644 --- a/developer/ports.md +++ b/developer/ports.md @@ -302,3 +302,7 @@ Result: * https://reviews.freebsd.org/D37380 If a reviewer requires changes to be made, make the changes and upload (paste) a new diff (like the original diff; not a "diff of the diff"!) by clicking on "Update Diff" on the respective Phabricator page, e.g., https://reviews.freebsd.org/D37378. + +## Working with Cirrus CI + +To build packages on Cirrus CI, a `.cirrus.yml` file similar to https://github.com/b-aaz/xlibre-ports/blob/master/.cirrus.yml can be used. From 4f58d26612b48cd59b460d5a91681065625a160e Mon Sep 17 00:00:00 2001 From: probonopd Date: Mon, 21 Jul 2025 00:42:03 +0200 Subject: [PATCH 592/592] Visual Studio Code, Code OSS (vscode, code-oss) [ci skip] --- developer/menu.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/developer/menu.md b/developer/menu.md index 7705d69c..99c31f9a 100644 --- a/developer/menu.md +++ b/developer/menu.md @@ -287,6 +287,10 @@ Changing this to `"1"` does not make any difference for Cura, though. _To be written._ +### Visual Studio Code, Code OSS (vscode, code-oss) + +Go to File -> Preferences -> Settings and set "Title Bar Style" to "Native" to get a working global menu. + ### Chromium, Chrome Starting with version 0.7.0 of helloSystem, Menu can handle Chrome and (patched) Firefox and Thunderbird, thanks Jesper Schmitz Mouridsen ([__jsm222__](https://github.com/jsm222/)).