diff options
316 files changed, 10781 insertions, 12370 deletions
diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..4dbe29f --- /dev/null +++ b/.gitignore @@ -0,0 +1 @@ +/.cache/ diff --git a/.gitmodules b/.gitmodules index 3b74653..d007e5f 100644 --- a/.gitmodules +++ b/.gitmodules @@ -1,3 +1,6 @@ [submodule "texidocs"] path = texidocs url = git://git.carbslinux.org/docs +[submodule "style"] + path = style + url = git://git.carbslinux.org/carbslinux-style.git diff --git a/Makefile b/Makefile new file mode 100644 index 0000000..c366fdd --- /dev/null +++ b/Makefile @@ -0,0 +1,29 @@ +EMACS = emacs + +all: docs style + emacs --batch --script ./org-publish.el + +docs: update-submodules + mkdir -p docs/docs + makeinfo --html --css-ref=https://www.gnu.org/software/gnulib/manual.css -o docs/docs/carbslinux texidocs/carbslinux.texi + makeinfo --html --css-ref=https://www.gnu.org/software/gnulib/manual.css --no-split -o docs/docs/carbslinux.html texidocs/carbslinux.texi + cp texidocs/carbslinux.txt docs/docs/carbslinux.txt + +style: update-submodules + mkdir -p docs + cp style/carbslinux.css docs/style.css + +update-submodules: + git submodule update --remote --init --recursive -f + +publish: + ${EMACS} --batch --script ./org-publish.el + +rebuild: + rm -rf .cache/var/timestamps + ${MAKE} all + +clean: + rm -rf ./docs ./.cache/var/timestamps + +.PHONY: all docs style update-submodules publish rebuild clean diff --git a/blog/20200128.org b/blog/20200128.org new file mode 100644 index 0000000..9309a99 --- /dev/null +++ b/blog/20200128.org @@ -0,0 +1,16 @@ +#+TITLE: Switching to New Website +#+DATE: <2020-01-28 Tue> +#+AUTHOR: Cem Keylan + +In case you haven't seen it before, this website was powered by [[http://werc.cat-v.org][werc]]. And even +though I liked it really much, it was too powerful for a small website like +this. + +So I have decided to reimplement this website with my own static generation +scripts. The source will probably be on [[https://git.carbslinux.org/website/log.html][its git repository]] when I decide to +publish the website. + +The generation requires Plan9 programs, although I have used them just for my +enthusiasm. I have built the site with a combination of mk (instead of make), +rc, and POSIX sh. I am not yet exactly familiar with rc, but I will replace the +shell scripts when I feel like I can. diff --git a/blog/20200406.org b/blog/20200406.org new file mode 100644 index 0000000..01a143a --- /dev/null +++ b/blog/20200406.org @@ -0,0 +1,58 @@ +#+TITLE: Roadmap for Carbs +#+AUTHOR: Cem Keylan +#+DATE: <2020-04-06 Mon> + +It has been a busy week. There are lots of changes in direction, and more to +come. I want to talk a little about all of them. + +** Carbs Linux Server Going Down + +It became harder to maintain and pay for the server, and I will be shutting it +down in May. I am currently in the phase of carrying over everything to [[https://github.com/CarbsLinux][Github]]. +The repository and the website is served on Github now. I have also moved the +[[https://github.com/CarbsLinux/wiki/wiki][Wiki]] to Github and anyone can edit it there. There are some outdated posts that +I will be fixing around this week. + +I am not quite sure where to store the downloads page now. But I will be +switching that to a new source as well. (Maybe SourceHut?) + +I feel a little sad for switching, but serving on Github is faster, cheaper, and +hassle-free. + +** Forking KISS + +I had a personal fork of KISS, which I enjoyed thoroughly. I didn't intend to +make it the default when I started it, but it has matured enough to be so. The +package manager can now be found on [[https://github.com/CarbsLinux/kiss][this repository]]. See it for the added +changes. + +This will be a change for the better, as I can develop the package manager as it +fits my views. + +** Small Changes on the Website + +I have made some small changes on the website. The build is not dependent on +Plan9 utilities anymore. It was fun messing around with =rc= and =mk=, but they +are quite limited compared to POSIX shell. + +RSS feeds are finally working as intended, both for the [[https://carbslinux.org/news.xml][news]] section, and the +[[https://carbslinux.org/rss.xml][blog]] section. + +You can see every page's =.txt= output at the end of the page by clicking 'View +Page Source'. Meanwhile, I will be updating some pages to be a little more +'human-readable'. + +** Outsources Repository + +I have opened an =outsource= repository, which I will be pushing this week. I +will add a new post when I am ready to push it. I think it will be interesting, +it will also make more sense about the changes I have added to the package +manager. The now empty repository, can be found [[https://github.com/CarbsLinux/outsource][here]]! + +** New Tarball + +Finally, I have released a new tarball today, which can be obtained from the +[[https://dl.carbslinux.org/releases][downloads page]]. + +I am planning to add more of these update posts as I'm feeling better about the +website structure overall. diff --git a/blog/20200410.org b/blog/20200410.org new file mode 100644 index 0000000..0868c2d --- /dev/null +++ b/blog/20200410.org @@ -0,0 +1,21 @@ +#+TITLE: Outsource Repository Concept +#+AUTHOR: Cem Keylan +#+DATE: <2020-04-10 Fri> + +In April 3rd, I have added submodule support for Carbs Linux's fork of =kiss=. +Now, from that sentence, it really doesn't sound exciting at all. But in +reality, it opens a path to lots of creative output, and a better way to manage +multi-user repositories (such as KISS Community). + +When managing a repository of submodules, the repository maintainer's only job +is to deal with adding packages. A package maintainer doesn't have to wait for +the repository maintainer to update their packages, as they are only making the +changes to their own repositories. + +This way, an end-user can also track from their preferred maintainers, and do +that with the tidyness of a single repository in their =KISS_PATH=. + +Carbs Linux now has an outsource repository for some packages. Firefox and its +dependencies have been purged from the main repository, but can be found on it. + +[[https://github.com/CarbsLinux/outsource]] diff --git a/blog/20200508.org b/blog/20200508.org new file mode 100644 index 0000000..c303634 --- /dev/null +++ b/blog/20200508.org @@ -0,0 +1,98 @@ +#+TITLE: The Relation of Carbs and KISS +#+AUTHOR: Cem Keylan +#+DATE: <2020-05-08 Fri> + +Since I have forked KISS, I have received many questions that can be summarized +as "Why?". I have realized that I never truly answered this question. That's the +reason I am writing this post, to give some background on Carbs, and some +differences between KISS Linux and Carbs Linux for anyone who may be wondering. +Perhaps I could make this a "FAQ" page later on. + +** History + +I had the idea of creating my own Linux distribution since the May of 2019. Back +then, I had my own [[https://linuxfromscratch.org][Linux from Scratch]] build, and I wanted to slim it down my +own way and replace the software (with musl,sbase,etc.). The name Carbs Linux +was in my mind since then. I wanted to write my own package manager, but I +wasn't satisfied with anything I had built. + +I had written some incomplete package managers (all named =fat=) and I quickly +threw them into the trash can, where they honestly belonged. I would want to +share them with you for laughs, but my hard-drive got wiped and I have a problem +of not doing an "initial commit" until a program I write is in a usable state. + +I have obtained the 'carbslinux.org' domain name in September 2019, but then +life got on the way, and I stopped for a long time. + +One day on Reddit, I saw Dylan's post on [[https://reddit.com/r/unixporn][r/unixporn]] about KISS, and I really +thought that it was interesting. Here is my [[https://www.reddit.com/r/unixporn/comments/ducd34/sowm_kiss_d/f7lua7x][comment]] to Dylan on that post. I +checked out the package manager and the repository. The packaging system was +extremely clean and well-thought. I decided to give it a go and fork KISS. + +** Differences between KISS and Carbs + +Now, I still baffle when people ask me this question. My intention was never to +create a distribution with specific differences between KISS. My intention was +being my own BDFL of a distribution I maintain. There are lots of differences +between the main repositories, but they are subtle and not worth talking about. +I personally never even installed KISS Linux on my system. So Carbs, isn't +something like a downstream fork of KISS, it is just a distribution that was +initially based on KISS. + +I try to contribute as much as I can to KISS Linux. I think that it is a +brilliant distribution, and it was a great starting point for Carbs. I am really +grateful to Dylan and all the other contributors. + +** What I'm working on now + +Currently I have a few projects that I'm working on for Carbs. These are, + +A BSD port for Carbs. For a while, I have been working on BSD compatibility on +my fork of the [package manager]. I have tested, without any more issues, on +OpenBSD and FreeBSD. The biggest issues remaining are choosing a vendor for BSD, +packaging the BSD source, and providing a minimal base (like busybox for BSD). +If you aren't familiar with BSD, it has a single source code for all of the +utilities (kernel, command line programs, etc.). Contributions (even chipping in +ideas) are very welcome. + +Adding binary package distribution support natively to the package manager. +Biggest issue in small/old computers are compile times. This feature is for the +bigger packages such as webkit, clang, llvm that take a considerable amount of +time. Some computers with low memories cannot even compile firefox/webkit. + +Adding rsync repository support to the package manager. This is not a current +issue, but rather a futureproofing. As time passes, distribution repositories +grow larger. KISS and Carbs are young distributions without this problem right +now. But in something like 5 years, this size will presumably increase to +hundreds of megabytes. At that point it will be pointless to have the repository +sources unless you specifically need them. + +** What's up with all the init/service daemons? + +If you have ever checked the [[https://github.com/carbslinux/repository][repository]], you may have noticed that there are +lots of init/service related packages. I have had my fair share of time with all +of them, and it is an area that I am really interested in. I have even written +my own [[https://github.com/cemkeylan/shinit][init daemon]] and [[https://github.com/cemkeylan/sysmgr][service supervisor]]. I maintain all those packages on KISS +Community Repository as well with the exception of busybox. Those are, =busybox +init/runit=, =runit=, =sinit=, and =sysmgr=. I would definitely recommend +checking out =shinit= and =sysmgr=. + +** Why I don't publicize Carbs + +There are a couple of reasons I don't publicize Carbs a lot. + +KISS is the better alternative in terms of support and community. I work on +maintaining this distribution just as hard as Dylan, but in the end, Carbs is +based on his original hard work, and I believe that he deserves the recognition +more than I do. + +Since I cannot answer questions like "What is the difference?", I prefer staying +as the silent sibling project of KISS Linux. Plus, there is no point in dividing +the newly-emerging community in half. + +That's not because I don't have ideas for the future of Carbs, I do. I just +think that I will deserve the recognition once those above lists are checked. + +I think that's about it, if you have questions you can send me a mail, ping me +on IRC (my handle is =merakor=), and I will be happy to answer. Maybe your +question fits this post, and I can update it to thoroughly give an explanation. diff --git a/blog/20200528.org b/blog/20200528.org new file mode 100644 index 0000000..ba3a305 --- /dev/null +++ b/blog/20200528.org @@ -0,0 +1,37 @@ +#+TITLE: kiss 2.0.0 and Overall Changes +#+AUTHOR: Cem Keylan +#+DATE: <2020-05-28 Thu> + +Carbs Linux kiss version 2.0.0 has been released which introduces rsync +repositories. + +Git is no longer a mandatory dependency for the package manager, every git +source on the core repository has been replaced with https sources (sbase, +sinit), and rootfs tarballs will no longer ship with git. Repositories in the +upcoming tarball will be rsync repositories. + +Git is now on the =extra= repository and is still (optionally) used in the +package manager. + +The idea behind this change is size reductions and increased speed with rsync. +As I said on the previous post, git repositories get larger and larger over the +time span. Currently my personal copy of the git repository is around 77MB and I +have forked KISS Linux (as a shallow copy) around December. Obviously, I have +commits that I ommitted. I tend to create commits I dislike, which I change with +=git reset --soft HEAD^=, which doesn't actually remove the commits, etc. A user +will have a repository much smaller than mine. + +This is a precaution with the added bonuses of speed and dropping a mandatory +dependency. + +You can see the rest of the changelog [[https://github.com/CarbsLinux/kiss/blob/master/CHANGELOG.md][here]]. + +** Binary Repositories + +A few days ago, I have also published [[https://github.com/CarbsLinux/kiss-bin][kiss-bin]], a first version for managing +binary repositories. Currently, there are some caveats that I'll be fixing along +the way. I decided not to include this in the package manager natively as +managing the source based and binary based packages together adds levels of +complexity that we do not want. Instead, this is an extension for kiss which +sources the package manager as a library. I hope to see it being adopted by +others interested on the matter as well. diff --git a/src/blog/20200617.md b/blog/20200617.org index 9938896..0c91582 100644 --- a/src/blog/20200617.md +++ b/blog/20200617.org @@ -1,12 +1,11 @@ -June Newspost -================================================================================ +#+TITLE: June Newspost +#+AUTHOR: Cem Keylan +#+DATE: <2020-06-17 Wed> This will be an active month for Carbs as major changes to the base and the package manager will be coming up. - -Statically linking the base --------------------------------------------------------------------------------- +** Statically linking the base For the past couple of weeks I have been trying to simplify the base and statically link the core (mostly binaries rather than libraries). I usually see @@ -14,7 +13,7 @@ some people extremely opposed to static linking as I also see the opposite on people. I believe that binaries on the core should always be linked statically. This -ensures that an SONAME bump to `libObscure.so` will not break the core +ensures that an SONAME bump to =libObscure.so= will not break the core functionality of your system, forcing you to use external resources to recover from such an issue. As long as you can compile, use core utilities, edit text, and access the web, you can solve any given issue on your system. @@ -23,52 +22,46 @@ However, I don't think that removing shared libraries is sensible either. Not every piece of software out there is good quality enough to be statically linked. - -Major changes on the core repository --------------------------------------------------------------------------------- +** Major changes on the core repository There have been drastic changes to the core repository and the base rootfs this month (with more on the way). Right now changes are as follows. -### Removed from Core -- `git` -- `libressl` -- `grub` -- `bison` -- `dhcpcd` -- `ubase` - -### Added to Core -- `bearssl`, as a `libressl` replacement -- `byacc`, as a `bison` replacement - -### Statically linked -- `kiss` -- `neatvi` -- `mandoc` -- `byacc` -- `m4` -- `e2fsprogs` -- `make` -- `pkgconf` -- `sbase` -- `libnl` -- `wpa_supplicant` -- `bearssl` - - -Making the wiki available offline --------------------------------------------------------------------------------- +*** Removed from Core +- =git= +- =libressl= +- =grub= +- =bison= +- =dhcpcd= +- =ubase= + +*** Added to Core +- =bearssl=, as a =libressl= replacement +- =byacc=, as a =bison= replacement + +*** Statically linked +- =kiss= +- =neatvi= +- =mandoc= +- =byacc= +- =m4= +- =e2fsprogs= +- =make= +- =pkgconf= +- =sbase= +- =libnl= +- =wpa_supplicant= +- =bearssl= + +** Making the wiki available offline Soon, all documentation regarding Carbs Linux will be avaialable to be installed -from the core repository in a `carbs-docs` package along with its own document +from the core repository in a =carbs-docs= package along with its own document crawler. Currently, the documentation regarding the installation process is a little outdated which will also receive some important updates. - -ISO image for Carbs --------------------------------------------------------------------------------- +** ISO image for Carbs I am thinking of releasing an ISO image in order to provide a standardized environment for installation along with installation helper tools in the spirit -of `arch-install-scripts`. Let's see how that's going to play out. +of =arch-install-scripts=. Let's see how that's going to play out. diff --git a/docs/blog/20200803.txt b/blog/20200803.org index eaee932..0dcf679 100644 --- a/docs/blog/20200803.txt +++ b/blog/20200803.org @@ -1,28 +1,22 @@ -August 2020 News Post -================================================================================ +#+TITLE: August 2020 News Post +#+AUTHOR: Cem Keylan +#+DATE: <2020-08-03 Mon> We are having some stalls during this summer, as I am currently working on university-related stuff. Nonetheless, there are some important changes that I want to share in this month's post. -INDEX --------------------------------------------------------------------------------- +#+TOC: headlines 1 local -- [Carbs Packaging Tools](#carbs-packaging-tools) -- [Docs](#docs) -- [Re-opening the Carbs Linux server](#re-opening-the-carbs-linux-server) +** Carbs Packaging Tools - -Carbs Packaging Tools --------------------------------------------------------------------------------- - -This month I have reworked `kiss` into a new package manager, now renamed as -`cpt`. Updating `kiss` will now bootstrap the new package manager, so you don't +This month I have reworked =kiss= into a new package manager, now renamed as +=cpt=. Updating =kiss= will now bootstrap the new package manager, so you don't have to manually edit your system. If you don't like the idea of this, you can -look up the `post-install` script on `core/kiss` and apply the changes manually. +look up the =post-install= script on =core/kiss= and apply the changes manually. -You will also need to rename your KISS_* variables to CPT_*. So, KISS_PATH -becomes CPT_PATH. +You will also need to rename your =KISS_*= variables to =CPT_*=. So, =KISS_PATH= +becomes =CPT_PATH=. The rework changes the previous commands on the package manager into standalone tools, and move the package manager functions to a library. This makes it easier @@ -34,34 +28,28 @@ as well. If you want to use the library on your script you can simply do this: - +--------------------------------------------------------------------------+ - | | - | #!/bin/sh | - | . cpt-lib | - | (...) | - | | - +--------------------------------------------------------------------------+ +#+BEGIN_SRC sh +#!/bin/sh +. cpt-lib +(...) +#+END_SRC There are obviously some clean-up and simplifications needed in this new tool-based package management method. - -Docs --------------------------------------------------------------------------------- +** Docs I have added documentation for the distribution, and finally updated the guide -for installation. It is now _almost_ complete. These docs can be installed to +for installation. It is now /almost/ complete. These docs can be installed to your system for online viewing. I will also add a documentation crawler similar -to how werc[^1] works (but as an offline viewer). You can find `carbs-docs` from +to how werc works (but as an offline viewer). You can find =carbs-docs= from the repository. Currently, the documentation lacks but I will be adding new stuff. These will solely be distribution specific documentation and will not be a wiki-like source. If anyone would like to contribute to a wiki-like documentation source, I would happily re-open the distribution wiki. You can -find the source on https://github.com/CarbsLinux/docs +find the source on [[https://github.com/CarbsLinux/docs]]. - -Re-opening the Carbs Linux server --------------------------------------------------------------------------------- +** Re-opening the Carbs Linux server Back in May, I had shutdown the Carbs Linux server due to financial issues, but I am slowly reverting to the self-hosted model. Back then, the git repositories @@ -71,7 +59,4 @@ time). Now, I will be relaunching the git server which will be the upstream source before August 5. You can switch your remote, but GitHub will stay as a remote nonetheless. -EDIT: The git-server is up! - - -[^1]: http://werc.cat-v.org +*EDIT:* The git-server is up! diff --git a/blog/20201210.org b/blog/20201210.org new file mode 100644 index 0000000..7da78cb --- /dev/null +++ b/blog/20201210.org @@ -0,0 +1,22 @@ +#+TITLE: First Year of Carbs Linux +#+AUTHOR: Cem Keylan +#+DATE: <2020-12-10 Thu> + +December 10, 2020 marks the first year after the initial release of Carbs Linux. +When I forked the KISS Linux repository on the 9th of December, I was fairly new +to package management. Carbs Linux used to be almost identical to KISS Linux. A +lot has changed since then: + +- [2020 Jan 13] Replaced default init system to =sinit= +- [2020 Jan 15] Packaged =WebKit2GTK= +- [2020 May 17] Added =bearssl= on the testing repository +- [2020 May 28] Added =rsync= repository support to kiss +- [2020 Jun 03] Replaced =bison= with =byacc= +- [2020 Jun 11] Replaced =libressl= with =bearssl= +- [2020 Jun 24] Replaced =kiss= with =cpt= + +I have really enjoyed maintaining and developing this distribution, and I want +to thank everyone who was involved in some way or another. While I have slowed +down in development due to college workload, I am still actively maintaining all +the packages on the repository. I do have some ideas that I am thinking of +implementing during the semester break. Hope to see you all in January. diff --git a/blog/index.org b/blog/index.org new file mode 100644 index 0000000..875b133 --- /dev/null +++ b/blog/index.org @@ -0,0 +1,11 @@ +#+TITLE: Blog Index + +This is the Carbs Linux blog index. You can find every post here. [[file:../rss.xml][RSS Feed]] +- [[file:20201210.org][First Year of Carbs Linux]] /posted on 2020-12-10/ +- [[file:20200803.org][August 2020 News Post]] /posted on 2020-08-03/ +- [[file:20200617.org][June Newspost]] /posted on 2020-06-17/ +- [[file:20200528.org][kiss 2.0.0 and Overall Changes]] /posted on 2020-05-28/ +- [[file:20200508.org][The Relation of Carbs and KISS]] /posted on 2020-05-08/ +- [[file:20200410.org][Outsource Repository Concept]] /posted on 2020-04-10/ +- [[file:20200406.org][Roadmap for Carbs]] /posted on 2020-04-06/ +- [[file:20200128.org][Switching to New Website]] /posted on 2020-01-28/ diff --git a/blog/rss.org b/blog/rss.org new file mode 100644 index 0000000..9de4962 --- /dev/null +++ b/blog/rss.org @@ -0,0 +1,463 @@ +#+TITLE: Carbs Linux blog +#+DESCRIPTION: a simple Linux distribution + +* First Year of Carbs Linux +:PROPERTIES: +:RSS_PERMALINK: 20201210.html +:PUBDATE: 2020-12-10 +:ID: 91a73ba0-bd3c-437c-94af-fe767c3dcc02 +:END: +December 10, 2020 marks the first year after the initial release of Carbs Linux. +When I forked the KISS Linux repository on the 9th of December, I was fairly new +to package management. Carbs Linux used to be almost identical to KISS Linux. A +lot has changed since then: + +[2020 Jan 13] Replaced default init system to =sinit= +[2020 Jan 15] Packaged =WebKit2GTK= +[2020 May 17] Added =bearssl= on the testing repository +[2020 May 28] Added =rsync= repository support to kiss +[2020 Jun 03] Replaced =bison= with =byacc= +[2020 Jun 11] Replaced =libressl= with =bearssl= +[2020 Jun 24] Replaced =kiss= with =cpt= + +I have really enjoyed maintaining and developing this distribution, and I want +to thank everyone who was involved in some way or another. While I have slowed +down in development due to college workload, I am still actively maintaining all +the packages on the repository. I do have some ideas that I am thinking of +implementing during the semester break. Hope to see you all in January. +* August 2020 News Post +:PROPERTIES: +:RSS_PERMALINK: 20200803.html +:PUBDATE: 2020-08-03 +:ID: 20184071-45d1-4af3-b679-63610e737f82 +:END: +We are having some stalls during this summer, as I am currently working on +university-related stuff. Nonetheless, there are some important changes that I +want to share in this month's post. + +#+toc: headlines 1 local + +** Carbs Packaging Tools + :PROPERTIES: + :ID: fe405200-c791-40bb-af90-55b14328c901 + :END: + +This month I have reworked =kiss= into a new package manager, now renamed as +=cpt=. Updating =kiss= will now bootstrap the new package manager, so you don't +have to manually edit your system. If you don't like the idea of this, you can +look up the =post-install= script on =core/kiss= and apply the changes manually. + +You will also need to rename your =KISS_*= variables to =CPT_*=. So, =KISS_PATH= +becomes =CPT_PATH=. + +The rework changes the previous commands on the package manager into standalone +tools, and move the package manager functions to a library. This makes it easier +for a user to import functions and variables from the package manager, and +extend the package manager with their own intended way. Previously this required +ugly hacks and workarounds to use the package manager functions. I will be +making use of these changes to re-implement binary package management functions +as well. + +If you want to use the library on your script you can simply do this: + +#+begin_src sh + #!/bin/sh + . cpt-lib + (...) +#+end_src + +There are obviously some clean-up and simplifications needed in this new +tool-based package management method. + +** Docs + :PROPERTIES: + :ID: 9a665dbf-7a5a-4e66-88a6-b95b27fd0f08 + :END: + +I have added documentation for the distribution, and finally updated the guide +for installation. It is now /almost/ complete. These docs can be installed to +your system for online viewing. I will also add a documentation crawler similar +to how werc works (but as an offline viewer). You can find =carbs-docs= from +the repository. Currently, the documentation lacks but I will be adding new +stuff. These will solely be distribution specific documentation and will not be +a wiki-like source. If anyone would like to contribute to a wiki-like +documentation source, I would happily re-open the distribution wiki. You can +find the source on [[https://github.com/CarbsLinux/docs]]. + +** Re-opening the Carbs Linux server + :PROPERTIES: + :ID: d2ede03b-5386-48f9-9349-27ad6972558e + :END: + +Back in May, I had shutdown the Carbs Linux server due to financial issues, but +I am slowly reverting to the self-hosted model. Back then, the git repositories +were mirrored to GitHub, and the management was overall much more flexible. The +server used to run Carbs Linux as well (that was fun and horrifying at the same +time). Now, I will be relaunching the git server which will be the upstream +source before August 5. You can switch your remote, but GitHub will stay as a +remote nonetheless. + +*EDIT:* The git-server is up! +* June Newspost +:PROPERTIES: +:RSS_PERMALINK: 20200617.html +:PUBDATE: 2020-06-17 +:ID: e0ddba22-7d55-4830-895a-5d02e1f41f90 +:END: +This will be an active month for Carbs as major changes to the base and the +package manager will be coming up. + +** Statically linking the base + :PROPERTIES: + :ID: ca2f0783-0484-42d6-8f19-1b16330f474e + :END: + +For the past couple of weeks I have been trying to simplify the base and +statically link the core (mostly binaries rather than libraries). I usually see +some people extremely opposed to static linking as I also see the opposite on +people. + +I believe that binaries on the core should always be linked statically. This +ensures that an SONAME bump to =libObscure.so= will not break the core +functionality of your system, forcing you to use external resources to recover +from such an issue. As long as you can compile, use core utilities, edit text, +and access the web, you can solve any given issue on your system. + +However, I don't think that removing shared libraries is sensible either. Not +every piece of software out there is good quality enough to be statically +linked. + +** Major changes on the core repository + :PROPERTIES: + :ID: 7bcf3f1b-1341-485d-a28a-3dedc24d1eee + :END: + +There have been drastic changes to the core repository and the base rootfs this +month (with more on the way). Right now changes are as follows. + +*** Removed from Core + :PROPERTIES: + :ID: 29d41729-1428-44dc-b315-cd9c3070e7c5 + :END: +=git= +=libressl= +=grub= +=bison= +=dhcpcd= +=ubase= + +*** Added to Core + :PROPERTIES: + :ID: 9935f194-03c4-4e83-b6f1-fd8e35adb51e + :END: +=bearssl=, as a =libressl= replacement +=byacc=, as a =bison= replacement + +*** Statically linked + :PROPERTIES: + :ID: 445af4be-741c-41a4-b983-a1ffb71c3476 + :END: +=kiss= +=neatvi= +=mandoc= +=byacc= +=m4= +=e2fsprogs= +=make= +=pkgconf= +=sbase= +=libnl= +=wpa_supplicant= +=bearssl= + +** Making the wiki available offline + :PROPERTIES: + :ID: 02f68296-e84b-4a60-9af6-efc5b72a262e + :END: + +Soon, all documentation regarding Carbs Linux will be avaialable to be installed +from the core repository in a =carbs-docs= package along with its own document +crawler. Currently, the documentation regarding the installation process is a +little outdated which will also receive some important updates. + +** ISO image for Carbs + :PROPERTIES: + :ID: 503ea473-9001-4080-9073-628f4cddaedc + :END: + +I am thinking of releasing an ISO image in order to provide a standardized +environment for installation along with installation helper tools in the spirit +of =arch-install-scripts=. Let's see how that's going to play out. +* kiss 2.0.0 and Overall Changes +:PROPERTIES: +:RSS_PERMALINK: 20200528.html +:PUBDATE: 2020-05-28 +:ID: 757f34bc-c510-4a93-be60-80ac355ad6d3 +:END: +Carbs Linux kiss version 2.0.0 has been released which introduces rsync +repositories. + +Git is no longer a mandatory dependency for the package manager, every git +source on the core repository has been replaced with https sources (sbase, +sinit), and rootfs tarballs will no longer ship with git. Repositories in the +upcoming tarball will be rsync repositories. + +Git is now on the =extra= repository and is still (optionally) used in the +package manager. + +The idea behind this change is size reductions and increased speed with rsync. +As I said on the previous post, git repositories get larger and larger over the +time span. Currently my personal copy of the git repository is around 77MB and I +have forked KISS Linux (as a shallow copy) around December. Obviously, I have +commits that I ommitted. I tend to create commits I dislike, which I change with +=git reset --soft HEAD^=, which doesn't actually remove the commits, etc. A user +will have a repository much smaller than mine. + +This is a precaution with the added bonuses of speed and dropping a mandatory +dependency. + +You can see the rest of the changelog [[https://github.com/CarbsLinux/kiss/blob/master/CHANGELOG.md][here]]. + +** Binary Repositories + :PROPERTIES: + :ID: d34206ef-dac4-4fa7-8a24-6beeb2376615 + :END: + +A few days ago, I have also published [[https://github.com/CarbsLinux/kiss-bin][kiss-bin]], a first version for managing +binary repositories. Currently, there are some caveats that I'll be fixing along +the way. I decided not to include this in the package manager natively as +managing the source based and binary based packages together adds levels of +complexity that we do not want. Instead, this is an extension for kiss which +sources the package manager as a library. I hope to see it being adopted by +others interested on the matter as well. +* The Relation of Carbs and KISS +:PROPERTIES: +:RSS_PERMALINK: 20200508.html +:PUBDATE: 2020-05-08 +:ID: 258ca25e-b053-4c53-a86d-c067346461e3 +:END: +Since I have forked KISS, I have received many questions that can be summarized +as "Why?". I have realized that I never truly answered this question. That's the +reason I am writing this post, to give some background on Carbs, and some +differences between KISS Linux and Carbs Linux for anyone who may be wondering. +Perhaps I could make this a "FAQ" page later on. + +** History + :PROPERTIES: + :ID: 12457ae2-b958-479d-906c-4ec5c333b7a3 + :END: + +I had the idea of creating my own Linux distribution since the May of 2019. Back +then, I had my own [[https://linuxfromscratch.org][Linux from Scratch]] build, and I wanted to slim it down my +own way and replace the software (with musl,sbase,etc.). The name Carbs Linux +was in my mind since then. I wanted to write my own package manager, but I +wasn't satisfied with anything I had built. + +I had written some incomplete package managers (all named =fat=) and I quickly +threw them into the trash can, where they honestly belonged. I would want to +share them with you for laughs, but my hard-drive got wiped and I have a problem +of not doing an "initial commit" until a program I write is in a usable state. + +I have obtained the 'carbslinux.org' domain name in September 2019, but then +life got on the way, and I stopped for a long time. + +One day on Reddit, I saw Dylan's post on [[https://reddit.com/r/unixporn][r/unixporn]] about KISS, and I really +thought that it was interesting. Here is my [[https://www.reddit.com/r/unixporn/comments/ducd34/sowm_kiss_d/f7lua7x][comment]] to Dylan on that post. I +checked out the package manager and the repository. The packaging system was +extremely clean and well-thought. I decided to give it a go and fork KISS. + +** Differences between KISS and Carbs + :PROPERTIES: + :ID: aa9e4559-0afd-4bdb-8993-006a9f16927c + :END: + +Now, I still baffle when people ask me this question. My intention was never to +create a distribution with specific differences between KISS. My intention was +being my own BDFL of a distribution I maintain. There are lots of differences +between the main repositories, but they are subtle and not worth talking about. +I personally never even installed KISS Linux on my system. So Carbs, isn't +something like a downstream fork of KISS, it is just a distribution that was +initially based on KISS. + +I try to contribute as much as I can to KISS Linux. I think that it is a +brilliant distribution, and it was a great starting point for Carbs. I am really +grateful to Dylan and all the other contributors. + +** What I'm working on now + :PROPERTIES: + :ID: 293684f2-3b65-42a0-8011-8441a963194c + :END: + +Currently I have a few projects that I'm working on for Carbs. These are, + +A BSD port for Carbs. For a while, I have been working on BSD compatibility on +my fork of the [package manager]. I have tested, without any more issues, on +OpenBSD and FreeBSD. The biggest issues remaining are choosing a vendor for BSD, +packaging the BSD source, and providing a minimal base (like busybox for BSD). +If you aren't familiar with BSD, it has a single source code for all of the +utilities (kernel, command line programs, etc.). Contributions (even chipping in +ideas) are very welcome. + +Adding binary package distribution support natively to the package manager. +Biggest issue in small/old computers are compile times. This feature is for the +bigger packages such as webkit, clang, llvm that take a considerable amount of +time. Some computers with low memories cannot even compile firefox/webkit. + +Adding rsync repository support to the package manager. This is not a current +issue, but rather a futureproofing. As time passes, distribution repositories +grow larger. KISS and Carbs are young distributions without this problem right +now. But in something like 5 years, this size will presumably increase to +hundreds of megabytes. At that point it will be pointless to have the repository +sources unless you specifically need them. + +** What's up with all the init/service daemons? + :PROPERTIES: + :ID: 8de3a6dd-b66f-4da3-baae-efb264461a67 + :END: + +If you have ever checked the [[https://github.com/carbslinux/repository][repository]], you may have noticed that there are +lots of init/service related packages. I have had my fair share of time with all +of them, and it is an area that I am really interested in. I have even written +my own [[https://github.com/cemkeylan/shinit][init daemon]] and [[https://github.com/cemkeylan/sysmgr][service supervisor]]. I maintain all those packages on KISS +Community Repository as well with the exception of busybox. Those are, =busybox + init/runit=, =runit=, =sinit=, and =sysmgr=. I would definitely recommend +checking out =shinit= and =sysmgr=. + +** Why I don't publicize Carbs + :PROPERTIES: + :ID: 15a9f5cc-3e2f-495d-8075-3213bcebe237 + :END: + +There are a couple of reasons I don't publicize Carbs a lot. + +KISS is the better alternative in terms of support and community. I work on +maintaining this distribution just as hard as Dylan, but in the end, Carbs is +based on his original hard work, and I believe that he deserves the recognition +more than I do. + +Since I cannot answer questions like "What is the difference?", I prefer staying +as the silent sibling project of KISS Linux. Plus, there is no point in dividing +the newly-emerging community in half. + +That's not because I don't have ideas for the future of Carbs, I do. I just +think that I will deserve the recognition once those above lists are checked. + +I think that's about it, if you have questions you can send me a mail, ping me +on IRC (my handle is =merakor=), and I will be happy to answer. Maybe your +question fits this post, and I can update it to thoroughly give an explanation. +* Outsource Repository Concept +:PROPERTIES: +:RSS_PERMALINK: 20200410.html +:PUBDATE: 2020-04-10 +:ID: b70d712e-dfd8-46ba-8519-2102b0506551 +:END: +In April 3rd, I have added submodule support for Carbs Linux's fork of =kiss=. +Now, from that sentence, it really doesn't sound exciting at all. But in +reality, it opens a path to lots of creative output, and a better way to manage +multi-user repositories (such as KISS Community). + +When managing a repository of submodules, the repository maintainer's only job +is to deal with adding packages. A package maintainer doesn't have to wait for +the repository maintainer to update their packages, as they are only making the +changes to their own repositories. + +This way, an end-user can also track from their preferred maintainers, and do +that with the tidyness of a single repository in their =KISS_PATH=. + +Carbs Linux now has an outsource repository for some packages. Firefox and its +dependencies have been purged from the main repository, but can be found on it. + +[[https://github.com/CarbsLinux/outsource]] +* Roadmap for Carbs +:PROPERTIES: +:RSS_PERMALINK: 20200406.html +:PUBDATE: 2020-04-06 +:ID: ab41c584-5be1-46b0-99e2-4d9eef2091aa +:END: +It has been a busy week. There are lots of changes in direction, and more to +come. I want to talk a little about all of them. + +** Carbs Linux Server Going Down + :PROPERTIES: + :ID: 7b2135a9-122c-495e-9bb0-b79fc39ef098 + :END: + +It became harder to maintain and pay for the server, and I will be shutting it +down in May. I am currently in the phase of carrying over everything to [[https://github.com/CarbsLinux][Github]]. +The repository and the website is served on Github now. I have also moved the +[[https://github.com/CarbsLinux/wiki/wiki][Wiki]] to Github and anyone can edit it there. There are some outdated posts that +I will be fixing around this week. + +I am not quite sure where to store the downloads page now. But I will be +switching that to a new source as well. (Maybe SourceHut?) + +I feel a little sad for switching, but serving on Github is faster, cheaper, and +hassle-free. + +** Forking KISS + :PROPERTIES: + :ID: 037cba41-3be3-4714-9512-ff896d600dae + :END: + +I had a personal fork of KISS, which I enjoyed thoroughly. I didn't intend to +make it the default when I started it, but it has matured enough to be so. The +package manager can now be found on [[https://github.com/CarbsLinux/kiss][this repository]]. See it for the added +changes. + +This will be a change for the better, as I can develop the package manager as it +fits my views. + +** Small Changes on the Website + :PROPERTIES: + :ID: b33e18eb-6f15-49e2-9c2b-473af26030f4 + :END: + +I have made some small changes on the website. The build is not dependent on +Plan9 utilities anymore. It was fun messing around with =rc= and =mk=, but they +are quite limited compared to POSIX shell. + +RSS feeds are finally working as intended, both for the [[https://carbslinux.org/news.xml][news]] section, and the +[[https://carbslinux.org/rss.xml][blog]] section. + +You can see every page's =.txt= output at the end of the page by clicking 'View +Page Source'. Meanwhile, I will be updating some pages to be a little more +'human-readable'. + +** Outsources Repository + :PROPERTIES: + :ID: 1856485d-22c8-4c58-b710-ee4fa4374f9d + :END: + +I have opened an =outsource= repository, which I will be pushing this week. I +will add a new post when I am ready to push it. I think it will be interesting, +it will also make more sense about the changes I have added to the package +manager. The now empty repository, can be found [[https://github.com/CarbsLinux/outsource][here]]! + +** New Tarball + :PROPERTIES: + :ID: 63a8a514-af1b-46d1-a4fe-c4e84d47d256 + :END: + +Finally, I have released a new tarball today, which can be obtained from the +[[https://dl.carbslinux.org/releases][downloads page]]. + +I am planning to add more of these update posts as I'm feeling better about the +website structure overall. +* Switching to New Website +:PROPERTIES: +:RSS_PERMALINK: 20200128.html +:PUBDATE: 2020-01-28 +:ID: b8735f8c-441c-45f2-ba47-73daf7ed511a +:END: +In case you haven't seen it before, this website was powered by [[http://werc.cat-v.org][werc]]. And even +though I liked it really much, it was too powerful for a small website like +this. + +So I have decided to reimplement this website with my own static generation +scripts. The source will probably be on [[https://git.carbslinux.org/website/log.html][its git repository]] when I decide to +publish the website. + +The generation requires Plan9 programs, although I have used them just for my +enthusiasm. I have built the site with a combination of mk (instead of make), +rc, and POSIX sh. I am not yet exactly familiar with rc, but I will replace the +shell scripts when I feel like I can. @@ -1,138 +0,0 @@ -#!/bin/sh -e - -ROOT=$PWD - -txt2html() { - printf '<pre>\n' - - # Convert [0-9] to links - sed -E 's|(.*[a-z].*)\[([0-9].*)\]|\1<a href=#\2>[\2]</a>|g' "$1" | - - # Add span id to sections - sed -E 's|^\[([0-9].*)\]|<span id=\1><a href=#\1>[\1]</a></span>|' | - - # Make links clickable - sed -E "s|(http[s]?://[^[:space:]\)]*)|<a href=\1>\1</a>|g" - - printf '</pre>\n' -} - -gettitle() { - unset title - case "$(sed -n 2p "$1")" in =*=|-*-) title="$(sed -n 1p "$1")"; esac - file=${1##*/} file=${file%.*} - printf '%s\n' "${title:-$file}${2:+ | Carbs Linux}" -} - -genpages() ( - cd src || return 1 - find . ! -name .git | while read -r file; do - - # If this is a directory, create the directory on the destination and - # return. - [ -d "$file" ] && { - mkdir -p "../docs/${file#./}" - continue - } - - # We are treating markdown/plaintext files differently. - case "$file" in - *.md|*.txt) - tohtml "$file" > "../docs/${file%.*}.html" - cp "$file" "../docs/${file%.*}.txt" - ;; - - # If this is not a markdown/txt file copy as-is. - *) cp "$file" "../docs/$file" - esac - done -) - - -tohtml() { - srcfile=${1#.} srcfile=${srcfile%.*}.txt - case "${1##*.}" in - md) markdown -f footnote -f fencedcode "$1" ;; - txt) txt2html "$1" ;; - esac | - - sed '/{{ CONTENT }}/r /dev/stdin' "$ROOT/templates/template.html" | - - sed "s#{{ TITLE }}#$(gettitle "$1" html)#" | - - sed '/{{ CONTENT }}/d' | - - sed "s|{{ SRC }}|$srcfile|" -} - -blog_index() { - cat templates/blog-index > src/blog/index.md - find src/blog -type f ! -name index.md | sort -r | while read -r post ; do - postdate="${post##*/}"; postdate="${postdate%%.*}" - printf '* %s - [%s](%s)\n' \ - "$(date --date="$postdate" +%b\ %d\ %Y)" \ - "$(gettitle "$post")" \ - "${postdate}.html" - done >> src/blog/index.md -} - -site_index() { - cp index/index.md src/index.md - :> src/news.md - i=0 - find index -name '*.news' | sort -r | while read -r news; do - [ "$(( i += 1 ))" -lt 6 ] && { - printf '\n' - cat "$news" - } >> src/index.md - [ "$i" -eq 1 ] || printf '\n' >> src/news.md - cat "$news" >> src/news.md - done -} - - -genrss() { - find "$1" -type f ! -name index.md | sort -r | while read -r post ; do - postdate="${post##*/}" ; postdate="${postdate%.*}" - cat <<EOF -<item> -<title>$(gettitle "$post")</title> -<pubDate>$(date --date="$postdate" +%a,\ %d\ %b\ %Y)</pubDate> -<dc:creator>Cem Keylan</dc:creator> -<link>https://carbslinux.org/${3:-blog/$(printf "${post##*/}" | sed 's/.md/.html/')}</link> -<description>$(grep -v '^Title: ' "$post" | markdown -f cdata)</description> -</item> -EOF - done | - - sed '/{{ CONTENT }}/r /dev/stdin' "$ROOT/templates/rss.xml" | - - sed '/{{ CONTENT }}/d' | - - sed "s|{{ SRC }}|${2:-rss}.xml|" | - - sed "s|{{ DATE }}|$(date -u "+%a %b %d %Y %H:00")|" -} - -main() { - # Recreate docs directory - rm -rf docs; mkdir -p docs - - # Generate the indexes. - site_index; blog_index - - # Generate rss feeds - genrss index news index.html > src/news.xml - genrss src/blog > src/rss.xml - - # Generate documentation - command -v emacs >/dev/null && command -v makeinfo >/dev/null && { - git submodule update --init --remote -f --recursive - HTMLDIR=$PWD/src/docs redo texidocs/htmldocs - } - - # Generate pages - genpages -} - -main "$@" diff --git a/docs/404.html b/docs/404.html deleted file mode 100644 index 821cabf..0000000 --- a/docs/404.html +++ /dev/null @@ -1,30 +0,0 @@ -<!DOCTYPE HTML> -<html lan=en> - <head> - <title>404 | Carbs Linux</title> - <link rel="stylesheet" href="/style.css"> - <meta charset="utf-8"> - <meta name="Description" content="Carbs Linux - a simple linux distribution"> - <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no"> - </head> - <body> - <p class=header><strong>Carbs Linux - a simple linux distribution</strong></p> - <div class="header"> - <nav> - <a href='/'>index</a> - <a href="//git.carbslinux.org">git</a> - <a href='//dl.carbslinux.org'>downloads</a> - <a href='/blog'>blog</a> - <a href='/docs/install.html'>installation</a> - <a href='/docs'>user manual</a> - </nav> - </div><div class="border"></div> -<h1>404</h1> - -<p>Requested page not found.</p> - <a href="/404.txt">View Page Source</a> - <div class="border"></div> - <p class=footer>Linux® is a registered trademark of Linus Torvalds</p> - <p class=footer>Copyright © 2019-2021 Cem Keylan</p> - </body> -</html> diff --git a/docs/404.txt b/docs/404.txt deleted file mode 100644 index afd5166..0000000 --- a/docs/404.txt +++ /dev/null @@ -1,3 +0,0 @@ -# 404 - -Requested page not found. diff --git a/docs/blog/20200128.html b/docs/blog/20200128.html index 5b236a8..9b37a28 100644 --- a/docs/blog/20200128.html +++ b/docs/blog/20200128.html @@ -1,47 +1,59 @@ -<!DOCTYPE HTML> -<html lan=en> - <head> - <title>Switching to New Website | Carbs Linux</title> - <link rel="stylesheet" href="/style.css"> - <meta charset="utf-8"> - <meta name="Description" content="Carbs Linux - a simple linux distribution"> - <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no"> - </head> - <body> - <p class=header><strong>Carbs Linux - a simple linux distribution</strong></p> - <div class="header"> - <nav> - <a href='/'>index</a> - <a href="//git.carbslinux.org">git</a> - <a href='//dl.carbslinux.org'>downloads</a> - <a href='/blog'>blog</a> - <a href='/docs/install.html'>installation</a> - <a href='/docs'>user manual</a> - </nav> - </div><div class="border"></div> -<h1>Switching to New Website</h1> +<!DOCTYPE html> +<html lang="en"> +<head> +<!-- 2021-02-02 --> +<meta charset="utf-8"> +<meta name="viewport" content="width=device-width, initial-scale=1"> +<title>Switching to New Website</title> +<meta name="generator" content="Org mode"> +<meta name="author" content="Cem Keylan"> +<link rel="stylesheet" type="text/css" href="/style.css"> +</head> +<body> +<div id="preamble" class="status"> +<nav id="navbar"> + <a href="/" class=navbartitle>Carbs Linux</a> -<p><strong>Date:</strong> Jan 28 2020</p> + <label for="hamburger">☰</label> + <input type="checkbox" id="hamburger" /> + <ul id=navbarlist> + <li><a href="/" title="Home Page">Home</a></li> + <li><a href="//git.carbslinux.org" title="Git Repository">Git</a></li> + <li><a href="/download.html" title="Download Carbs Linux">Download</a></li> + <li><a href="/blog" title="Blog Posts">Blog</a></li> + <li><a href="/install.html" title="Installation Instructions">Installation</a></li> + <li><a href="/docs.html" title="Documentation">Docs</a></li> + </ul> +</nav> +</div> +<div id="content"> +<header> +<h1 class="title">Switching to New Website</h1> +<p class="subtitle">posted on 2020-01-28</p> +</header><p> +In case you haven't seen it before, this website was powered by <a href="http://werc.cat-v.org">werc</a>. And even +though I liked it really much, it was too powerful for a small website like +this. +</p> -<p>In case you haven’t seen it before, this website -was powered by <a href="http://werc.cat-v.org">werc</a>. And -even though I liked it really much, it was too -powerful for a small website like this.</p> +<p> +So I have decided to reimplement this website with my own static generation +scripts. The source will probably be on <a href="https://git.carbslinux.org/website/log.html">its git repository</a> when I decide to +publish the website. +</p> -<p>So I have decided to reimplement this website with -my own static generation scripts. The source will -probably be on <a href="https://carbslinux.org/git/website/log.html">https://carbslinux.org/git/website/log.html</a> -when I decide to publish the website.</p> - -<p>The generation requires Plan9 programs, although -I have used them just for my enthusiasm. I have built -the site with a combination of mk (instead of make), rc, -and POSIX sh. I am not yet exactly familiar with rc, -but I will replace the shell scripts when I feel like -I can.</p> - <a href="/blog/20200128.txt">View Page Source</a> - <div class="border"></div> - <p class=footer>Linux® is a registered trademark of Linus Torvalds</p> - <p class=footer>Copyright © 2019-2021 Cem Keylan</p> - </body> +<p> +The generation requires Plan9 programs, although I have used them just for my +enthusiasm. I have built the site with a combination of mk (instead of make), +rc, and POSIX sh. I am not yet exactly familiar with rc, but I will replace the +shell scripts when I feel like I can. +</p> +</div> +<div id="postamble" class="status"> +<footer> + <p>Linux® is a registered trademark of Linus Torvalds</p> + <p>Copyright © 2019-2021 Cem Keylan</p> +</footer> +</div> +</body> </html> diff --git a/docs/blog/20200128.txt b/docs/blog/20200128.txt deleted file mode 100644 index 5c56b45..0000000 --- a/docs/blog/20200128.txt +++ /dev/null @@ -1,21 +0,0 @@ -Switching to New Website -======================== - -**Date:** Jan 28 2020 - -In case you haven't seen it before, this website -was powered by [werc](http://werc.cat-v.org). And -even though I liked it really much, it was too -powerful for a small website like this. - -So I have decided to reimplement this website with -my own static generation scripts. The source will -probably be on <https://carbslinux.org/git/website/log.html> -when I decide to publish the website. - -The generation requires Plan9 programs, although -I have used them just for my enthusiasm. I have built -the site with a combination of mk (instead of make), rc, -and POSIX sh. I am not yet exactly familiar with rc, -but I will replace the shell scripts when I feel like -I can. diff --git a/docs/blog/20200406.html b/docs/blog/20200406.html index 18e0021..c0f3d5a 100644 --- a/docs/blog/20200406.html +++ b/docs/blog/20200406.html @@ -1,87 +1,134 @@ -<!DOCTYPE HTML> -<html lan=en> - <head> - <title>Roadmap for Carbs | Carbs Linux</title> - <link rel="stylesheet" href="/style.css"> - <meta charset="utf-8"> - <meta name="Description" content="Carbs Linux - a simple linux distribution"> - <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no"> - </head> - <body> - <p class=header><strong>Carbs Linux - a simple linux distribution</strong></p> - <div class="header"> - <nav> - <a href='/'>index</a> - <a href="//git.carbslinux.org">git</a> - <a href='//dl.carbslinux.org'>downloads</a> - <a href='/blog'>blog</a> - <a href='/docs/install.html'>installation</a> - <a href='/docs'>user manual</a> - </nav> - </div><div class="border"></div> -<h1>Roadmap for Carbs</h1> - -<p>It has been a busy week. There are lots of changes in -direction, and more to come. I want to talk a little -about all of them.</p> - -<h2>Carbs Linux Server Going Down</h2> - -<p>It became harder to maintain and pay for the server, and I will be -shutting it down in May. I am currently in the phase of -carrying over everything to <a href="https://github.com/CarbsLinux">Github</a>. The repository and the -website is served on Github now. I have also moved the <a href="https://github.com/CarbsLinux/wiki/wiki">Wiki</a> -to Github and anyone can edit it there. There are some outdated -posts that I will be fixing around this week.</p> - -<p>I am not quite sure where to store the downloads page now. But I -will be switching that to a new source as well. (Maybe Source Forge?)</p> - -<p>I feel a little sad for switching, but serving on Github is faster, -cheaper, and hassle-free.</p> - -<h2>Forking KISS</h2> - -<p>I had a personal fork of KISS, which I enjoyed thoroughly. I didn’t -intend to make it the default when I started it, but it has matured -enough to be so. The package manager can now be found on <a href="https://github.com/CarbsLinux/kiss">this repository</a>. -See it for the added changes.</p> - -<p>This will be a change for the better, as I can develop the package -manager as it fits my views.</p> - -<h2>Small Changes on the Website</h2> - -<p>I have made some small changes on the website. The build is not dependent -on Plan9 utilities anymore. It was fun messing around with <code>rc</code> and <code>mk</code>, -but they are quite limited compared to POSIX shell.</p> - -<p>RSS feeds are finally working as intended, both for the <a href="https://carbslinux.org/news.xml">news</a> section, and -the <a href="https://carbslinux.org/rss.xml">blog</a> secion.</p> - -<p>You can see every page’s <code>.txt</code> output at the end of the page by clicking -‘View Page Source’. Meanwhile, I will be updating some pages to be a little -more ‘human-readable’.</p> - -<h2>Outsources Repository</h2> - -<p>I have opened an <code>outsource</code> repository, which I will be pushing this week. -I will add a new post when I am ready to push it. I think it will be interesting, +<!DOCTYPE html> +<html lang="en"> +<head> +<!-- 2021-02-02 --> +<meta charset="utf-8"> +<meta name="viewport" content="width=device-width, initial-scale=1"> +<title>Roadmap for Carbs</title> +<meta name="generator" content="Org mode"> +<meta name="author" content="Cem Keylan"> +<link rel="stylesheet" type="text/css" href="/style.css"> +</head> +<body> +<div id="preamble" class="status"> +<nav id="navbar"> + <a href="/" class=navbartitle>Carbs Linux</a> + + <label for="hamburger">☰</label> + <input type="checkbox" id="hamburger" /> + <ul id=navbarlist> + <li><a href="/" title="Home Page">Home</a></li> + <li><a href="//git.carbslinux.org" title="Git Repository">Git</a></li> + <li><a href="/download.html" title="Download Carbs Linux">Download</a></li> + <li><a href="/blog" title="Blog Posts">Blog</a></li> + <li><a href="/install.html" title="Installation Instructions">Installation</a></li> + <li><a href="/docs.html" title="Documentation">Docs</a></li> + </ul> +</nav> +</div> +<div id="content"> +<header> +<h1 class="title">Roadmap for Carbs</h1> +<p class="subtitle">posted on 2020-04-06</p> +</header><p> +It has been a busy week. There are lots of changes in direction, and more to +come. I want to talk a little about all of them. +</p> + +<div id="outline-container-orgb0c7d87" class="outline-2"> +<h2 id="orgb0c7d87">Carbs Linux Server Going Down</h2> +<div class="outline-text-2" id="text-orgb0c7d87"> +<p> +It became harder to maintain and pay for the server, and I will be shutting it +down in May. I am currently in the phase of carrying over everything to <a href="https://github.com/CarbsLinux">Github</a>. +The repository and the website is served on Github now. I have also moved the +<a href="https://github.com/CarbsLinux/wiki/wiki">Wiki</a> to Github and anyone can edit it there. There are some outdated posts that +I will be fixing around this week. +</p> + +<p> +I am not quite sure where to store the downloads page now. But I will be +switching that to a new source as well. (Maybe SourceHut?) +</p> + +<p> +I feel a little sad for switching, but serving on Github is faster, cheaper, and +hassle-free. +</p> +</div> +</div> + +<div id="outline-container-orgc2bcab5" class="outline-2"> +<h2 id="orgc2bcab5">Forking KISS</h2> +<div class="outline-text-2" id="text-orgc2bcab5"> +<p> +I had a personal fork of KISS, which I enjoyed thoroughly. I didn't intend to +make it the default when I started it, but it has matured enough to be so. The +package manager can now be found on <a href="https://github.com/CarbsLinux/kiss">this repository</a>. See it for the added +changes. +</p> + +<p> +This will be a change for the better, as I can develop the package manager as it +fits my views. +</p> +</div> +</div> + +<div id="outline-container-org0538658" class="outline-2"> +<h2 id="org0538658">Small Changes on the Website</h2> +<div class="outline-text-2" id="text-org0538658"> +<p> +I have made some small changes on the website. The build is not dependent on +Plan9 utilities anymore. It was fun messing around with <code>rc</code> and <code>mk</code>, but they +are quite limited compared to POSIX shell. +</p> + +<p> +RSS feeds are finally working as intended, both for the <a href="https://carbslinux.org/news.xml">news</a> section, and the +<a href="https://carbslinux.org/rss.xml">blog</a> section. +</p> + +<p> +You can see every page's <code>.txt</code> output at the end of the page by clicking 'View +Page Source'. Meanwhile, I will be updating some pages to be a little more +'human-readable'. +</p> +</div> +</div> + +<div id="outline-container-orge097249" class="outline-2"> +<h2 id="orge097249">Outsources Repository</h2> +<div class="outline-text-2" id="text-orge097249"> +<p> +I have opened an <code>outsource</code> repository, which I will be pushing this week. I +will add a new post when I am ready to push it. I think it will be interesting, it will also make more sense about the changes I have added to the package -manager. The now empty repository, can be found <a href="https://github.com/CarbsLinux/outsource">here</a>!</p> - -<h2>New Tarball</h2> - -<p>Finally, I have released a new tarball today, which can be obtained from the -<a href="https://dl.carbslinux.org/releases">downloads page</a>.</p> - -<p>I am planning to add more of these update posts as I’m feeling better about -the website structure overall.</p> - -<p>- Cem</p> - <a href="/blog/20200406.txt">View Page Source</a> - <div class="border"></div> - <p class=footer>Linux® is a registered trademark of Linus Torvalds</p> - <p class=footer>Copyright © 2019-2021 Cem Keylan</p> - </body> +manager. The now empty repository, can be found <a href="https://github.com/CarbsLinux/outsource">here</a>! +</p> +</div> +</div> + +<div id="outline-container-org80536a3" class="outline-2"> +<h2 id="org80536a3">New Tarball</h2> +<div class="outline-text-2" id="text-org80536a3"> +<p> +Finally, I have released a new tarball today, which can be obtained from the +<a href="https://dl.carbslinux.org/releases">downloads page</a>. +</p> + +<p> +I am planning to add more of these update posts as I'm feeling better about the +website structure overall. +</p> +</div> +</div> +</div> +<div id="postamble" class="status"> +<footer> + <p>Linux® is a registered trademark of Linus Torvalds</p> + <p>Copyright © 2019-2021 Cem Keylan</p> +</footer> +</div> +</body> </html> diff --git a/docs/blog/20200406.txt b/docs/blog/20200406.txt deleted file mode 100644 index c695b69..0000000 --- a/docs/blog/20200406.txt +++ /dev/null @@ -1,84 +0,0 @@ -Roadmap for Carbs -================= - -It has been a busy week. There are lots of changes in -direction, and more to come. I want to talk a little -about all of them. - - -Carbs Linux Server Going Down ------------------------------ - -It became harder to maintain and pay for the server, and I will be -shutting it down in May. I am currently in the phase of -carrying over everything to [Github]. The repository and the -website is served on Github now. I have also moved the [Wiki] -to Github and anyone can edit it there. There are some outdated -posts that I will be fixing around this week. - -I am not quite sure where to store the downloads page now. But I -will be switching that to a new source as well. (Maybe Source Forge?) - -I feel a little sad for switching, but serving on Github is faster, -cheaper, and hassle-free. - -[Github]: https://github.com/CarbsLinux -[Wiki]: https://github.com/CarbsLinux/wiki/wiki - - -Forking KISS ------------- - -I had a personal fork of KISS, which I enjoyed thoroughly. I didn't -intend to make it the default when I started it, but it has matured -enough to be so. The package manager can now be found on [this repository]. -See it for the added changes. - -This will be a change for the better, as I can develop the package -manager as it fits my views. - -[this repository]: https://github.com/CarbsLinux/kiss - - -Small Changes on the Website ----------------------------- - -I have made some small changes on the website. The build is not dependent -on Plan9 utilities anymore. It was fun messing around with `rc` and `mk`, -but they are quite limited compared to POSIX shell. - -RSS feeds are finally working as intended, both for the [news] section, and -the [blog] secion. - -You can see every page's `.txt` output at the end of the page by clicking -'View Page Source'. Meanwhile, I will be updating some pages to be a little -more 'human-readable'. - -[news]: https://carbslinux.org/news.xml -[blog]: https://carbslinux.org/rss.xml - - -Outsources Repository ---------------------- - -I have opened an `outsource` repository, which I will be pushing this week. -I will add a new post when I am ready to push it. I think it will be interesting, -it will also make more sense about the changes I have added to the package -manager. The now empty repository, can be found [here]! - -[here]: https://github.com/CarbsLinux/outsource - - -New Tarball ------------ - -Finally, I have released a new tarball today, which can be obtained from the -[downloads page]. - -[downloads page]: https://dl.carbslinux.org/releases - - -I am planning to add more of these update posts as I'm feeling better about -the website structure overall. - -\- Cem diff --git a/docs/blog/20200410.html b/docs/blog/20200410.html index 1a9e638..03578d4 100644 --- a/docs/blog/20200410.html +++ b/docs/blog/20200410.html @@ -1,50 +1,68 @@ -<!DOCTYPE HTML> -<html lan=en> - <head> - <title>Outsource Repository Concept | Carbs Linux</title> - <link rel="stylesheet" href="/style.css"> - <meta charset="utf-8"> - <meta name="Description" content="Carbs Linux - a simple linux distribution"> - <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no"> - </head> - <body> - <p class=header><strong>Carbs Linux - a simple linux distribution</strong></p> - <div class="header"> - <nav> - <a href='/'>index</a> - <a href="//git.carbslinux.org">git</a> - <a href='//dl.carbslinux.org'>downloads</a> - <a href='/blog'>blog</a> - <a href='/docs/install.html'>installation</a> - <a href='/docs'>user manual</a> - </nav> - </div><div class="border"></div> -<h1>Outsource Repository Concept</h1> +<!DOCTYPE html> +<html lang="en"> +<head> +<!-- 2021-02-02 --> +<meta charset="utf-8"> +<meta name="viewport" content="width=device-width, initial-scale=1"> +<title>Outsource Repository Concept</title> +<meta name="generator" content="Org mode"> +<meta name="author" content="Cem Keylan"> +<link rel="stylesheet" type="text/css" href="/style.css"> +</head> +<body> +<div id="preamble" class="status"> +<nav id="navbar"> + <a href="/" class=navbartitle>Carbs Linux</a> -<p>In April 3rd, I have added submodule support for Carbs -Linux’s fork of <code>kiss</code>. Now, from that sentence, it really -doesn’t sound exciting at all. But in reality, it opens a -path to lots of creative output, and a better way to manage -multi-user repositories (such as KISS Community).</p> + <label for="hamburger">☰</label> + <input type="checkbox" id="hamburger" /> + <ul id=navbarlist> + <li><a href="/" title="Home Page">Home</a></li> + <li><a href="//git.carbslinux.org" title="Git Repository">Git</a></li> + <li><a href="/download.html" title="Download Carbs Linux">Download</a></li> + <li><a href="/blog" title="Blog Posts">Blog</a></li> + <li><a href="/install.html" title="Installation Instructions">Installation</a></li> + <li><a href="/docs.html" title="Documentation">Docs</a></li> + </ul> +</nav> +</div> +<div id="content"> +<header> +<h1 class="title">Outsource Repository Concept</h1> +<p class="subtitle">posted on 2020-04-10</p> +</header><p> +In April 3rd, I have added submodule support for Carbs Linux's fork of <code>kiss</code>. +Now, from that sentence, it really doesn't sound exciting at all. But in +reality, it opens a path to lots of creative output, and a better way to manage +multi-user repositories (such as KISS Community). +</p> -<p>When managing a repository of submodules, the repository -maintainer’s only job is to deal with adding packages. -A package maintainer doesn’t have to wait for the repository -maintainer to update their packages, as they are only making -the changes to their own repositories.</p> +<p> +When managing a repository of submodules, the repository maintainer's only job +is to deal with adding packages. A package maintainer doesn't have to wait for +the repository maintainer to update their packages, as they are only making the +changes to their own repositories. +</p> -<p>This way, an end-user can also track from their preferred -maintainers, and do that with the tidyness of a single repository -in their <code>KISS_PATH</code>.</p> +<p> +This way, an end-user can also track from their preferred maintainers, and do +that with the tidyness of a single repository in their <code>KISS_PATH</code>. +</p> -<p>Carbs Linux now has an outsource repository for some packages. -Firefox and its dependencies have been purged from the main repository, -but can be found on it.</p> +<p> +Carbs Linux now has an outsource repository for some packages. Firefox and its +dependencies have been purged from the main repository, but can be found on it. +</p> -<p><a href="https://github.com/CarbsLinux/outsource">https://github.com/CarbsLinux/outsource</a></p> - <a href="/blog/20200410.txt">View Page Source</a> - <div class="border"></div> - <p class=footer>Linux® is a registered trademark of Linus Torvalds</p> - <p class=footer>Copyright © 2019-2021 Cem Keylan</p> - </body> +<p> +<a href="https://github.com/CarbsLinux/outsource">https://github.com/CarbsLinux/outsource</a> +</p> +</div> +<div id="postamble" class="status"> +<footer> + <p>Linux® is a registered trademark of Linus Torvalds</p> + <p>Copyright © 2019-2021 Cem Keylan</p> +</footer> +</div> +</body> </html> diff --git a/docs/blog/20200410.txt b/docs/blog/20200410.txt deleted file mode 100644 index f6edffe..0000000 --- a/docs/blog/20200410.txt +++ /dev/null @@ -1,24 +0,0 @@ -Outsource Repository Concept -============================ - -In April 3rd, I have added submodule support for Carbs -Linux's fork of `kiss`. Now, from that sentence, it really -doesn't sound exciting at all. But in reality, it opens a -path to lots of creative output, and a better way to manage -multi-user repositories (such as KISS Community). - -When managing a repository of submodules, the repository -maintainer's only job is to deal with adding packages. -A package maintainer doesn't have to wait for the repository -maintainer to update their packages, as they are only making -the changes to their own repositories. - -This way, an end-user can also track from their preferred -maintainers, and do that with the tidyness of a single repository -in their `KISS_PATH`. - -Carbs Linux now has an outsource repository for some packages. -Firefox and its dependencies have been purged from the main repository, -but can be found on it. - -<https://github.com/CarbsLinux/outsource> diff --git a/docs/blog/20200508.html b/docs/blog/20200508.html index e97b5ff..6bdd7ed 100644 --- a/docs/blog/20200508.html +++ b/docs/blog/20200508.html @@ -1,146 +1,184 @@ -<!DOCTYPE HTML> -<html lan=en> - <head> - <title>The Relation of Carbs and KISS | Carbs Linux</title> - <link rel="stylesheet" href="/style.css"> - <meta charset="utf-8"> - <meta name="Description" content="Carbs Linux - a simple linux distribution"> - <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no"> - </head> - <body> - <p class=header><strong>Carbs Linux - a simple linux distribution</strong></p> - <div class="header"> - <nav> - <a href='/'>index</a> - <a href="//git.carbslinux.org">git</a> - <a href='//dl.carbslinux.org'>downloads</a> - <a href='/blog'>blog</a> - <a href='/docs/install.html'>installation</a> - <a href='/docs'>user manual</a> - </nav> - </div><div class="border"></div> -<h1>The Relation of Carbs and KISS</h1> - -<p><strong>Date:</strong> May 08 2020</p> - -<p>Since I have forked KISS, I have received many questions -that can be summarized as “Why?”. I have realized that I -never truly answered this question. That’s the reason I am -writing this post, to give some background on Carbs, and -some differences between KISS Linux and Carbs Linux for -anyone who may be wondering. Perhaps I could make this a -“FAQ” page later on.</p> - -<h2>History</h2> - -<p>I had the idea of creating my own Linux distribution since -the May of 2019. Back then, I had my own <a href="https://linuxfromscratch.org">Linux from Scratch</a> -build, and I wanted to slim it down my own way and replace -the software (with musl,sbase,etc.). The name Carbs Linux -was in my mind since then. I wanted to write my own package -manager, but I wasn’t satisfied with anything I had built.</p> - -<p>I had written some incomplete package managers (all named <code>fat</code>) -and I quickly threw them into the trash can, where they -honestly belonged. I would want to share them with you for -laughs, but my hard-drive got wiped and I have a problem -of not doing an “initial commit” until a program I write -is in a usable state.</p> - -<p>I have obtained the ‘carbslinux.org’ domain name in September -2019, but then life got on the way, and I stopped for a long -time.</p> - -<p>One day on Reddit, I saw Dylan’s post on <a href="https://reddit.com/r/unixporn">r/unixporn</a> about -KISS, and I really thought that it was interesting. Here is -my <a href="https://www.reddit.com/r/unixporn/comments/ducd34/sowm_kiss_d/f7lua7x">comment</a> to Dylan on that post. I checked out the package -manager and the repository. The packaging system was extremely -clean and well-thought. I decided to give it a go and fork -KISS.</p> - -<h2>Differences between KISS and Carbs</h2> - -<p>Now, I still baffle when people ask me this question. My -intention was never to create a distribution with specific -differences between KISS. My intention was being my own -BDFL of a distribution I maintain. There are lots of -differences between the main repositories, but they are subtle -and not worth talking about. I personally never even installed -KISS Linux on my system. So Carbs, isn’t something like a -downstream fork of KISS, it is just a distribution that was -initially based on KISS.</p> - -<p>I try to contribute as much as I can to KISS Linux. I think -that it is a brilliant distribution, and it was a great starting -point for Carbs. I am really grateful to Dylan and all the -other contributors.</p> - -<h2>What I’m working on now</h2> - -<p>Currently I have a few projects that I’m working on for Carbs. -These are,</p> - -<p>A BSD port for Carbs. For a while, I have been working on BSD -compatibility on my fork of the <a href="https://github.com/carbslinux/kiss">package manager</a>. I have tested, -without any more issues, on OpenBSD and FreeBSD. The biggest -issues remaining are choosing a vendor for BSD, packaging the -BSD source, and providing a minimal base (like busybox for BSD). -If you aren’t familiar with BSD, it has a single source code -for all of the utilities (kernel, command line programs, etc.). -Contributions (even chipping in ideas) are very welcome.</p> - -<p>Adding binary package distribution support natively to the package -manager. Biggest issue in small/old computers are compile times. -This feature is for the bigger packages such as webkit, clang, -llvm that take a considerable amount of time. Some computers -with low memories cannot even compile firefox/webkit.</p> - -<p>Adding rsync repository support to the package manager. This -is not a current issue, but rather a futureproofing. As time -passes, distribution repositories grow larger. KISS and Carbs -are young distributions without this problem right now. But -in something like 5 years, this size will presumably increase -to hundreds of megabytes. At that point it will be pointless -to have the repository sources unless you specifically need them.</p> - -<h2>What’s up with all the init/service daemons?</h2> - -<p>If you have ever checked the <a href="https://github.com/carbslinux/repository">repository</a>, you may have noticed -that there are lots of init/service related packages. I have had -my fair share of time with all of them, and it is an area that I -am really interested in. I have even written my own <a href="https://github.com/cemkeylan/shinit">init daemon</a> -and <a href="https://github.com/cemkeylan/sysmgr">service supervisor</a>. I maintain all those packages on KISS -Community Repository as well with the exception of busybox. Those -are, <code>busybox init/runit</code>, <code>runit</code>, <code>sinit</code>, and <code>sysmgr</code>. I would -definitely recommend checking out <code>shinit</code> and <code>sysmgr</code>.</p> - -<h2>Why I don’t publicize Carbs</h2> - -<p>There are a couple of reasons I don’t publicize Carbs a lot.</p> - -<p>KISS is the better alternative in terms of support and community. -I work on maintaining this distribution just as hard as Dylan, -but in the end, Carbs is based on his original hard work, and I -believe that he deserves the recognition more than I do.</p> - -<p>Since I cannot answer questions like “What is the difference?”, I -prefer staying as the silent sibling project of KISS Linux. Plus, -there is no point in dividing the newly-emerging community in half.</p> - -<p>That’s not because I don’t have ideas for the future of Carbs, I -do. I just think that I will deserve the recognition once those -above lists are checked.</p> - -<p>I think that’s about it, if you have questions you can send me a -mail, ping me on IRC (my handle is <code>merakor</code>), and I will be happy -to answer. Maybe your question fits this post, and I can update it -to thoroughly give an explanation.</p> - -<p>Cheers, -Cem</p> - <a href="/blog/20200508.txt">View Page Source</a> - <div class="border"></div> - <p class=footer>Linux® is a registered trademark of Linus Torvalds</p> - <p class=footer>Copyright © 2019-2021 Cem Keylan</p> - </body> +<!DOCTYPE html> +<html lang="en"> +<head> +<!-- 2021-02-02 --> +<meta charset="utf-8"> +<meta name="viewport" content="width=device-width, initial-scale=1"> +<title>The Relation of Carbs and KISS</title> +<meta name="generator" content="Org mode"> +<meta name="author" content="Cem Keylan"> +<link rel="stylesheet" type="text/css" href="/style.css"> +</head> +<body> +<div id="preamble" class="status"> +<nav id="navbar"> + <a href="/" class=navbartitle>Carbs Linux</a> + + <label for="hamburger">☰</label> + <input type="checkbox" id="hamburger" /> + <ul id=navbarlist> + <li><a href="/" title="Home Page">Home</a></li> + <li><a href="//git.carbslinux.org" title="Git Repository">Git</a></li> + <li><a href="/download.html" title="Download Carbs Linux">Download</a></li> + <li><a href="/blog" title="Blog Posts">Blog</a></li> + <li><a href="/install.html" title="Installation Instructions">Installation</a></li> + <li><a href="/docs.html" title="Documentation">Docs</a></li> + </ul> +</nav> +</div> +<div id="content"> +<header> +<h1 class="title">The Relation of Carbs and KISS</h1> +<p class="subtitle">posted on 2020-05-08</p> +</header><p> +Since I have forked KISS, I have received many questions that can be summarized +as "Why?". I have realized that I never truly answered this question. That's the +reason I am writing this post, to give some background on Carbs, and some +differences between KISS Linux and Carbs Linux for anyone who may be wondering. +Perhaps I could make this a "FAQ" page later on. +</p> + +<div id="outline-container-org1398b0e" class="outline-2"> +<h2 id="org1398b0e">History</h2> +<div class="outline-text-2" id="text-org1398b0e"> +<p> +I had the idea of creating my own Linux distribution since the May of 2019. Back +then, I had my own <a href="https://linuxfromscratch.org">Linux from Scratch</a> build, and I wanted to slim it down my +own way and replace the software (with musl,sbase,etc.). The name Carbs Linux +was in my mind since then. I wanted to write my own package manager, but I +wasn't satisfied with anything I had built. +</p> + +<p> +I had written some incomplete package managers (all named <code>fat</code>) and I quickly +threw them into the trash can, where they honestly belonged. I would want to +share them with you for laughs, but my hard-drive got wiped and I have a problem +of not doing an "initial commit" until a program I write is in a usable state. +</p> + +<p> +I have obtained the 'carbslinux.org' domain name in September 2019, but then +life got on the way, and I stopped for a long time. +</p> + +<p> +One day on Reddit, I saw Dylan's post on <a href="https://reddit.com/r/unixporn">r/unixporn</a> about KISS, and I really +thought that it was interesting. Here is my <a href="https://www.reddit.com/r/unixporn/comments/ducd34/sowm_kiss_d/f7lua7x">comment</a> to Dylan on that post. I +checked out the package manager and the repository. The packaging system was +extremely clean and well-thought. I decided to give it a go and fork KISS. +</p> +</div> +</div> + +<div id="outline-container-org5bd8596" class="outline-2"> +<h2 id="org5bd8596">Differences between KISS and Carbs</h2> +<div class="outline-text-2" id="text-org5bd8596"> +<p> +Now, I still baffle when people ask me this question. My intention was never to +create a distribution with specific differences between KISS. My intention was +being my own BDFL of a distribution I maintain. There are lots of differences +between the main repositories, but they are subtle and not worth talking about. +I personally never even installed KISS Linux on my system. So Carbs, isn't +something like a downstream fork of KISS, it is just a distribution that was +initially based on KISS. +</p> + +<p> +I try to contribute as much as I can to KISS Linux. I think that it is a +brilliant distribution, and it was a great starting point for Carbs. I am really +grateful to Dylan and all the other contributors. +</p> +</div> +</div> + +<div id="outline-container-orgbc60244" class="outline-2"> +<h2 id="orgbc60244">What I'm working on now</h2> +<div class="outline-text-2" id="text-orgbc60244"> +<p> +Currently I have a few projects that I'm working on for Carbs. These are, +</p> + +<p> +A BSD port for Carbs. For a while, I have been working on BSD compatibility on +my fork of the [package manager]. I have tested, without any more issues, on +OpenBSD and FreeBSD. The biggest issues remaining are choosing a vendor for BSD, +packaging the BSD source, and providing a minimal base (like busybox for BSD). +If you aren't familiar with BSD, it has a single source code for all of the +utilities (kernel, command line programs, etc.). Contributions (even chipping in +ideas) are very welcome. +</p> + +<p> +Adding binary package distribution support natively to the package manager. +Biggest issue in small/old computers are compile times. This feature is for the +bigger packages such as webkit, clang, llvm that take a considerable amount of +time. Some computers with low memories cannot even compile firefox/webkit. +</p> + +<p> +Adding rsync repository support to the package manager. This is not a current +issue, but rather a futureproofing. As time passes, distribution repositories +grow larger. KISS and Carbs are young distributions without this problem right +now. But in something like 5 years, this size will presumably increase to +hundreds of megabytes. At that point it will be pointless to have the repository +sources unless you specifically need them. +</p> +</div> +</div> + +<div id="outline-container-org6b82fb9" class="outline-2"> +<h2 id="org6b82fb9">What's up with all the init/service daemons?</h2> +<div class="outline-text-2" id="text-org6b82fb9"> +<p> +If you have ever checked the <a href="https://github.com/carbslinux/repository">repository</a>, you may have noticed that there are +lots of init/service related packages. I have had my fair share of time with all +of them, and it is an area that I am really interested in. I have even written +my own <a href="https://github.com/cemkeylan/shinit">init daemon</a> and <a href="https://github.com/cemkeylan/sysmgr">service supervisor</a>. I maintain all those packages on KISS +Community Repository as well with the exception of busybox. Those are, <code>busybox +init/runit</code>, <code>runit</code>, <code>sinit</code>, and <code>sysmgr</code>. I would definitely recommend +checking out <code>shinit</code> and <code>sysmgr</code>. +</p> +</div> +</div> + +<div id="outline-container-orga3d4bff" class="outline-2"> +<h2 id="orga3d4bff">Why I don't publicize Carbs</h2> +<div class="outline-text-2" id="text-orga3d4bff"> +<p> +There are a couple of reasons I don't publicize Carbs a lot. +</p> + +<p> +KISS is the better alternative in terms of support and community. I work on +maintaining this distribution just as hard as Dylan, but in the end, Carbs is +based on his original hard work, and I believe that he deserves the recognition +more than I do. +</p> + +<p> +Since I cannot answer questions like "What is the difference?", I prefer staying +as the silent sibling project of KISS Linux. Plus, there is no point in dividing +the newly-emerging community in half. +</p> + +<p> +That's not because I don't have ideas for the future of Carbs, I do. I just +think that I will deserve the recognition once those above lists are checked. +</p> + +<p> +I think that's about it, if you have questions you can send me a mail, ping me +on IRC (my handle is <code>merakor</code>), and I will be happy to answer. Maybe your +question fits this post, and I can update it to thoroughly give an explanation. +</p> +</div> +</div> +</div> +<div id="postamble" class="status"> +<footer> + <p>Linux® is a registered trademark of Linus Torvalds</p> + <p>Copyright © 2019-2021 Cem Keylan</p> +</footer> +</div> +</body> </html> diff --git a/docs/blog/20200508.txt b/docs/blog/20200508.txt deleted file mode 100644 index f1b2cdd..0000000 --- a/docs/blog/20200508.txt +++ /dev/null @@ -1,141 +0,0 @@ -The Relation of Carbs and KISS -============================== - -**Date:** May 08 2020 - -Since I have forked KISS, I have received many questions -that can be summarized as "Why?". I have realized that I -never truly answered this question. That's the reason I am -writing this post, to give some background on Carbs, and -some differences between KISS Linux and Carbs Linux for -anyone who may be wondering. Perhaps I could make this a -"FAQ" page later on. - -History -------- - -I had the idea of creating my own Linux distribution since -the May of 2019. Back then, I had my own [Linux from Scratch] -build, and I wanted to slim it down my own way and replace -the software (with musl,sbase,etc.). The name Carbs Linux -was in my mind since then. I wanted to write my own package -manager, but I wasn't satisfied with anything I had built. - -I had written some incomplete package managers (all named `fat`) -and I quickly threw them into the trash can, where they -honestly belonged. I would want to share them with you for -laughs, but my hard-drive got wiped and I have a problem -of not doing an "initial commit" until a program I write -is in a usable state. - -I have obtained the 'carbslinux.org' domain name in September -2019, but then life got on the way, and I stopped for a long -time. - -One day on Reddit, I saw Dylan's post on [r/unixporn] about -KISS, and I really thought that it was interesting. Here is -my [comment] to Dylan on that post. I checked out the package -manager and the repository. The packaging system was extremely -clean and well-thought. I decided to give it a go and fork -KISS. - -[Linux from Scratch]: https://linuxfromscratch.org -[r/unixporn]: https://reddit.com/r/unixporn -[comment]: https://www.reddit.com/r/unixporn/comments/ducd34/sowm_kiss_d/f7lua7x - - -Differences between KISS and Carbs ----------------------------------- - -Now, I still baffle when people ask me this question. My -intention was never to create a distribution with specific -differences between KISS. My intention was being my own -BDFL of a distribution I maintain. There are lots of -differences between the main repositories, but they are subtle -and not worth talking about. I personally never even installed -KISS Linux on my system. So Carbs, isn't something like a -downstream fork of KISS, it is just a distribution that was -initially based on KISS. - -I try to contribute as much as I can to KISS Linux. I think -that it is a brilliant distribution, and it was a great starting -point for Carbs. I am really grateful to Dylan and all the -other contributors. - - -What I'm working on now ------------------------ - -Currently I have a few projects that I'm working on for Carbs. -These are, - -A BSD port for Carbs. For a while, I have been working on BSD -compatibility on my fork of the [package manager]. I have tested, -without any more issues, on OpenBSD and FreeBSD. The biggest -issues remaining are choosing a vendor for BSD, packaging the -BSD source, and providing a minimal base (like busybox for BSD). -If you aren't familiar with BSD, it has a single source code -for all of the utilities (kernel, command line programs, etc.). -Contributions (even chipping in ideas) are very welcome. - -Adding binary package distribution support natively to the package -manager. Biggest issue in small/old computers are compile times. -This feature is for the bigger packages such as webkit, clang, -llvm that take a considerable amount of time. Some computers -with low memories cannot even compile firefox/webkit. - -Adding rsync repository support to the package manager. This -is not a current issue, but rather a futureproofing. As time -passes, distribution repositories grow larger. KISS and Carbs -are young distributions without this problem right now. But -in something like 5 years, this size will presumably increase -to hundreds of megabytes. At that point it will be pointless -to have the repository sources unless you specifically need them. - - -[package manager]: https://github.com/carbslinux/kiss - - -What's up with all the init/service daemons? --------------------------------------------- - -If you have ever checked the [repository], you may have noticed -that there are lots of init/service related packages. I have had -my fair share of time with all of them, and it is an area that I -am really interested in. I have even written my own [init daemon] -and [service supervisor]. I maintain all those packages on KISS -Community Repository as well with the exception of busybox. Those -are, `busybox init/runit`, `runit`, `sinit`, and `sysmgr`. I would -definitely recommend checking out `shinit` and `sysmgr`. - -[repository]: https://github.com/carbslinux/repository -[init daemon]: https://github.com/cemkeylan/shinit -[service supervisor]: https://github.com/cemkeylan/sysmgr - - -Why I don't publicize Carbs ---------------------------- - -There are a couple of reasons I don't publicize Carbs a lot. - -KISS is the better alternative in terms of support and community. -I work on maintaining this distribution just as hard as Dylan, -but in the end, Carbs is based on his original hard work, and I -believe that he deserves the recognition more than I do. - -Since I cannot answer questions like "What is the difference?", I -prefer staying as the silent sibling project of KISS Linux. Plus, -there is no point in dividing the newly-emerging community in half. - -That's not because I don't have ideas for the future of Carbs, I -do. I just think that I will deserve the recognition once those -above lists are checked. - - -I think that's about it, if you have questions you can send me a -mail, ping me on IRC (my handle is `merakor`), and I will be happy -to answer. Maybe your question fits this post, and I can update it -to thoroughly give an explanation. - -Cheers, -Cem diff --git a/docs/blog/20200528.html b/docs/blog/20200528.html index 0685a87..119a7ea 100644 --- a/docs/blog/20200528.html +++ b/docs/blog/20200528.html @@ -1,70 +1,91 @@ -<!DOCTYPE HTML> -<html lan=en> - <head> - <title>kiss 2.0.0 and overall changes | Carbs Linux</title> - <link rel="stylesheet" href="/style.css"> - <meta charset="utf-8"> - <meta name="Description" content="Carbs Linux - a simple linux distribution"> - <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no"> - </head> - <body> - <p class=header><strong>Carbs Linux - a simple linux distribution</strong></p> - <div class="header"> - <nav> - <a href='/'>index</a> - <a href="//git.carbslinux.org">git</a> - <a href='//dl.carbslinux.org'>downloads</a> - <a href='/blog'>blog</a> - <a href='/docs/install.html'>installation</a> - <a href='/docs'>user manual</a> - </nav> - </div><div class="border"></div> -<h1>kiss 2.0.0 and overall changes</h1> +<!DOCTYPE html> +<html lang="en"> +<head> +<!-- 2021-02-02 --> +<meta charset="utf-8"> +<meta name="viewport" content="width=device-width, initial-scale=1"> +<title>kiss 2.0.0 and Overall Changes</title> +<meta name="generator" content="Org mode"> +<meta name="author" content="Cem Keylan"> +<link rel="stylesheet" type="text/css" href="/style.css"> +</head> +<body> +<div id="preamble" class="status"> +<nav id="navbar"> + <a href="/" class=navbartitle>Carbs Linux</a> -<p>Carbs Linux kiss version 2.0.0 has been released which introduces -rsync repositories.</p> + <label for="hamburger">☰</label> + <input type="checkbox" id="hamburger" /> + <ul id=navbarlist> + <li><a href="/" title="Home Page">Home</a></li> + <li><a href="//git.carbslinux.org" title="Git Repository">Git</a></li> + <li><a href="/download.html" title="Download Carbs Linux">Download</a></li> + <li><a href="/blog" title="Blog Posts">Blog</a></li> + <li><a href="/install.html" title="Installation Instructions">Installation</a></li> + <li><a href="/docs.html" title="Documentation">Docs</a></li> + </ul> +</nav> +</div> +<div id="content"> +<header> +<h1 class="title">kiss 2.0.0 and Overall Changes</h1> +<p class="subtitle">posted on 2020-05-28</p> +</header><p> +Carbs Linux kiss version 2.0.0 has been released which introduces rsync +repositories. +</p> -<p>Git is no longer a mandatory dependency for the package manager, -every git source on the core repository has been replaced with -https sources (sbase, sinit), and rootfs tarballs will no longer -ship with git. Repositories in the upcoming tarball will be rsync -repositories.</p> +<p> +Git is no longer a mandatory dependency for the package manager, every git +source on the core repository has been replaced with https sources (sbase, +sinit), and rootfs tarballs will no longer ship with git. Repositories in the +upcoming tarball will be rsync repositories. +</p> -<p>Git is now on the <code>extra</code> repository and is still (optionally) -used in the package manager.</p> +<p> +Git is now on the <code>extra</code> repository and is still (optionally) used in the +package manager. +</p> -<p>The idea behind this change is size reductions and increased -speed with rsync. As I said on the previous post, git repositories -get larger and larger over the time span. Currently my personal -copy of the git repository is around 77MB and I have forked KISS -Linux (as a shallow copy) around December. Obviously, I have commits -that I ommitted. I tend to create commits I dislike, which I change -with ‘git reset –soft HEAD^’, which doesn’t actually remove the -commits, etc. A user will have a repository much smaller than mine.</p> +<p> +The idea behind this change is size reductions and increased speed with rsync. +As I said on the previous post, git repositories get larger and larger over the +time span. Currently my personal copy of the git repository is around 77MB and I +have forked KISS Linux (as a shallow copy) around December. Obviously, I have +commits that I ommitted. I tend to create commits I dislike, which I change with +<code>git reset --soft HEAD^</code>, which doesn't actually remove the commits, etc. A user +will have a repository much smaller than mine. +</p> -<p>This is a precaution with the added bonuses of speed and dropping a -mandatory dependency.</p> +<p> +This is a precaution with the added bonuses of speed and dropping a mandatory +dependency. +</p> -<p>You can see the rest of the changelog <a href="https://github.com/CarbsLinux/kiss/blob/master/CHANGELOG.md">here</a>.</p> +<p> +You can see the rest of the changelog <a href="https://github.com/CarbsLinux/kiss/blob/master/CHANGELOG.md">here</a>. +</p> -<h2>Binary Repositories</h2> - -<p>A few days ago, I have also published <a href="https://github.com/CarbsLinux/kiss-bin">kiss-bin</a>, a first version -for managing binary repositories. Currently, there are some caveats -that I’ll be fixing along the way. I decided not to include this -in the package manager natively as managing the source based and -binary based packages together adds levels of complexity that we -do not want. Instead, this is an extension for kiss which sources -the package manager as a library. I hope to see it being adopted -by others interested on the matter as well.</p> - -<p>That’s about it.</p> - -<p>Cheers, -Cem</p> - <a href="/blog/20200528.txt">View Page Source</a> - <div class="border"></div> - <p class=footer>Linux® is a registered trademark of Linus Torvalds</p> - <p class=footer>Copyright © 2019-2021 Cem Keylan</p> - </body> +<div id="outline-container-orgf930250" class="outline-2"> +<h2 id="orgf930250">Binary Repositories</h2> +<div class="outline-text-2" id="text-orgf930250"> +<p> +A few days ago, I have also published <a href="https://github.com/CarbsLinux/kiss-bin">kiss-bin</a>, a first version for managing +binary repositories. Currently, there are some caveats that I'll be fixing along +the way. I decided not to include this in the package manager natively as +managing the source based and binary based packages together adds levels of +complexity that we do not want. Instead, this is an extension for kiss which +sources the package manager as a library. I hope to see it being adopted by +others interested on the matter as well. +</p> +</div> +</div> +</div> +<div id="postamble" class="status"> +<footer> + <p>Linux® is a registered trademark of Linus Torvalds</p> + <p>Copyright © 2019-2021 Cem Keylan</p> +</footer> +</div> +</body> </html> diff --git a/docs/blog/20200528.txt b/docs/blog/20200528.txt deleted file mode 100644 index 9ceaec5..0000000 --- a/docs/blog/20200528.txt +++ /dev/null @@ -1,51 +0,0 @@ -kiss 2.0.0 and overall changes -==================================================================== - -Carbs Linux kiss version 2.0.0 has been released which introduces -rsync repositories. - -Git is no longer a mandatory dependency for the package manager, -every git source on the core repository has been replaced with -https sources (sbase, sinit), and rootfs tarballs will no longer -ship with git. Repositories in the upcoming tarball will be rsync -repositories. - -Git is now on the `extra` repository and is still (optionally) -used in the package manager. - -The idea behind this change is size reductions and increased -speed with rsync. As I said on the previous post, git repositories -get larger and larger over the time span. Currently my personal -copy of the git repository is around 77MB and I have forked KISS -Linux (as a shallow copy) around December. Obviously, I have commits -that I ommitted. I tend to create commits I dislike, which I change -with 'git reset --soft HEAD^', which doesn't actually remove the -commits, etc. A user will have a repository much smaller than mine. - -This is a precaution with the added bonuses of speed and dropping a -mandatory dependency. - -You can see the rest of the changelog [here]. - -[here]: https://github.com/CarbsLinux/kiss/blob/master/CHANGELOG.md - - -Binary Repositories -------------------- - -A few days ago, I have also published [kiss-bin], a first version -for managing binary repositories. Currently, there are some caveats -that I'll be fixing along the way. I decided not to include this -in the package manager natively as managing the source based and -binary based packages together adds levels of complexity that we -do not want. Instead, this is an extension for kiss which sources -the package manager as a library. I hope to see it being adopted -by others interested on the matter as well. - - -[kiss-bin]: https://github.com/CarbsLinux/kiss-bin - -That's about it. - -Cheers, -Cem diff --git a/docs/blog/20200617.html b/docs/blog/20200617.html index 8675dae..4373b0e 100644 --- a/docs/blog/20200617.html +++ b/docs/blog/20200617.html @@ -1,54 +1,79 @@ -<!DOCTYPE HTML> -<html lan=en> - <head> - <title>June Newspost | Carbs Linux</title> - <link rel="stylesheet" href="/style.css"> - <meta charset="utf-8"> - <meta name="Description" content="Carbs Linux - a simple linux distribution"> - <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no"> - </head> - <body> - <p class=header><strong>Carbs Linux - a simple linux distribution</strong></p> - <div class="header"> - <nav> - <a href='/'>index</a> - <a href="//git.carbslinux.org">git</a> - <a href='//dl.carbslinux.org'>downloads</a> - <a href='/blog'>blog</a> - <a href='/docs/install.html'>installation</a> - <a href='/docs'>user manual</a> - </nav> - </div><div class="border"></div> -<h1>June Newspost</h1> - -<p>This will be an active month for Carbs as major changes to the base and the -package manager will be coming up.</p> - -<h2>Statically linking the base</h2> - -<p>For the past couple of weeks I have been trying to simplify the base and +<!DOCTYPE html> +<html lang="en"> +<head> +<!-- 2021-02-02 --> +<meta charset="utf-8"> +<meta name="viewport" content="width=device-width, initial-scale=1"> +<title>June Newspost</title> +<meta name="generator" content="Org mode"> +<meta name="author" content="Cem Keylan"> +<link rel="stylesheet" type="text/css" href="/style.css"> +</head> +<body> +<div id="preamble" class="status"> +<nav id="navbar"> + <a href="/" class=navbartitle>Carbs Linux</a> + + <label for="hamburger">☰</label> + <input type="checkbox" id="hamburger" /> + <ul id=navbarlist> + <li><a href="/" title="Home Page">Home</a></li> + <li><a href="//git.carbslinux.org" title="Git Repository">Git</a></li> + <li><a href="/download.html" title="Download Carbs Linux">Download</a></li> + <li><a href="/blog" title="Blog Posts">Blog</a></li> + <li><a href="/install.html" title="Installation Instructions">Installation</a></li> + <li><a href="/docs.html" title="Documentation">Docs</a></li> + </ul> +</nav> +</div> +<div id="content"> +<header> +<h1 class="title">June Newspost</h1> +<p class="subtitle">posted on 2020-06-17</p> +</header><p> +This will be an active month for Carbs as major changes to the base and the +package manager will be coming up. +</p> + +<div id="outline-container-orgd9a62b0" class="outline-2"> +<h2 id="orgd9a62b0">Statically linking the base</h2> +<div class="outline-text-2" id="text-orgd9a62b0"> +<p> +For the past couple of weeks I have been trying to simplify the base and statically link the core (mostly binaries rather than libraries). I usually see some people extremely opposed to static linking as I also see the opposite on -people.</p> +people. +</p> -<p>I believe that binaries on the core should always be linked statically. This +<p> +I believe that binaries on the core should always be linked statically. This ensures that an SONAME bump to <code>libObscure.so</code> will not break the core functionality of your system, forcing you to use external resources to recover from such an issue. As long as you can compile, use core utilities, edit text, -and access the web, you can solve any given issue on your system.</p> +and access the web, you can solve any given issue on your system. +</p> -<p>However, I don’t think that removing shared libraries is sensible either. Not +<p> +However, I don't think that removing shared libraries is sensible either. Not every piece of software out there is good quality enough to be statically -linked.</p> - -<h2>Major changes on the core repository</h2> - -<p>There have been drastic changes to the core repository and the base rootfs this -month (with more on the way). Right now changes are as follows.</p> - -<h3>Removed from Core</h3> - -<ul> +linked. +</p> +</div> +</div> + +<div id="outline-container-org7d258a1" class="outline-2"> +<h2 id="org7d258a1">Major changes on the core repository</h2> +<div class="outline-text-2" id="text-org7d258a1"> +<p> +There have been drastic changes to the core repository and the base rootfs this +month (with more on the way). Right now changes are as follows. +</p> +</div> + +<div id="outline-container-org3699ead" class="outline-3"> +<h3 id="org3699ead">Removed from Core</h3> +<div class="outline-text-3" id="text-org3699ead"> +<ul class="org-ul"> <li><code>git</code></li> <li><code>libressl</code></li> <li><code>grub</code></li> @@ -56,19 +81,23 @@ month (with more on the way). Right now changes are as follows.</p> <li><code>dhcpcd</code></li> <li><code>ubase</code></li> </ul> +</div> +</div> - -<h3>Added to Core</h3> - -<ul> +<div id="outline-container-orgad37b63" class="outline-3"> +<h3 id="orgad37b63">Added to Core</h3> +<div class="outline-text-3" id="text-orgad37b63"> +<ul class="org-ul"> <li><code>bearssl</code>, as a <code>libressl</code> replacement</li> <li><code>byacc</code>, as a <code>bison</code> replacement</li> </ul> +</div> +</div> - -<h3>Statically linked</h3> - -<ul> +<div id="outline-container-org083d57e" class="outline-3"> +<h3 id="org083d57e">Statically linked</h3> +<div class="outline-text-3" id="text-org083d57e"> +<ul class="org-ul"> <li><code>kiss</code></li> <li><code>neatvi</code></li> <li><code>mandoc</code></li> @@ -82,23 +111,38 @@ month (with more on the way). Right now changes are as follows.</p> <li><code>wpa_supplicant</code></li> <li><code>bearssl</code></li> </ul> - - -<h2>Making the wiki available offline</h2> - -<p>Soon, all documentation regarding Carbs Linux will be avaialable to be installed +</div> +</div> +</div> + +<div id="outline-container-org3d53c84" class="outline-2"> +<h2 id="org3d53c84">Making the wiki available offline</h2> +<div class="outline-text-2" id="text-org3d53c84"> +<p> +Soon, all documentation regarding Carbs Linux will be avaialable to be installed from the core repository in a <code>carbs-docs</code> package along with its own document crawler. Currently, the documentation regarding the installation process is a -little outdated which will also receive some important updates.</p> - -<h2>ISO image for Carbs</h2> - -<p>I am thinking of releasing an ISO image in order to provide a standardized +little outdated which will also receive some important updates. +</p> +</div> +</div> + +<div id="outline-container-org248e532" class="outline-2"> +<h2 id="org248e532">ISO image for Carbs</h2> +<div class="outline-text-2" id="text-org248e532"> +<p> +I am thinking of releasing an ISO image in order to provide a standardized environment for installation along with installation helper tools in the spirit -of <code>arch-install-scripts</code>. Let’s see how that’s going to play out.</p> - <a href="/blog/20200617.txt">View Page Source</a> - <div class="border"></div> - <p class=footer>Linux® is a registered trademark of Linus Torvalds</p> - <p class=footer>Copyright © 2019-2021 Cem Keylan</p> - </body> +of <code>arch-install-scripts</code>. Let's see how that's going to play out. +</p> +</div> +</div> +</div> +<div id="postamble" class="status"> +<footer> + <p>Linux® is a registered trademark of Linus Torvalds</p> + <p>Copyright © 2019-2021 Cem Keylan</p> +</footer> +</div> +</body> </html> diff --git a/docs/blog/20200617.txt b/docs/blog/20200617.txt deleted file mode 100644 index 9938896..0000000 --- a/docs/blog/20200617.txt +++ /dev/null @@ -1,74 +0,0 @@ -June Newspost -================================================================================ - -This will be an active month for Carbs as major changes to the base and the -package manager will be coming up. - - -Statically linking the base --------------------------------------------------------------------------------- - -For the past couple of weeks I have been trying to simplify the base and -statically link the core (mostly binaries rather than libraries). I usually see -some people extremely opposed to static linking as I also see the opposite on -people. - -I believe that binaries on the core should always be linked statically. This -ensures that an SONAME bump to `libObscure.so` will not break the core -functionality of your system, forcing you to use external resources to recover -from such an issue. As long as you can compile, use core utilities, edit text, -and access the web, you can solve any given issue on your system. - -However, I don't think that removing shared libraries is sensible either. Not -every piece of software out there is good quality enough to be statically -linked. - - -Major changes on the core repository --------------------------------------------------------------------------------- - -There have been drastic changes to the core repository and the base rootfs this -month (with more on the way). Right now changes are as follows. - -### Removed from Core -- `git` -- `libressl` -- `grub` -- `bison` -- `dhcpcd` -- `ubase` - -### Added to Core -- `bearssl`, as a `libressl` replacement -- `byacc`, as a `bison` replacement - -### Statically linked -- `kiss` -- `neatvi` -- `mandoc` -- `byacc` -- `m4` -- `e2fsprogs` -- `make` -- `pkgconf` -- `sbase` -- `libnl` -- `wpa_supplicant` -- `bearssl` - - -Making the wiki available offline --------------------------------------------------------------------------------- - -Soon, all documentation regarding Carbs Linux will be avaialable to be installed -from the core repository in a `carbs-docs` package along with its own document -crawler. Currently, the documentation regarding the installation process is a -little outdated which will also receive some important updates. - - -ISO image for Carbs --------------------------------------------------------------------------------- - -I am thinking of releasing an ISO image in order to provide a standardized -environment for installation along with installation helper tools in the spirit -of `arch-install-scripts`. Let's see how that's going to play out. diff --git a/docs/blog/20200803.html b/docs/blog/20200803.html index e715a06..d62214b 100644 --- a/docs/blog/20200803.html +++ b/docs/blog/20200803.html @@ -1,105 +1,133 @@ -<!DOCTYPE HTML> -<html lan=en> - <head> - <title>August 2020 News Post | Carbs Linux</title> - <link rel="stylesheet" href="/style.css"> - <meta charset="utf-8"> - <meta name="Description" content="Carbs Linux - a simple linux distribution"> - <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no"> - </head> - <body> - <p class=header><strong>Carbs Linux - a simple linux distribution</strong></p> - <div class="header"> - <nav> - <a href='/'>index</a> - <a href="//git.carbslinux.org">git</a> - <a href='//dl.carbslinux.org'>downloads</a> - <a href='/blog'>blog</a> - <a href='/docs/install.html'>installation</a> - <a href='/docs'>user manual</a> - </nav> - </div><div class="border"></div> -<h1>August 2020 News Post</h1> - -<p>We are having some stalls during this summer, as I am currently working on +<!DOCTYPE html> +<html lang="en"> +<head> +<!-- 2021-02-02 --> +<meta charset="utf-8"> +<meta name="viewport" content="width=device-width, initial-scale=1"> +<title>August 2020 News Post</title> +<meta name="generator" content="Org mode"> +<meta name="author" content="Cem Keylan"> +<link rel="stylesheet" type="text/css" href="/style.css"> +</head> +<body> +<div id="preamble" class="status"> +<nav id="navbar"> + <a href="/" class=navbartitle>Carbs Linux</a> + + <label for="hamburger">☰</label> + <input type="checkbox" id="hamburger" /> + <ul id=navbarlist> + <li><a href="/" title="Home Page">Home</a></li> + <li><a href="//git.carbslinux.org" title="Git Repository">Git</a></li> + <li><a href="/download.html" title="Download Carbs Linux">Download</a></li> + <li><a href="/blog" title="Blog Posts">Blog</a></li> + <li><a href="/install.html" title="Installation Instructions">Installation</a></li> + <li><a href="/docs.html" title="Documentation">Docs</a></li> + </ul> +</nav> +</div> +<div id="content"> +<header> +<h1 class="title">August 2020 News Post</h1> +<p class="subtitle">posted on 2020-08-03</p> +</header><p> +We are having some stalls during this summer, as I am currently working on university-related stuff. Nonetheless, there are some important changes that I -want to share in this month’s post.</p> - -<h2>INDEX</h2> +want to share in this month's post. +</p> +<div id="text-table-of-contents"> <ul> -<li><a href="#carbs-packaging-tools">Carbs Packaging Tools</a></li> -<li><a href="#docs">Docs</a></li> -<li><a href="#re-opening-the-carbs-linux-server">Re-opening the Carbs Linux server</a></li> +<li><a href="#org01ef6cc">Carbs Packaging Tools</a></li> +<li><a href="#org53c8951">Docs</a></li> +<li><a href="#org0391ea3">Re-opening the Carbs Linux server</a></li> </ul> +</div> - -<h2>Carbs Packaging Tools</h2> - -<p>This month I have reworked <code>kiss</code> into a new package manager, now renamed as -<code>cpt</code>. Updating <code>kiss</code> will now bootstrap the new package manager, so you don’t -have to manually edit your system. If you don’t like the idea of this, you can -look up the <code>post-install</code> script on <code>core/kiss</code> and apply the changes manually.</p> - -<p>You will also need to rename your KISS<em>* variables to CPT</em>*. So, KISS_PATH -becomes CPT_PATH.</p> - -<p>The rework changes the previous commands on the package manager into standalone +<div id="outline-container-org01ef6cc" class="outline-2"> +<h2 id="org01ef6cc">Carbs Packaging Tools</h2> +<div class="outline-text-2" id="text-org01ef6cc"> +<p> +This month I have reworked <code>kiss</code> into a new package manager, now renamed as +<code>cpt</code>. Updating <code>kiss</code> will now bootstrap the new package manager, so you don't +have to manually edit your system. If you don't like the idea of this, you can +look up the <code>post-install</code> script on <code>core/kiss</code> and apply the changes manually. +</p> + +<p> +You will also need to rename your <code>KISS_*</code> variables to <code>CPT_*</code>. So, <code>KISS_PATH</code> +becomes <code>CPT_PATH</code>. +</p> + +<p> +The rework changes the previous commands on the package manager into standalone tools, and move the package manager functions to a library. This makes it easier for a user to import functions and variables from the package manager, and extend the package manager with their own intended way. Previously this required ugly hacks and workarounds to use the package manager functions. I will be making use of these changes to re-implement binary package management functions -as well.</p> - -<p>If you want to use the library on your script you can simply do this:</p> - -<pre><code>+--------------------------------------------------------------------------+ -| | -| #!/bin/sh | -| . cpt-lib | -| (...) | -| | -+--------------------------------------------------------------------------+ -</code></pre> - -<p>There are obviously some clean-up and simplifications needed in this new -tool-based package management method.</p> +as well. +</p> + +<p> +If you want to use the library on your script you can simply do this: +</p> + +<div class="org-src-container"> +<pre class="src src-sh"><span class="org-comment-delimiter">#</span><span class="org-comment">!/bin/</span><span class="org-keyword">sh</span> +. cpt-lib +(...) +</pre> +</div> -<h2>Docs</h2> +<p> +There are obviously some clean-up and simplifications needed in this new +tool-based package management method. +</p> +</div> +</div> -<p>I have added documentation for the distribution, and finally updated the guide -for installation. It is now <em>almost</em> complete. These docs can be installed to +<div id="outline-container-org53c8951" class="outline-2"> +<h2 id="org53c8951">Docs</h2> +<div class="outline-text-2" id="text-org53c8951"> +<p> +I have added documentation for the distribution, and finally updated the guide +for installation. It is now <i>almost</i> complete. These docs can be installed to your system for online viewing. I will also add a documentation crawler similar -to how werc<sup id="fnref:1"><a href="#fn:1" rel="footnote">1</a></sup> works (but as an offline viewer). You can find <code>carbs-docs</code> from +to how werc works (but as an offline viewer). You can find <code>carbs-docs</code> from the repository. Currently, the documentation lacks but I will be adding new stuff. These will solely be distribution specific documentation and will not be a wiki-like source. If anyone would like to contribute to a wiki-like documentation source, I would happily re-open the distribution wiki. You can -find the source on https://github.com/CarbsLinux/docs</p> - -<h2>Re-opening the Carbs Linux server</h2> +find the source on <a href="https://github.com/CarbsLinux/docs">https://github.com/CarbsLinux/docs</a>. +</p> +</div> +</div> -<p>Back in May, I had shutdown the Carbs Linux server due to financial issues, but +<div id="outline-container-org0391ea3" class="outline-2"> +<h2 id="org0391ea3">Re-opening the Carbs Linux server</h2> +<div class="outline-text-2" id="text-org0391ea3"> +<p> +Back in May, I had shutdown the Carbs Linux server due to financial issues, but I am slowly reverting to the self-hosted model. Back then, the git repositories were mirrored to GitHub, and the management was overall much more flexible. The server used to run Carbs Linux as well (that was fun and horrifying at the same time). Now, I will be relaunching the git server which will be the upstream source before August 5. You can switch your remote, but GitHub will stay as a -remote nonetheless.</p> +remote nonetheless. +</p> -<p>EDIT: The git-server is up!</p> -<div class="footnotes"> -<hr/> -<ol> -<li id="fn:1"> -http://werc.cat-v.org<a href="#fnref:1" rev="footnote">↩</a></li> -</ol> +<p> +<b>EDIT:</b> The git-server is up! +</p> </div> - - <a href="/blog/20200803.txt">View Page Source</a> - <div class="border"></div> - <p class=footer>Linux® is a registered trademark of Linus Torvalds</p> - <p class=footer>Copyright © 2019-2021 Cem Keylan</p> - </body> +</div> +</div> +<div id="postamble" class="status"> +<footer> + <p>Linux® is a registered trademark of Linus Torvalds</p> + <p>Copyright © 2019-2021 Cem Keylan</p> +</footer> +</div> +</body> </html> diff --git a/docs/blog/20201210.html b/docs/blog/20201210.html index 71826da..f45a807 100644 --- a/docs/blog/20201210.html +++ b/docs/blog/20201210.html @@ -1,32 +1,43 @@ -<!DOCTYPE HTML> -<html lan=en> - <head> - <title>First Year of Carbs Linux | Carbs Linux</title> - <link rel="stylesheet" href="/style.css"> - <meta charset="utf-8"> - <meta name="Description" content="Carbs Linux - a simple linux distribution"> - <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no"> - </head> - <body> - <p class=header><strong>Carbs Linux - a simple linux distribution</strong></p> - <div class="header"> - <nav> - <a href='/'>index</a> - <a href="//git.carbslinux.org">git</a> - <a href='//dl.carbslinux.org'>downloads</a> - <a href='/blog'>blog</a> - <a href='/docs/install.html'>installation</a> - <a href='/docs'>user manual</a> - </nav> - </div><div class="border"></div> -<h1>First Year of Carbs Linux</h1> +<!DOCTYPE html> +<html lang="en"> +<head> +<!-- 2021-02-02 --> +<meta charset="utf-8"> +<meta name="viewport" content="width=device-width, initial-scale=1"> +<title>First Year of Carbs Linux</title> +<meta name="generator" content="Org mode"> +<meta name="author" content="Cem Keylan"> +<link rel="stylesheet" type="text/css" href="/style.css"> +</head> +<body> +<div id="preamble" class="status"> +<nav id="navbar"> + <a href="/" class=navbartitle>Carbs Linux</a> -<p>December 10, 2020 marks the first year after the initial release of Carbs -Linux. When I forked the KISS Linux repository on the 9th of December, I was -fairly new to package management. Carbs Linux used to be almost identical to -KISS Linux. A lot has changed since then:</p> + <label for="hamburger">☰</label> + <input type="checkbox" id="hamburger" /> + <ul id=navbarlist> + <li><a href="/" title="Home Page">Home</a></li> + <li><a href="//git.carbslinux.org" title="Git Repository">Git</a></li> + <li><a href="/download.html" title="Download Carbs Linux">Download</a></li> + <li><a href="/blog" title="Blog Posts">Blog</a></li> + <li><a href="/install.html" title="Installation Instructions">Installation</a></li> + <li><a href="/docs.html" title="Documentation">Docs</a></li> + </ul> +</nav> +</div> +<div id="content"> +<header> +<h1 class="title">First Year of Carbs Linux</h1> +<p class="subtitle">posted on 2020-12-10</p> +</header><p> +December 10, 2020 marks the first year after the initial release of Carbs Linux. +When I forked the KISS Linux repository on the 9th of December, I was fairly new +to package management. Carbs Linux used to be almost identical to KISS Linux. A +lot has changed since then: +</p> -<ul> +<ul class="org-ul"> <li>[2020 Jan 13] Replaced default init system to <code>sinit</code></li> <li>[2020 Jan 15] Packaged <code>WebKit2GTK</code></li> <li>[2020 May 17] Added <code>bearssl</code> on the testing repository</li> @@ -36,15 +47,19 @@ KISS Linux. A lot has changed since then:</p> <li>[2020 Jun 24] Replaced <code>kiss</code> with <code>cpt</code></li> </ul> - -<p>I have really enjoyed maintaining and developing this distribution, and I want +<p> +I have really enjoyed maintaining and developing this distribution, and I want to thank everyone who was involved in some way or another. While I have slowed down in development due to college workload, I am still actively maintaining all the packages on the repository. I do have some ideas that I am thinking of -implementing during the semester break. Hope to see you all in January.</p> - <a href="/blog/20201210.txt">View Page Source</a> - <div class="border"></div> - <p class=footer>Linux® is a registered trademark of Linus Torvalds</p> - <p class=footer>Copyright © 2019-2021 Cem Keylan</p> - </body> +implementing during the semester break. Hope to see you all in January. +</p> +</div> +<div id="postamble" class="status"> +<footer> + <p>Linux® is a registered trademark of Linus Torvalds</p> + <p>Copyright © 2019-2021 Cem Keylan</p> +</footer> +</div> +</body> </html> diff --git a/docs/blog/20201210.txt b/docs/blog/20201210.txt deleted file mode 100644 index d4ef484..0000000 --- a/docs/blog/20201210.txt +++ /dev/null @@ -1,21 +0,0 @@ -First Year of Carbs Linux -================================================================================ - -December 10, 2020 marks the first year after the initial release of Carbs -Linux. When I forked the KISS Linux repository on the 9th of December, I was -fairly new to package management. Carbs Linux used to be almost identical to -KISS Linux. A lot has changed since then: - -- [2020 Jan 13] Replaced default init system to `sinit` -- [2020 Jan 15] Packaged `WebKit2GTK` -- [2020 May 17] Added `bearssl` on the testing repository -- [2020 May 28] Added `rsync` repository support to kiss -- [2020 Jun 03] Replaced `bison` with `byacc` -- [2020 Jun 11] Replaced `libressl` with `bearssl` -- [2020 Jun 24] Replaced `kiss` with `cpt` - -I have really enjoyed maintaining and developing this distribution, and I want -to thank everyone who was involved in some way or another. While I have slowed -down in development due to college workload, I am still actively maintaining all -the packages on the repository. I do have some ideas that I am thinking of -implementing during the semester break. Hope to see you all in January. diff --git a/docs/blog/index.html b/docs/blog/index.html index 6e0e471..1585eb8 100644 --- a/docs/blog/index.html +++ b/docs/blog/index.html @@ -1,42 +1,53 @@ -<!DOCTYPE HTML> -<html lan=en> - <head> - <title>Blog Index | Carbs Linux</title> - <link rel="stylesheet" href="/style.css"> - <meta charset="utf-8"> - <meta name="Description" content="Carbs Linux - a simple linux distribution"> - <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no"> - </head> - <body> - <p class=header><strong>Carbs Linux - a simple linux distribution</strong></p> - <div class="header"> - <nav> - <a href='/'>index</a> - <a href="//git.carbslinux.org">git</a> - <a href='//dl.carbslinux.org'>downloads</a> - <a href='/blog'>blog</a> - <a href='/docs/install.html'>installation</a> - <a href='/docs'>user manual</a> - </nav> - </div><div class="border"></div> -<h1>Blog Index</h1> +<!DOCTYPE html> +<html lang="en"> +<head> +<!-- 2021-02-02 --> +<meta charset="utf-8"> +<meta name="viewport" content="width=device-width, initial-scale=1"> +<title>Blog Index</title> +<meta name="generator" content="Org mode"> +<meta name="author" content="Cem Keylan"> +<link rel="stylesheet" type="text/css" href="/style.css"> +</head> +<body> +<div id="preamble" class="status"> +<nav id="navbar"> + <a href="/" class=navbartitle>Carbs Linux</a> -<p>This is the Carbs Linux Blog Index. You can find every post here. <a href="/rss.xml">RSS Feed</a></p> - -<ul> -<li>Dec 10 2020 - <a href="20201210.html">First Year of Carbs Linux</a></li> -<li>Aug 03 2020 - <a href="20200803.html">August 2020 News Post</a></li> -<li>Jun 17 2020 - <a href="20200617.html">June Newspost</a></li> -<li>May 28 2020 - <a href="20200528.html">kiss 2.0.0 and overall changes</a></li> -<li>May 08 2020 - <a href="20200508.html">The Relation of Carbs and KISS</a></li> -<li>Apr 10 2020 - <a href="20200410.html">Outsource Repository Concept</a></li> -<li>Apr 06 2020 - <a href="20200406.html">Roadmap for Carbs</a></li> -<li>Jan 28 2020 - <a href="20200128.html">Switching to New Website</a></li> + <label for="hamburger">☰</label> + <input type="checkbox" id="hamburger" /> + <ul id=navbarlist> + <li><a href="/" title="Home Page">Home</a></li> + <li><a href="//git.carbslinux.org" title="Git Repository">Git</a></li> + <li><a href="/download.html" title="Download Carbs Linux">Download</a></li> + <li><a href="/blog" title="Blog Posts">Blog</a></li> + <li><a href="/install.html" title="Installation Instructions">Installation</a></li> + <li><a href="/docs.html" title="Documentation">Docs</a></li> + </ul> +</nav> +</div> +<div id="content"> +<header> +<h1 class="title">Blog Index</h1> +</header><p> +This is the Carbs Linux blog index. You can find every post here. <a href="../rss.xml">RSS Feed</a> +</p> +<ul class="org-ul"> +<li><a href="20201210.html">First Year of Carbs Linux</a> <i>posted on 2020-12-10</i></li> +<li><a href="20200803.html">August 2020 News Post</a> <i>posted on 2020-08-03</i></li> +<li><a href="20200617.html">June Newspost</a> <i>posted on 2020-06-17</i></li> +<li><a href="20200528.html">kiss 2.0.0 and Overall Changes</a> <i>posted on 2020-05-28</i></li> +<li><a href="20200508.html">The Relation of Carbs and KISS</a> <i>posted on 2020-05-08</i></li> +<li><a href="20200410.html">Outsource Repository Concept</a> <i>posted on 2020-04-10</i></li> +<li><a href="20200406.html">Roadmap for Carbs</a> <i>posted on 2020-04-06</i></li> +<li><a href="20200128.html">Switching to New Website</a> <i>posted on 2020-01-28</i></li> </ul> - - <a href="/blog/index.txt">View Page Source</a> - <div class="border"></div> - <p class=footer>Linux® is a registered trademark of Linus Torvalds</p> - <p class=footer>Copyright © 2019-2021 Cem Keylan</p> - </body> +</div> +<div id="postamble" class="status"> +<footer> + <p>Linux® is a registered trademark of Linus Torvalds</p> + <p>Copyright © 2019-2021 Cem Keylan</p> +</footer> +</div> +</body> </html> diff --git a/docs/blog/index.txt b/docs/blog/index.txt deleted file mode 100644 index 347ef61..0000000 --- a/docs/blog/index.txt +++ /dev/null @@ -1,16 +0,0 @@ -Blog Index -================================================================================ - -This is the Carbs Linux Blog Index. You can find every post here. [RSS Feed] - -[RSS Feed]: /rss.xml - - -* Dec 10 2020 - [First Year of Carbs Linux](20201210.html) -* Aug 03 2020 - [August 2020 News Post](20200803.html) -* Jun 17 2020 - [June Newspost](20200617.html) -* May 28 2020 - [kiss 2.0.0 and overall changes](20200528.html) -* May 08 2020 - [The Relation of Carbs and KISS](20200508.html) -* Apr 10 2020 - [Outsource Repository Concept](20200410.html) -* Apr 06 2020 - [Roadmap for Carbs](20200406.html) -* Jan 28 2020 - [Switching to New Website](20200128.html) diff --git a/docs/contributing.html b/docs/contributing.html deleted file mode 100644 index ef769ca..0000000 --- a/docs/contributing.html +++ /dev/null @@ -1,38 +0,0 @@ -<!DOCTYPE HTML> -<html lan=en> - <head> - <title>Contribute to the Carbs Linux Project | Carbs Linux</title> - <link rel="stylesheet" href="/style.css"> - <meta charset="utf-8"> - <meta name="Description" content="Carbs Linux - a simple linux distribution"> - <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no"> - </head> - <body> - <p class=header><strong>Carbs Linux - a simple linux distribution</strong></p> - <div class="header"> - <nav> - <a href='/'>index</a> - <a href="//git.carbslinux.org">git</a> - <a href='//dl.carbslinux.org'>downloads</a> - <a href='/blog'>blog</a> - <a href='/docs/install.html'>installation</a> - <a href='/docs'>user manual</a> - </nav> - </div><div class="border"></div> -<h1>Contribute to the Carbs Linux Project</h1> - -<p>This is a small project made possible by volunteers. There are -ways you can help this project stay alive.</p> - -<ul> -<li>Contribute to the <a href="http://git.carbslinux.org/repository/log.html">Carbs Linux repository</a></li> -<li>Contribute to the <a href="https://github.com/kisslinux/community">KISS community repository</a></li> -<li>Contribute to the <a href="//wiki.carbslinux.org">wiki</a></li> -</ul> - - <a href="/contributing.txt">View Page Source</a> - <div class="border"></div> - <p class=footer>Linux® is a registered trademark of Linus Torvalds</p> - <p class=footer>Copyright © 2019-2021 Cem Keylan</p> - </body> -</html> diff --git a/docs/contributing.txt b/docs/contributing.txt deleted file mode 100644 index 3fe71ce..0000000 --- a/docs/contributing.txt +++ /dev/null @@ -1,9 +0,0 @@ -Contribute to the Carbs Linux Project -===================================== - -This is a small project made possible by volunteers. There are -ways you can help this project stay alive. - -* Contribute to the [Carbs Linux repository](http://git.carbslinux.org/repository/log.html) -* Contribute to the [KISS community repository](https://github.com/kisslinux/community) -* Contribute to the [wiki](//wiki.carbslinux.org) diff --git a/docs/docs.html b/docs/docs.html index 596a0bb..aa861fc 100644 --- a/docs/docs.html +++ b/docs/docs.html @@ -1,40 +1,142 @@ -<!DOCTYPE HTML> -<html lan=en> - <head> - <title>Carbs Linux documentation | Carbs Linux</title> - <link rel="stylesheet" href="/style.css"> - <meta charset="utf-8"> - <meta name="Description" content="Carbs Linux - a simple linux distribution"> - <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no"> - </head> - <body> - <p class=header><strong>Carbs Linux - a simple linux distribution</strong></p> - <div class="header"> - <nav> - <a href='/'>index</a> - <a href="//git.carbslinux.org">git</a> - <a href='//dl.carbslinux.org'>downloads</a> - <a href='/blog'>blog</a> - <a href='/docs/install.html'>installation</a> - <a href='/docs'>user manual</a> - </nav> - </div><div class="border"></div> -<h1>Carbs Linux documentation</h1> - -<p>Welcome to the Carbs Linux source of documentation! You can install these to -your system for viewing offline:</p> - -<pre><code>+--------------------------------------------------------------------------+ -| | -| $ cpt-build carbs-docs && cpt-install carbs-docs | -| | -+--------------------------------------------------------------------------+ -</code></pre> - -<h2>Documentation Index</h2> - <a href="/docs.txt">View Page Source</a> - <div class="border"></div> - <p class=footer>Linux® is a registered trademark of Linus Torvalds</p> - <p class=footer>Copyright © 2019-2021 Cem Keylan</p> - </body> +<!DOCTYPE html> +<html lang="en"> +<head> +<!-- 2021-02-02 --> +<meta charset="utf-8"> +<meta name="viewport" content="width=device-width, initial-scale=1"> +<title>Documentation</title> +<meta name="generator" content="Org mode"> +<meta name="author" content="Cem Keylan"> +<link rel="stylesheet" type="text/css" href="/style.css"> +</head> +<body> +<div id="preamble" class="status"> +<nav id="navbar"> + <a href="/" class=navbartitle>Carbs Linux</a> + + <label for="hamburger">☰</label> + <input type="checkbox" id="hamburger" /> + <ul id=navbarlist> + <li><a href="/" title="Home Page">Home</a></li> + <li><a href="//git.carbslinux.org" title="Git Repository">Git</a></li> + <li><a href="/download.html" title="Download Carbs Linux">Download</a></li> + <li><a href="/blog" title="Blog Posts">Blog</a></li> + <li><a href="/install.html" title="Installation Instructions">Installation</a></li> + <li><a href="/docs.html" title="Documentation">Docs</a></li> + </ul> +</nav> +</div> +<div id="content"> +<header> +<h1 class="title">Documentation</h1> +</header><p> +Below are sources of documentation regarding Carbs Linux and tools surrounding +it. +</p> + +<div id="outline-container-orgdf416ed" class="outline-2"> +<h2 id="orgdf416ed">User Manual</h2> +<div class="outline-text-2" id="text-orgdf416ed"> +<p> +Carbs Linux User Manual aims to be a general-purpose explanation of the +distribution, from the installation steps to the style guide of the project. It +can be accessed or otherwise obtained with various methods: +</p> +</div> + +<div id="outline-container-org22e859c" class="outline-3"> +<h3 id="org22e859c">HTML</h3> +<div class="outline-text-3" id="text-org22e859c"> +<p> +You can view the Manual from your browser. The Manual can be viewed as +</p> + +<ul class="org-ul"> +<li><a href="docs/carbslinux">One HTML page per node</a></li> +<li><a href="docs/carbslinux.html">Single HTML page</a></li> +</ul> +</div> +</div> + +<div id="outline-container-orgb47e655" class="outline-3"> +<h3 id="orgb47e655">Plain text</h3> +<div class="outline-text-3" id="text-orgb47e655"> +<p> +You can download <a href="docs/carbslinux.txt">carbslinux.txt</a> in order to view the Manual from your preferred +pager. +</p> + +<div class="org-src-container"> +<pre class="src src-sh">curl -LO https://carbslinux.org/docs/carbslinux.txt +less carbslinux.txt +</pre> +</div> +</div> +</div> + +<div id="outline-container-org372faa1" class="outline-3"> +<h3 id="org372faa1">Info</h3> +<div class="outline-text-3" id="text-org372faa1"> +<p> +You can install the <code>carbs-docs</code> package and either <code>texinfo</code> or <code>info</code> packages +to view the Manual offline. +</p> + +<div class="org-src-container"> +<pre class="src src-sh">cpt bi info carbs-docs +info carbslinux +</pre> +</div> +</div> +</div> + +<div id="outline-container-orgf2eddf6" class="outline-3"> +<h3 id="orgf2eddf6">Source</h3> +<div class="outline-text-3" id="text-orgf2eddf6"> +<p> +You can also acquire the source for generating the Manual, which requires +<code>emacs</code> for exporting the Org-mode documentation and <code>texinfo</code> for generating +html/info pages. +</p> + +<div class="org-src-container"> +<pre class="src src-sh">git clone git://git.carbslinux.org/docs +</pre> +</div> +</div> +</div> +</div> + +<div id="outline-container-org818b50e" class="outline-2"> +<h2 id="org818b50e">Installation Instructions</h2> +<div class="outline-text-2" id="text-org818b50e"> +<p> +Installation Manual is part of the <a href="#orgdf416ed">User Manual</a>, but it can also be obtained +separately: +</p> + +<ul class="org-ul"> +<li><a href="install.html">HTML</a></li> +<li><a href="install.txt">Plaintext</a></li> +</ul> +</div> +</div> + +<div id="outline-container-org8a6251e" class="outline-2"> +<h2 id="org8a6251e">Carbs Packaging Tools</h2> +<div class="outline-text-2" id="text-org8a6251e"> +<p> +The user manual for CPT is not complete yet, but will be released with the 6.0.0 +release. You can see the <a href="https://github.com/CarbsLinux/cpt">repository</a> in order to check its status. +</p> +</div> +</div> +</div> +<div id="postamble" class="status"> +<footer> + <p>Linux® is a registered trademark of Linus Torvalds</p> + <p>Copyright © 2019-2021 Cem Keylan</p> +</footer> +</div> +</body> </html> diff --git a/docs/docs.txt b/docs/docs.txt index a481cf0..385ad92 100644 --- a/docs/docs.txt +++ b/docs/docs.txt @@ -1,15 +1,98 @@ -Carbs Linux documentation -================================================================================ + _______________ -Welcome to the Carbs Linux source of documentation! You can install these to -your system for viewing offline: + DOCUMENTATION + _______________ - +--------------------------------------------------------------------------+ - | | - | $ cpt-build carbs-docs && cpt-install carbs-docs | - | | - +--------------------------------------------------------------------------+ +Below are sources of documentation regarding Carbs Linux and tools +surrounding it. -Documentation Index --------------------------------------------------------------------------------- + +User Manual +=========== + + Carbs Linux User Manual aims to be a general-purpose explanation of + the distribution, from the installation steps to the style guide of + the project. It can be accessed or otherwise obtained with various + methods: + + +HTML +~~~~ + + You can view the Manual from your browser. The Manual can be viewed as + + - [One HTML page per node] + - [Single HTML page] + + +[One HTML page per node] <file:docs/carbslinux> + +[Single HTML page] <file:docs/carbslinux.html> + + +Plain text +~~~~~~~~~~ + + You can download [carbslinux.txt] in order to view the Manual from + your preferred pager. + + ,---- + | curl -LO https://carbslinux.org/docs/carbslinux.txt + | less carbslinux.txt + `---- + + +[carbslinux.txt] <file:docs/carbslinux.txt> + + +Info +~~~~ + + You can install the `carbs-docs' package and either `texinfo' or + `info' packages to view the Manual offline. + + ,---- + | cpt bi info carbs-docs + | info carbslinux + `---- + + +Source +~~~~~~ + + You can also acquire the source for generating the Manual, which + requires `emacs' for exporting the Org-mode documentation and + `texinfo' for generating html/info pages. + + ,---- + | git clone git://git.carbslinux.org/docs + `---- + + +Installation Instructions +========================= + + Installation Manual is part of the [User Manual], but it can also be + obtained separately: + + - [HTML] + - [Plaintext] + + +[User Manual] See section User Manual + +[HTML] <file:install.org> + +[Plaintext] <file:install.txt> + + +Carbs Packaging Tools +===================== + + The user manual for CPT is not complete yet, but will be released with + the 6.0.0 release. You can see the [repository] in order to check its + status. + + +[repository] <https://github.com/CarbsLinux/cpt> diff --git a/docs/docs/0010.html b/docs/docs/0010.html deleted file mode 100644 index fad5ef3..0000000 --- a/docs/docs/0010.html +++ /dev/null @@ -1,49 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> -<html> -<!-- Copyright (C) 2020 Cem Keylan - -Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.3 or -any later version published by the Free Software Foundation; with no -Invariant Sections, with no Front-Cover Texts and no Back-Cover Texts. -A copy of the license is included in the section entitled "GNU Free -Documentation License." - --> -<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> -<!-- This file redirects to the location of a node or anchor --> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> -<title>0010 (Carbs Linux User Manual)</title> - -<meta name="description" content="0010 (Carbs Linux User Manual)"> -<meta name="keywords" content="0010 (Carbs Linux User Manual)"> -<meta name="resource-type" content="document"> -<meta name="distribution" content="global"> -<meta name="Generator" content="makeinfo"> -<style type="text/css"> -<!-- -a.summary-letter {text-decoration: none} -blockquote.indentedblock {margin-right: 0em} -div.display {margin-left: 3.2em} -div.example {margin-left: 3.2em} -div.lisp {margin-left: 3.2em} -kbd {font-style: oblique} -pre.display {font-family: inherit} -pre.format {font-family: inherit} -pre.menu-comment {font-family: serif} -pre.menu-preformatted {font-family: serif} -span.nolinebreak {white-space: nowrap} -span.roman {font-family: initial; font-weight: normal} -span.sansserif {font-family: sans-serif; font-weight: normal} -ul.no-bullet {list-style: none} ---> -</style> - -<meta http-equiv="Refresh" content="0; url=Conventions.html#g_t0010"> - -</head> - -<body lang="en"> - -<p>The node you are looking for is at <a href="Conventions.html#g_t0010">0010</a>.</p> -</body> diff --git a/docs/docs/0011.html b/docs/docs/0011.html deleted file mode 100644 index ab45257..0000000 --- a/docs/docs/0011.html +++ /dev/null @@ -1,49 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> -<html> -<!-- Copyright (C) 2020 Cem Keylan - -Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.3 or -any later version published by the Free Software Foundation; with no -Invariant Sections, with no Front-Cover Texts and no Back-Cover Texts. -A copy of the license is included in the section entitled "GNU Free -Documentation License." - --> -<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> -<!-- This file redirects to the location of a node or anchor --> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> -<title>0011 (Carbs Linux User Manual)</title> - -<meta name="description" content="0011 (Carbs Linux User Manual)"> -<meta name="keywords" content="0011 (Carbs Linux User Manual)"> -<meta name="resource-type" content="document"> -<meta name="distribution" content="global"> -<meta name="Generator" content="makeinfo"> -<style type="text/css"> -<!-- -a.summary-letter {text-decoration: none} -blockquote.indentedblock {margin-right: 0em} -div.display {margin-left: 3.2em} -div.example {margin-left: 3.2em} -div.lisp {margin-left: 3.2em} -kbd {font-style: oblique} -pre.display {font-family: inherit} -pre.format {font-family: inherit} -pre.menu-comment {font-family: serif} -pre.menu-preformatted {font-family: serif} -span.nolinebreak {white-space: nowrap} -span.roman {font-family: initial; font-weight: normal} -span.sansserif {font-family: sans-serif; font-weight: normal} -ul.no-bullet {list-style: none} ---> -</style> - -<meta http-equiv="Refresh" content="0; url=Conventions.html#g_t0011"> - -</head> - -<body lang="en"> - -<p>The node you are looking for is at <a href="Conventions.html#g_t0011">0011</a>.</p> -</body> diff --git a/docs/docs/0012.html b/docs/docs/0012.html deleted file mode 100644 index 32dca75..0000000 --- a/docs/docs/0012.html +++ /dev/null @@ -1,49 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> -<html> -<!-- Copyright (C) 2020 Cem Keylan - -Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.3 or -any later version published by the Free Software Foundation; with no -Invariant Sections, with no Front-Cover Texts and no Back-Cover Texts. -A copy of the license is included in the section entitled "GNU Free -Documentation License." - --> -<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> -<!-- This file redirects to the location of a node or anchor --> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> -<title>0012 (Carbs Linux User Manual)</title> - -<meta name="description" content="0012 (Carbs Linux User Manual)"> -<meta name="keywords" content="0012 (Carbs Linux User Manual)"> -<meta name="resource-type" content="document"> -<meta name="distribution" content="global"> -<meta name="Generator" content="makeinfo"> -<style type="text/css"> -<!-- -a.summary-letter {text-decoration: none} -blockquote.indentedblock {margin-right: 0em} -div.display {margin-left: 3.2em} -div.example {margin-left: 3.2em} -div.lisp {margin-left: 3.2em} -kbd {font-style: oblique} -pre.display {font-family: inherit} -pre.format {font-family: inherit} -pre.menu-comment {font-family: serif} -pre.menu-preformatted {font-family: serif} -span.nolinebreak {white-space: nowrap} -span.roman {font-family: initial; font-weight: normal} -span.sansserif {font-family: sans-serif; font-weight: normal} -ul.no-bullet {list-style: none} ---> -</style> - -<meta http-equiv="Refresh" content="0; url=Conventions.html#g_t0012"> - -</head> - -<body lang="en"> - -<p>The node you are looking for is at <a href="Conventions.html#g_t0012">0012</a>.</p> -</body> diff --git a/docs/docs/1020.html b/docs/docs/1020.html deleted file mode 100644 index 2f73bac..0000000 --- a/docs/docs/1020.html +++ /dev/null @@ -1,49 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> -<html> -<!-- Copyright (C) 2020 Cem Keylan - -Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.3 or -any later version published by the Free Software Foundation; with no -Invariant Sections, with no Front-Cover Texts and no Back-Cover Texts. -A copy of the license is included in the section entitled "GNU Free -Documentation License." - --> -<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> -<!-- This file redirects to the location of a node or anchor --> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> -<title>1020 (Carbs Linux User Manual)</title> - -<meta name="description" content="1020 (Carbs Linux User Manual)"> -<meta name="keywords" content="1020 (Carbs Linux User Manual)"> -<meta name="resource-type" content="document"> -<meta name="distribution" content="global"> -<meta name="Generator" content="makeinfo"> -<style type="text/css"> -<!-- -a.summary-letter {text-decoration: none} -blockquote.indentedblock {margin-right: 0em} -div.display {margin-left: 3.2em} -div.example {margin-left: 3.2em} -div.lisp {margin-left: 3.2em} -kbd {font-style: oblique} -pre.display {font-family: inherit} -pre.format {font-family: inherit} -pre.menu-comment {font-family: serif} -pre.menu-preformatted {font-family: serif} -span.nolinebreak {white-space: nowrap} -span.roman {font-family: initial; font-weight: normal} -span.sansserif {font-family: sans-serif; font-weight: normal} -ul.no-bullet {list-style: none} ---> -</style> - -<meta http-equiv="Refresh" content="0; url=Shell-Conventions.html#g_t1020"> - -</head> - -<body lang="en"> - -<p>The node you are looking for is at <a href="Shell-Conventions.html#g_t1020">1020</a>.</p> -</body> diff --git a/docs/docs/1030.html b/docs/docs/1030.html deleted file mode 100644 index bb51640..0000000 --- a/docs/docs/1030.html +++ /dev/null @@ -1,49 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> -<html> -<!-- Copyright (C) 2020 Cem Keylan - -Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.3 or -any later version published by the Free Software Foundation; with no -Invariant Sections, with no Front-Cover Texts and no Back-Cover Texts. -A copy of the license is included in the section entitled "GNU Free -Documentation License." - --> -<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> -<!-- This file redirects to the location of a node or anchor --> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> -<title>1030 (Carbs Linux User Manual)</title> - -<meta name="description" content="1030 (Carbs Linux User Manual)"> -<meta name="keywords" content="1030 (Carbs Linux User Manual)"> -<meta name="resource-type" content="document"> -<meta name="distribution" content="global"> -<meta name="Generator" content="makeinfo"> -<style type="text/css"> -<!-- -a.summary-letter {text-decoration: none} -blockquote.indentedblock {margin-right: 0em} -div.display {margin-left: 3.2em} -div.example {margin-left: 3.2em} -div.lisp {margin-left: 3.2em} -kbd {font-style: oblique} -pre.display {font-family: inherit} -pre.format {font-family: inherit} -pre.menu-comment {font-family: serif} -pre.menu-preformatted {font-family: serif} -span.nolinebreak {white-space: nowrap} -span.roman {font-family: initial; font-weight: normal} -span.sansserif {font-family: sans-serif; font-weight: normal} -ul.no-bullet {list-style: none} ---> -</style> - -<meta http-equiv="Refresh" content="0; url=Shell-Conventions.html#g_t1030"> - -</head> - -<body lang="en"> - -<p>The node you are looking for is at <a href="Shell-Conventions.html#g_t1030">1030</a>.</p> -</body> diff --git a/docs/docs/1040.html b/docs/docs/1040.html deleted file mode 100644 index ae10d79..0000000 --- a/docs/docs/1040.html +++ /dev/null @@ -1,49 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> -<html> -<!-- Copyright (C) 2020 Cem Keylan - -Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.3 or -any later version published by the Free Software Foundation; with no -Invariant Sections, with no Front-Cover Texts and no Back-Cover Texts. -A copy of the license is included in the section entitled "GNU Free -Documentation License." - --> -<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> -<!-- This file redirects to the location of a node or anchor --> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> -<title>1040 (Carbs Linux User Manual)</title> - -<meta name="description" content="1040 (Carbs Linux User Manual)"> -<meta name="keywords" content="1040 (Carbs Linux User Manual)"> -<meta name="resource-type" content="document"> -<meta name="distribution" content="global"> -<meta name="Generator" content="makeinfo"> -<style type="text/css"> -<!-- -a.summary-letter {text-decoration: none} -blockquote.indentedblock {margin-right: 0em} -div.display {margin-left: 3.2em} -div.example {margin-left: 3.2em} -div.lisp {margin-left: 3.2em} -kbd {font-style: oblique} -pre.display {font-family: inherit} -pre.format {font-family: inherit} -pre.menu-comment {font-family: serif} -pre.menu-preformatted {font-family: serif} -span.nolinebreak {white-space: nowrap} -span.roman {font-family: initial; font-weight: normal} -span.sansserif {font-family: sans-serif; font-weight: normal} -ul.no-bullet {list-style: none} ---> -</style> - -<meta http-equiv="Refresh" content="0; url=Shell-Conventions.html#g_t1040"> - -</head> - -<body lang="en"> - -<p>The node you are looking for is at <a href="Shell-Conventions.html#g_t1040">1040</a>.</p> -</body> diff --git a/docs/docs/2020.html b/docs/docs/2020.html deleted file mode 100644 index dab5be2..0000000 --- a/docs/docs/2020.html +++ /dev/null @@ -1,49 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> -<html> -<!-- Copyright (C) 2020 Cem Keylan - -Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.3 or -any later version published by the Free Software Foundation; with no -Invariant Sections, with no Front-Cover Texts and no Back-Cover Texts. -A copy of the license is included in the section entitled "GNU Free -Documentation License." - --> -<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> -<!-- This file redirects to the location of a node or anchor --> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> -<title>2020 (Carbs Linux User Manual)</title> - -<meta name="description" content="2020 (Carbs Linux User Manual)"> -<meta name="keywords" content="2020 (Carbs Linux User Manual)"> -<meta name="resource-type" content="document"> -<meta name="distribution" content="global"> -<meta name="Generator" content="makeinfo"> -<style type="text/css"> -<!-- -a.summary-letter {text-decoration: none} -blockquote.indentedblock {margin-right: 0em} -div.display {margin-left: 3.2em} -div.example {margin-left: 3.2em} -div.lisp {margin-left: 3.2em} -kbd {font-style: oblique} -pre.display {font-family: inherit} -pre.format {font-family: inherit} -pre.menu-comment {font-family: serif} -pre.menu-preformatted {font-family: serif} -span.nolinebreak {white-space: nowrap} -span.roman {font-family: initial; font-weight: normal} -span.sansserif {font-family: sans-serif; font-weight: normal} -ul.no-bullet {list-style: none} ---> -</style> - -<meta http-equiv="Refresh" content="0; url=Repository-Conventions.html#g_t2020"> - -</head> - -<body lang="en"> - -<p>The node you are looking for is at <a href="Repository-Conventions.html#g_t2020">2020</a>.</p> -</body> diff --git a/docs/docs/2030.html b/docs/docs/2030.html deleted file mode 100644 index 353fd6f..0000000 --- a/docs/docs/2030.html +++ /dev/null @@ -1,49 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> -<html> -<!-- Copyright (C) 2020 Cem Keylan - -Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.3 or -any later version published by the Free Software Foundation; with no -Invariant Sections, with no Front-Cover Texts and no Back-Cover Texts. -A copy of the license is included in the section entitled "GNU Free -Documentation License." - --> -<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> -<!-- This file redirects to the location of a node or anchor --> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> -<title>2030 (Carbs Linux User Manual)</title> - -<meta name="description" content="2030 (Carbs Linux User Manual)"> -<meta name="keywords" content="2030 (Carbs Linux User Manual)"> -<meta name="resource-type" content="document"> -<meta name="distribution" content="global"> -<meta name="Generator" content="makeinfo"> -<style type="text/css"> -<!-- -a.summary-letter {text-decoration: none} -blockquote.indentedblock {margin-right: 0em} -div.display {margin-left: 3.2em} -div.example {margin-left: 3.2em} -div.lisp {margin-left: 3.2em} -kbd {font-style: oblique} -pre.display {font-family: inherit} -pre.format {font-family: inherit} -pre.menu-comment {font-family: serif} -pre.menu-preformatted {font-family: serif} -span.nolinebreak {white-space: nowrap} -span.roman {font-family: initial; font-weight: normal} -span.sansserif {font-family: sans-serif; font-weight: normal} -ul.no-bullet {list-style: none} ---> -</style> - -<meta http-equiv="Refresh" content="0; url=Repository-Conventions.html#g_t2030"> - -</head> - -<body lang="en"> - -<p>The node you are looking for is at <a href="Repository-Conventions.html#g_t2030">2030</a>.</p> -</body> diff --git a/docs/docs/2040.html b/docs/docs/2040.html deleted file mode 100644 index 84e108a..0000000 --- a/docs/docs/2040.html +++ /dev/null @@ -1,49 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> -<html> -<!-- Copyright (C) 2020 Cem Keylan - -Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.3 or -any later version published by the Free Software Foundation; with no -Invariant Sections, with no Front-Cover Texts and no Back-Cover Texts. -A copy of the license is included in the section entitled "GNU Free -Documentation License." - --> -<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> -<!-- This file redirects to the location of a node or anchor --> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> -<title>2040 (Carbs Linux User Manual)</title> - -<meta name="description" content="2040 (Carbs Linux User Manual)"> -<meta name="keywords" content="2040 (Carbs Linux User Manual)"> -<meta name="resource-type" content="document"> -<meta name="distribution" content="global"> -<meta name="Generator" content="makeinfo"> -<style type="text/css"> -<!-- -a.summary-letter {text-decoration: none} -blockquote.indentedblock {margin-right: 0em} -div.display {margin-left: 3.2em} -div.example {margin-left: 3.2em} -div.lisp {margin-left: 3.2em} -kbd {font-style: oblique} -pre.display {font-family: inherit} -pre.format {font-family: inherit} -pre.menu-comment {font-family: serif} -pre.menu-preformatted {font-family: serif} -span.nolinebreak {white-space: nowrap} -span.roman {font-family: initial; font-weight: normal} -span.sansserif {font-family: sans-serif; font-weight: normal} -ul.no-bullet {list-style: none} ---> -</style> - -<meta http-equiv="Refresh" content="0; url=Repository-Conventions.html#g_t2040"> - -</head> - -<body lang="en"> - -<p>The node you are looking for is at <a href="Repository-Conventions.html#g_t2040">2040</a>.</p> -</body> diff --git a/docs/docs/Changing-Init-Program.html b/docs/docs/Changing-Init-Program.html deleted file mode 100644 index d1cc7ce..0000000 --- a/docs/docs/Changing-Init-Program.html +++ /dev/null @@ -1,86 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> -<html> -<!-- Copyright (C) 2020 Cem Keylan - -Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.3 or -any later version published by the Free Software Foundation; with no -Invariant Sections, with no Front-Cover Texts and no Back-Cover Texts. -A copy of the license is included in the section entitled "GNU Free -Documentation License." - --> -<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> -<title>Changing Init Program (Carbs Linux User Manual)</title> - -<meta name="description" content="Changing Init Program (Carbs Linux User Manual)"> -<meta name="keywords" content="Changing Init Program (Carbs Linux User Manual)"> -<meta name="resource-type" content="document"> -<meta name="distribution" content="global"> -<meta name="Generator" content="makeinfo"> -<link href="index.html" rel="start" title="Top"> -<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents"> -<link href="Init-System.html" rel="up" title="Init System"> -<link href="Rebooting-after-changing-init.html" rel="next" title="Rebooting after changing init"> -<link href="Init-Hooks.html" rel="prev" title="Init Hooks"> -<style type="text/css"> -<!-- -a.summary-letter {text-decoration: none} -blockquote.indentedblock {margin-right: 0em} -div.display {margin-left: 3.2em} -div.example {margin-left: 3.2em} -div.lisp {margin-left: 3.2em} -kbd {font-style: oblique} -pre.display {font-family: inherit} -pre.format {font-family: inherit} -pre.menu-comment {font-family: serif} -pre.menu-preformatted {font-family: serif} -span.nolinebreak {white-space: nowrap} -span.roman {font-family: initial; font-weight: normal} -span.sansserif {font-family: sans-serif; font-weight: normal} -ul.no-bullet {list-style: none} ---> -</style> - - -</head> - -<body lang="en"> -<span id="Changing-Init-Program"></span><div class="header"> -<p> -Previous: <a href="Configuring-Init.html" accesskey="p" rel="prev">Configuring Init</a>, Up: <a href="Init-System.html" accesskey="u" rel="up">Init System</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> -</div> -<hr> -<span id="Changing-Init-Program-1"></span><h3 class="section">2.2 Changing Init Program</h3> - -<p>By default, Carbs Linux comes preinstalled with ‘<samp>busybox-init</samp>’, but this can -easily be replaced without any issues. Currently, available init systems are: -</p> -<ul> -<li> ‘<samp>sinit</samp>’ -</li><li> ‘<samp>busybox</samp>’ -</li><li> ‘<samp>runit</samp>’ -</li><li> ‘<samp>shinit</samp>’ -</li></ul> - -<p>This example is for runit, but it will work with all init systems packaged in the -distribution repositories. See the ‘<samp>cpt-alternatives(1)</samp>’ manual page for more -details. -</p> -<div class="example"> -<pre class="example">cpt a runit /usr/bin/init -cpt a runit /usr/bin/poweroff -cpt a runit /usr/bin/reboot -</pre></div> - -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="Rebooting-after-changing-init.html" accesskey="1">Rebooting after changing init</a></td><td> </td><td align="left" valign="top">Ways to reboot after replacing the init system -</td></tr> -</table> - - - - -</body> -</html> diff --git a/docs/docs/Contribution-Guidelines.html b/docs/docs/Contribution-Guidelines.html deleted file mode 100644 index 5b2c7cf..0000000 --- a/docs/docs/Contribution-Guidelines.html +++ /dev/null @@ -1,70 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> -<html> -<!-- Copyright (C) 2020 Cem Keylan - -Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.3 or -any later version published by the Free Software Foundation; with no -Invariant Sections, with no Front-Cover Texts and no Back-Cover Texts. -A copy of the license is included in the section entitled "GNU Free -Documentation License." - --> -<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> -<title>Contribution Guidelines (Carbs Linux User Manual)</title> - -<meta name="description" content="Contribution Guidelines (Carbs Linux User Manual)"> -<meta name="keywords" content="Contribution Guidelines (Carbs Linux User Manual)"> -<meta name="resource-type" content="document"> -<meta name="distribution" content="global"> -<meta name="Generator" content="makeinfo"> -<link href="index.html" rel="start" title="Top"> -<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents"> -<link href="index.html" rel="up" title="Top"> -<link href="Conventions.html" rel="next" title="Conventions"> -<link href="Rebooting-after-changing-init.html" rel="prev" title="Rebooting after changing init"> -<style type="text/css"> -<!-- -a.summary-letter {text-decoration: none} -blockquote.indentedblock {margin-right: 0em} -div.display {margin-left: 3.2em} -div.example {margin-left: 3.2em} -div.lisp {margin-left: 3.2em} -kbd {font-style: oblique} -pre.display {font-family: inherit} -pre.format {font-family: inherit} -pre.menu-comment {font-family: serif} -pre.menu-preformatted {font-family: serif} -span.nolinebreak {white-space: nowrap} -span.roman {font-family: initial; font-weight: normal} -span.sansserif {font-family: sans-serif; font-weight: normal} -ul.no-bullet {list-style: none} ---> -</style> - - -</head> - -<body lang="en"> -<span id="Contribution-Guidelines"></span><div class="header"> -<p> -Next: <a href="GNU-Free-Documentation-License.html" accesskey="n" rel="next">GNU Free Documentation License</a>, Previous: <a href="Init-System.html" accesskey="p" rel="prev">Init System</a>, Up: <a href="index.html" accesskey="u" rel="up">Top</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> -</div> -<hr> -<span id="Contribution-Guidelines-1"></span><h2 class="chapter">3 Contribution Guidelines</h2> - -<p>Thanks for taking your time to contribute! To maintain stylistic behaviour -throughout the repositories, one must adhere to these conventions. Exceptions -and changes may occur with good reasoning. -</p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="Conventions.html" accesskey="1">Conventions</a></td><td> </td><td align="left" valign="top">Conventions of the distribution -</td></tr> -</table> - - - - -</body> -</html> diff --git a/docs/docs/Conventions.html b/docs/docs/Conventions.html deleted file mode 100644 index e1b3ac6..0000000 --- a/docs/docs/Conventions.html +++ /dev/null @@ -1,96 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> -<html> -<!-- Copyright (C) 2020 Cem Keylan - -Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.3 or -any later version published by the Free Software Foundation; with no -Invariant Sections, with no Front-Cover Texts and no Back-Cover Texts. -A copy of the license is included in the section entitled "GNU Free -Documentation License." - --> -<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> -<title>Conventions (Carbs Linux User Manual)</title> - -<meta name="description" content="Conventions (Carbs Linux User Manual)"> -<meta name="keywords" content="Conventions (Carbs Linux User Manual)"> -<meta name="resource-type" content="document"> -<meta name="distribution" content="global"> -<meta name="Generator" content="makeinfo"> -<link href="index.html" rel="start" title="Top"> -<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents"> -<link href="Contribution-Guidelines.html" rel="up" title="Contribution Guidelines"> -<link href="Shell-Conventions.html" rel="next" title="Shell Conventions"> -<link href="Contribution-Guidelines.html" rel="prev" title="Contribution Guidelines"> -<style type="text/css"> -<!-- -a.summary-letter {text-decoration: none} -blockquote.indentedblock {margin-right: 0em} -div.display {margin-left: 3.2em} -div.example {margin-left: 3.2em} -div.lisp {margin-left: 3.2em} -kbd {font-style: oblique} -pre.display {font-family: inherit} -pre.format {font-family: inherit} -pre.menu-comment {font-family: serif} -pre.menu-preformatted {font-family: serif} -span.nolinebreak {white-space: nowrap} -span.roman {font-family: initial; font-weight: normal} -span.sansserif {font-family: sans-serif; font-weight: normal} -ul.no-bullet {list-style: none} ---> -</style> - - -</head> - -<body lang="en"> -<span id="Conventions"></span><div class="header"> -<p> -Up: <a href="Contribution-Guidelines.html" accesskey="u" rel="up">Contribution Guidelines</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> -</div> -<hr> -<span id="Conventions-1"></span><h3 class="section">3.1 Conventions</h3> - - - -<dl compact="compact"> -<dt>[<span id="g_t0010"></span>0010]</dt> -<dd><p>Try to keep the file readable. -</p><dl compact="compact"> -<dt>[<span id="g_t0011"></span>0011]</dt> -<dd><p>Characters on a line shouldn’t exceed 100 characters. -</p></dd> -<dt>[<span id="g_t0012"></span>0012]</dt> -<dd><p>Make sure you don’t have code commented out during -commit. Uncomment them or remove them completely. -</p></dd> -<dt>[<span id="g_t0013"></span>0013]</dt> -<dd><p>Do not add comments following the code, add them to the -top of the code. It makes it harder to read, and lines longer. Here is an example: -</p></dd> -</dl> - -<div class="example"> -<pre class="example"># Good way of commenting. -your code goes here - -your code goes here # Avoid this way of commenting. -</pre></div> -</dd> -</dl> - -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="Shell-Conventions.html" accesskey="1">Shell Conventions</a></td><td> </td><td align="left" valign="top">Conventions for shell scripts -</td></tr> -<tr><td align="left" valign="top">• <a href="Repository-Conventions.html" accesskey="2">Repository Conventions</a></td><td> </td><td align="left" valign="top">Conventions for repository build scripts -</td></tr> -</table> - - - - -</body> -</html> diff --git a/docs/docs/Download.html b/docs/docs/Download.html deleted file mode 100644 index 5d2a595..0000000 --- a/docs/docs/Download.html +++ /dev/null @@ -1,71 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> -<html> -<!-- Copyright (C) 2020 Cem Keylan - -Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.3 or -any later version published by the Free Software Foundation; with no -Invariant Sections, with no Front-Cover Texts and no Back-Cover Texts. -A copy of the license is included in the section entitled "GNU Free -Documentation License." - --> -<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> -<title>Download (Carbs Linux User Manual)</title> - -<meta name="description" content="Download (Carbs Linux User Manual)"> -<meta name="keywords" content="Download (Carbs Linux User Manual)"> -<meta name="resource-type" content="document"> -<meta name="distribution" content="global"> -<meta name="Generator" content="makeinfo"> -<link href="index.html" rel="start" title="Top"> -<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents"> -<link href="Preparing-Environment.html" rel="up" title="Preparing Environment"> -<link href="Signature-verification.html" rel="next" title="Signature verification"> -<link href="Preparing-Environment.html" rel="prev" title="Preparing Environment"> -<style type="text/css"> -<!-- -a.summary-letter {text-decoration: none} -blockquote.indentedblock {margin-right: 0em} -div.display {margin-left: 3.2em} -div.example {margin-left: 3.2em} -div.lisp {margin-left: 3.2em} -kbd {font-style: oblique} -pre.display {font-family: inherit} -pre.format {font-family: inherit} -pre.menu-comment {font-family: serif} -pre.menu-preformatted {font-family: serif} -span.nolinebreak {white-space: nowrap} -span.roman {font-family: initial; font-weight: normal} -span.sansserif {font-family: sans-serif; font-weight: normal} -ul.no-bullet {list-style: none} ---> -</style> - - -</head> - -<body lang="en"> -<span id="Download"></span><div class="header"> -<p> -Next: <a href="Signature-verification.html" accesskey="n" rel="next">Signature verification</a>, Up: <a href="Preparing-Environment.html" accesskey="u" rel="up">Preparing Environment</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> -</div> -<hr> -<span id="Download-1"></span><h4 class="subsection">1.1.1 Download</h4> - -<p>First, we need to download the rootfs tarball. You can do the following in order -to obtain the rootfs. If you are using an i686 machine, replace the ‘<samp>x86_64</samp>’ -with ‘<samp>i686</samp>’. We are setting this in a URL variable so that we don’t have to -write it every time. -</p> -<div class="example"> -<pre class="example">wget $URL/carbs-rootfs.tar.xz.sha256 -sha256sum -c carbs-rootfs.tar.xz.sha256 -</pre></div> - - - - -</body> -</html> diff --git a/docs/docs/Hosts-file.html b/docs/docs/Hosts-file.html deleted file mode 100644 index ed26d62..0000000 --- a/docs/docs/Hosts-file.html +++ /dev/null @@ -1,70 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> -<html> -<!-- Copyright (C) 2020 Cem Keylan - -Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.3 or -any later version published by the Free Software Foundation; with no -Invariant Sections, with no Front-Cover Texts and no Back-Cover Texts. -A copy of the license is included in the section entitled "GNU Free -Documentation License." - --> -<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> -<title>Hosts file (Carbs Linux User Manual)</title> - -<meta name="description" content="Hosts file (Carbs Linux User Manual)"> -<meta name="keywords" content="Hosts file (Carbs Linux User Manual)"> -<meta name="resource-type" content="document"> -<meta name="distribution" content="global"> -<meta name="Generator" content="makeinfo"> -<link href="index.html" rel="start" title="Top"> -<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents"> -<link href="System-Configuration.html" rel="up" title="System Configuration"> -<link href="Kernel.html" rel="next" title="Kernel"> -<link href="Configuring-hostname.html" rel="prev" title="Configuring hostname"> -<style type="text/css"> -<!-- -a.summary-letter {text-decoration: none} -blockquote.indentedblock {margin-right: 0em} -div.display {margin-left: 3.2em} -div.example {margin-left: 3.2em} -div.lisp {margin-left: 3.2em} -kbd {font-style: oblique} -pre.display {font-family: inherit} -pre.format {font-family: inherit} -pre.menu-comment {font-family: serif} -pre.menu-preformatted {font-family: serif} -span.nolinebreak {white-space: nowrap} -span.roman {font-family: initial; font-weight: normal} -span.sansserif {font-family: sans-serif; font-weight: normal} -ul.no-bullet {list-style: none} ---> -</style> - - -</head> - -<body lang="en"> -<span id="Hosts-file"></span><div class="header"> -<p> -Previous: <a href="Configuring-hostname.html" accesskey="p" rel="prev">Configuring hostname</a>, Up: <a href="System-Configuration.html" accesskey="u" rel="up">System Configuration</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> -</div> -<hr> -<span id="Hosts-file-1"></span><h4 class="subsection">1.3.2 Hosts file</h4> - -<p>You can edit your /etc/hosts file, which is the static lookup table for host -names. By default, there are two entries for localhost which are OKAY. You can -replace the ’localhost’ part of these entries to your hostname. -</p> -<div class="example"> -<pre class="example">127.0.0.1 localhost.localdomain localhost -::1 localhost.localdomain localhost ip6-localhost -</pre></div> - - - - -</body> -</html> diff --git a/docs/docs/Init-Hooks.html b/docs/docs/Init-Hooks.html deleted file mode 100644 index 52e2e84..0000000 --- a/docs/docs/Init-Hooks.html +++ /dev/null @@ -1,85 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> -<html> -<!-- Copyright (C) 2020 Cem Keylan - -Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.3 or -any later version published by the Free Software Foundation; with no -Invariant Sections, with no Front-Cover Texts and no Back-Cover Texts. -A copy of the license is included in the section entitled "GNU Free -Documentation License." - --> -<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> -<title>Init Hooks (Carbs Linux User Manual)</title> - -<meta name="description" content="Init Hooks (Carbs Linux User Manual)"> -<meta name="keywords" content="Init Hooks (Carbs Linux User Manual)"> -<meta name="resource-type" content="document"> -<meta name="distribution" content="global"> -<meta name="Generator" content="makeinfo"> -<link href="index.html" rel="start" title="Top"> -<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents"> -<link href="Configuring-Init.html" rel="up" title="Configuring Init"> -<link href="Changing-Init-Program.html" rel="next" title="Changing Init Program"> -<link href="_002fetc_002finit_002frcconf-file.html" rel="prev" title="/etc/init/rcconf file"> -<style type="text/css"> -<!-- -a.summary-letter {text-decoration: none} -blockquote.indentedblock {margin-right: 0em} -div.display {margin-left: 3.2em} -div.example {margin-left: 3.2em} -div.lisp {margin-left: 3.2em} -kbd {font-style: oblique} -pre.display {font-family: inherit} -pre.format {font-family: inherit} -pre.menu-comment {font-family: serif} -pre.menu-preformatted {font-family: serif} -span.nolinebreak {white-space: nowrap} -span.roman {font-family: initial; font-weight: normal} -span.sansserif {font-family: sans-serif; font-weight: normal} -ul.no-bullet {list-style: none} ---> -</style> - - -</head> - -<body lang="en"> -<span id="Init-Hooks"></span><div class="header"> -<p> -Previous: <a href="_002fetc_002finit_002frcconf-file.html" accesskey="p" rel="prev">‘<samp>/etc/init/rcconf</samp>’ file</a>, Up: <a href="Configuring-Init.html" accesskey="u" rel="up">Configuring Init</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> -</div> -<hr> -<span id="Init-Hooks-1"></span><h4 class="subsection">2.1.3 Init Hooks</h4> - -<p>Init hooks are for custom personal commands that the user may want to add to -alter their boot. These can be used to load kernel modules, modify interfaces, -and lot more. Those hooks are added to the ‘<samp>/etc/init</samp>’ directory with the -hook name as the suffix. For example, a boot script will be placed as -‘<samp>/etc/init/my-hook.boot</samp>’. Currently, there are 4 hooks that the user can use. -</p> -<dl compact="compact"> -<dt>early-boot</dt> -<dd><p>Run after pseudo-filesystems are mounted. -</p></dd> -<dt>boot</dt> -<dd><p>Run before the boot stage is completed. -</p></dd> -<dt>pre.shutdown</dt> -<dd><p>Run first when shutting down. -</p></dd> -<dt>umount</dt> -<dd><p>Run just before filesystems are unmounted. -</p></dd> -<dt>post.shutdown</dt> -<dd><p>Run just before the system is halted. -</p></dd> -</dl> - - - - -</body> -</html> diff --git a/docs/docs/Init-System.html b/docs/docs/Init-System.html deleted file mode 100644 index 3d23ab0..0000000 --- a/docs/docs/Init-System.html +++ /dev/null @@ -1,73 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> -<html> -<!-- Copyright (C) 2020 Cem Keylan - -Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.3 or -any later version published by the Free Software Foundation; with no -Invariant Sections, with no Front-Cover Texts and no Back-Cover Texts. -A copy of the license is included in the section entitled "GNU Free -Documentation License." - --> -<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> -<title>Init System (Carbs Linux User Manual)</title> - -<meta name="description" content="Init System (Carbs Linux User Manual)"> -<meta name="keywords" content="Init System (Carbs Linux User Manual)"> -<meta name="resource-type" content="document"> -<meta name="distribution" content="global"> -<meta name="Generator" content="makeinfo"> -<link href="index.html" rel="start" title="Top"> -<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents"> -<link href="index.html" rel="up" title="Top"> -<link href="Configuring-Init.html" rel="next" title="Configuring Init"> -<link href="KISS-repositories.html" rel="prev" title="KISS repositories"> -<style type="text/css"> -<!-- -a.summary-letter {text-decoration: none} -blockquote.indentedblock {margin-right: 0em} -div.display {margin-left: 3.2em} -div.example {margin-left: 3.2em} -div.lisp {margin-left: 3.2em} -kbd {font-style: oblique} -pre.display {font-family: inherit} -pre.format {font-family: inherit} -pre.menu-comment {font-family: serif} -pre.menu-preformatted {font-family: serif} -span.nolinebreak {white-space: nowrap} -span.roman {font-family: initial; font-weight: normal} -span.sansserif {font-family: sans-serif; font-weight: normal} -ul.no-bullet {list-style: none} ---> -</style> - - -</head> - -<body lang="en"> -<span id="Init-System"></span><div class="header"> -<p> -Next: <a href="Contribution-Guidelines.html" accesskey="n" rel="next">Contribution Guidelines</a>, Previous: <a href="Installation.html" accesskey="p" rel="prev">Installation</a>, Up: <a href="index.html" accesskey="u" rel="up">Top</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> -</div> -<hr> -<span id="Init-System-1"></span><h2 class="chapter">2 Init System</h2> - -<p>Carbs Linux init scripts are run by the init daemon (‘<samp>busybox</samp>’ by default) on -boot and shutdown processes. It also provides its own halting program named -shalt. This provides a portable method that doesn’t rely on non-POSIX external -programs. -</p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="Configuring-Init.html" accesskey="1">Configuring Init</a></td><td> </td><td align="left" valign="top">Ways to configure the init system -</td></tr> -<tr><td align="left" valign="top">• <a href="Changing-Init-Program.html" accesskey="2">Changing Init Program</a></td><td> </td><td align="left" valign="top">Replace the default busybox init with something new -</td></tr> -</table> - - - - -</body> -</html> diff --git a/docs/docs/Installation.html b/docs/docs/Installation.html deleted file mode 100644 index d088c4d..0000000 --- a/docs/docs/Installation.html +++ /dev/null @@ -1,84 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> -<html> -<!-- Copyright (C) 2020 Cem Keylan - -Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.3 or -any later version published by the Free Software Foundation; with no -Invariant Sections, with no Front-Cover Texts and no Back-Cover Texts. -A copy of the license is included in the section entitled "GNU Free -Documentation License." - --> -<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> -<title>Installation (Carbs Linux User Manual)</title> - -<meta name="description" content="Installation (Carbs Linux User Manual)"> -<meta name="keywords" content="Installation (Carbs Linux User Manual)"> -<meta name="resource-type" content="document"> -<meta name="distribution" content="global"> -<meta name="Generator" content="makeinfo"> -<link href="index.html" rel="start" title="Top"> -<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents"> -<link href="index.html" rel="up" title="Top"> -<link href="Preparing-Environment.html" rel="next" title="Preparing Environment"> -<link href="index.html" rel="prev" title="Top"> -<style type="text/css"> -<!-- -a.summary-letter {text-decoration: none} -blockquote.indentedblock {margin-right: 0em} -div.display {margin-left: 3.2em} -div.example {margin-left: 3.2em} -div.lisp {margin-left: 3.2em} -kbd {font-style: oblique} -pre.display {font-family: inherit} -pre.format {font-family: inherit} -pre.menu-comment {font-family: serif} -pre.menu-preformatted {font-family: serif} -span.nolinebreak {white-space: nowrap} -span.roman {font-family: initial; font-weight: normal} -span.sansserif {font-family: sans-serif; font-weight: normal} -ul.no-bullet {list-style: none} ---> -</style> - - -</head> - -<body lang="en"> -<span id="Installation"></span><div class="header"> -<p> -Next: <a href="Init-System.html" accesskey="n" rel="next">Init System</a>, Previous: <a href="index.html" accesskey="p" rel="prev">Top</a>, Up: <a href="index.html" accesskey="u" rel="up">Top</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> -</div> -<hr> -<span id="Installation-1"></span><h2 class="chapter">1 Installation</h2> - -<p>These are the step-by-step instructions for installing Carbs Linux. It can be -acquired as plain-text to be viewed offline with a pager from -<a href="https://carbslinux.org/docs/install.txt">https://carbslinux.org/docs/install.txt</a>. -</p> -<div class="example"> -<pre class="example">curl -sL https://carbslinux.org/docs/install.txt | less -</pre></div> - -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="Preparing-Environment.html" accesskey="1">Preparing Environment</a></td><td> </td><td align="left" valign="top">Getting ready to chroot -</td></tr> -<tr><td align="left" valign="top">• <a href="Chroot.html" accesskey="2">Chroot</a></td><td> </td><td align="left" valign="top">Going inside your new system -</td></tr> -<tr><td align="left" valign="top">• <a href="System-Configuration.html" accesskey="3">System Configuration</a></td><td> </td><td align="left" valign="top">Customizing your system for personal use -</td></tr> -<tr><td align="left" valign="top">• <a href="Kernel.html" accesskey="4">Kernel</a></td><td> </td><td align="left" valign="top">Compiling your own kernel -</td></tr> -<tr><td align="left" valign="top">• <a href="Making-your-system-bootable.html" accesskey="5">Making your system bootable</a></td><td> </td><td align="left" valign="top">Installing bootloader and boot scripts -</td></tr> -<tr><td align="left" valign="top">• <a href="Post_002dinstallation.html" accesskey="6">Post-installation</a></td><td> </td><td align="left" valign="top">Post-installation tasks -</td></tr> -</table> - - - - -</body> -</html> diff --git a/docs/docs/Kernel-dependencies.html b/docs/docs/Kernel-dependencies.html deleted file mode 100644 index 192479b..0000000 --- a/docs/docs/Kernel-dependencies.html +++ /dev/null @@ -1,81 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> -<html> -<!-- Copyright (C) 2020 Cem Keylan - -Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.3 or -any later version published by the Free Software Foundation; with no -Invariant Sections, with no Front-Cover Texts and no Back-Cover Texts. -A copy of the license is included in the section entitled "GNU Free -Documentation License." - --> -<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> -<title>Kernel dependencies (Carbs Linux User Manual)</title> - -<meta name="description" content="Kernel dependencies (Carbs Linux User Manual)"> -<meta name="keywords" content="Kernel dependencies (Carbs Linux User Manual)"> -<meta name="resource-type" content="document"> -<meta name="distribution" content="global"> -<meta name="Generator" content="makeinfo"> -<link href="index.html" rel="start" title="Top"> -<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents"> -<link href="Kernel.html" rel="up" title="Kernel"> -<link href="Building-the-kernel.html" rel="next" title="Building the kernel"> -<link href="Obtaining-the-kernel-sources.html" rel="prev" title="Obtaining the kernel sources"> -<style type="text/css"> -<!-- -a.summary-letter {text-decoration: none} -blockquote.indentedblock {margin-right: 0em} -div.display {margin-left: 3.2em} -div.example {margin-left: 3.2em} -div.lisp {margin-left: 3.2em} -kbd {font-style: oblique} -pre.display {font-family: inherit} -pre.format {font-family: inherit} -pre.menu-comment {font-family: serif} -pre.menu-preformatted {font-family: serif} -span.nolinebreak {white-space: nowrap} -span.roman {font-family: initial; font-weight: normal} -span.sansserif {font-family: sans-serif; font-weight: normal} -ul.no-bullet {list-style: none} ---> -</style> - - -</head> - -<body lang="en"> -<span id="Kernel-dependencies"></span><div class="header"> -<p> -Next: <a href="Building-the-kernel.html" accesskey="n" rel="next">Building the kernel</a>, Previous: <a href="Obtaining-the-kernel-sources.html" accesskey="p" rel="prev">Obtaining the kernel sources</a>, Up: <a href="Kernel.html" accesskey="u" rel="up">Kernel</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> -</div> -<hr> -<span id="Kernel-dependencies-1"></span><h4 class="subsection">1.4.2 Kernel dependencies</h4> - -<p>In order to compile the kernel you will need to install some dependencies. You -will need ‘<samp>libelf</samp>’ to compile the kernel. If you want to configure using the -menu interface you will also need ‘<samp>ncurses</samp>’. -</p> -<div class="example"> -<pre class="example"># The package manager asks to install if you are building more than one package, -# so no need to run 'cpt i ...' -cpt b libelf ncurses -</pre></div> - -<p>In the vanilla kernel sources, you need perl to compile the kernel, but it can -be easily patched out. You will need to apply the following patch. Patch was -written by <a href="https://github.com/E5ten">E5ten</a>. You will need to obtain and apply the patch in the kernel -source directory. -</p> -<div class="example"> -<pre class="example">wget https://dl.carbslinux.org/distfiles/kernel-no-perl.patch -patch -p1 < kernel-no-perl.patch -</pre></div> - - - - -</body> -</html> diff --git a/docs/docs/Obtain-the-chroot-helper.html b/docs/docs/Obtain-the-chroot-helper.html deleted file mode 100644 index e5fc1d3..0000000 --- a/docs/docs/Obtain-the-chroot-helper.html +++ /dev/null @@ -1,69 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> -<html> -<!-- Copyright (C) 2020 Cem Keylan - -Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.3 or -any later version published by the Free Software Foundation; with no -Invariant Sections, with no Front-Cover Texts and no Back-Cover Texts. -A copy of the license is included in the section entitled "GNU Free -Documentation License." - --> -<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> -<title>Obtain the chroot helper (Carbs Linux User Manual)</title> - -<meta name="description" content="Obtain the chroot helper (Carbs Linux User Manual)"> -<meta name="keywords" content="Obtain the chroot helper (Carbs Linux User Manual)"> -<meta name="resource-type" content="document"> -<meta name="distribution" content="global"> -<meta name="Generator" content="makeinfo"> -<link href="index.html" rel="start" title="Top"> -<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents"> -<link href="Preparing-Environment.html" rel="up" title="Preparing Environment"> -<link href="Chroot.html" rel="next" title="Chroot"> -<link href="Extracting-the-tarball.html" rel="prev" title="Extracting the tarball"> -<style type="text/css"> -<!-- -a.summary-letter {text-decoration: none} -blockquote.indentedblock {margin-right: 0em} -div.display {margin-left: 3.2em} -div.example {margin-left: 3.2em} -div.lisp {margin-left: 3.2em} -kbd {font-style: oblique} -pre.display {font-family: inherit} -pre.format {font-family: inherit} -pre.menu-comment {font-family: serif} -pre.menu-preformatted {font-family: serif} -span.nolinebreak {white-space: nowrap} -span.roman {font-family: initial; font-weight: normal} -span.sansserif {font-family: sans-serif; font-weight: normal} -ul.no-bullet {list-style: none} ---> -</style> - - -</head> - -<body lang="en"> -<span id="Obtain-the-chroot-helper"></span><div class="header"> -<p> -Previous: <a href="Extracting-the-tarball.html" accesskey="p" rel="prev">Extracting the tarball</a>, Up: <a href="Preparing-Environment.html" accesskey="u" rel="up">Preparing Environment</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> -</div> -<hr> -<span id="Obtain-the-chroot-helper-1"></span><h4 class="subsection">1.1.4 Obtain the chroot helper</h4> - -<p>You can obtain the ‘<samp>cpt-chroot</samp>’ script in order to do a simple chroot into your -new root filesystem. -</p> -<div class="example"> -<pre class="example">wget https://dl.carbslinux.org/distfiles/cpt-chroot -chmod a+x cpt-chroot -</pre></div> - - - - -</body> -</html> diff --git a/docs/docs/Obtaining-the-kernel-sources.html b/docs/docs/Obtaining-the-kernel-sources.html deleted file mode 100644 index 5acdb26..0000000 --- a/docs/docs/Obtaining-the-kernel-sources.html +++ /dev/null @@ -1,74 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> -<html> -<!-- Copyright (C) 2020 Cem Keylan - -Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.3 or -any later version published by the Free Software Foundation; with no -Invariant Sections, with no Front-Cover Texts and no Back-Cover Texts. -A copy of the license is included in the section entitled "GNU Free -Documentation License." - --> -<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> -<title>Obtaining the kernel sources (Carbs Linux User Manual)</title> - -<meta name="description" content="Obtaining the kernel sources (Carbs Linux User Manual)"> -<meta name="keywords" content="Obtaining the kernel sources (Carbs Linux User Manual)"> -<meta name="resource-type" content="document"> -<meta name="distribution" content="global"> -<meta name="Generator" content="makeinfo"> -<link href="index.html" rel="start" title="Top"> -<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents"> -<link href="Kernel.html" rel="up" title="Kernel"> -<link href="Kernel-dependencies.html" rel="next" title="Kernel dependencies"> -<link href="Kernel.html" rel="prev" title="Kernel"> -<style type="text/css"> -<!-- -a.summary-letter {text-decoration: none} -blockquote.indentedblock {margin-right: 0em} -div.display {margin-left: 3.2em} -div.example {margin-left: 3.2em} -div.lisp {margin-left: 3.2em} -kbd {font-style: oblique} -pre.display {font-family: inherit} -pre.format {font-family: inherit} -pre.menu-comment {font-family: serif} -pre.menu-preformatted {font-family: serif} -span.nolinebreak {white-space: nowrap} -span.roman {font-family: initial; font-weight: normal} -span.sansserif {font-family: sans-serif; font-weight: normal} -ul.no-bullet {list-style: none} ---> -</style> - - -</head> - -<body lang="en"> -<span id="Obtaining-the-kernel-sources"></span><div class="header"> -<p> -Next: <a href="Kernel-dependencies.html" accesskey="n" rel="next">Kernel dependencies</a>, Up: <a href="Kernel.html" accesskey="u" rel="up">Kernel</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> -</div> -<hr> -<span id="Obtaining-the-kernel-sources-1"></span><h4 class="subsection">1.4.1 Obtaining the kernel sources</h4> - -<p>You can visit the <a href="https://kernel.org">https://kernel.org</a> website to choose a kernel that you want -to install. Though only the latest stable and longterm (LTS) versions are -supported. -</p> -<div class="example"> -<pre class="example"># Download the kernel and extract it -wget https://cdn.kernel.org/pub/linux/kernel/v5.x/linux-5.9.1.tar.xz -tar xf linux-5.9.1.tar.xz - -# Change directory into the kernel sources -cd linux-5.9.1 -</pre></div> - - - - -</body> -</html> diff --git a/docs/docs/Post_002dinstallation.html b/docs/docs/Post_002dinstallation.html deleted file mode 100644 index da1dc05..0000000 --- a/docs/docs/Post_002dinstallation.html +++ /dev/null @@ -1,70 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> -<html> -<!-- Copyright (C) 2020 Cem Keylan - -Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.3 or -any later version published by the Free Software Foundation; with no -Invariant Sections, with no Front-Cover Texts and no Back-Cover Texts. -A copy of the license is included in the section entitled "GNU Free -Documentation License." - --> -<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> -<title>Post-installation (Carbs Linux User Manual)</title> - -<meta name="description" content="Post-installation (Carbs Linux User Manual)"> -<meta name="keywords" content="Post-installation (Carbs Linux User Manual)"> -<meta name="resource-type" content="document"> -<meta name="distribution" content="global"> -<meta name="Generator" content="makeinfo"> -<link href="index.html" rel="start" title="Top"> -<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents"> -<link href="Installation.html" rel="up" title="Installation"> -<link href="KISS-repositories.html" rel="next" title="KISS repositories"> -<link href="Fstab.html" rel="prev" title="Fstab"> -<style type="text/css"> -<!-- -a.summary-letter {text-decoration: none} -blockquote.indentedblock {margin-right: 0em} -div.display {margin-left: 3.2em} -div.example {margin-left: 3.2em} -div.lisp {margin-left: 3.2em} -kbd {font-style: oblique} -pre.display {font-family: inherit} -pre.format {font-family: inherit} -pre.menu-comment {font-family: serif} -pre.menu-preformatted {font-family: serif} -span.nolinebreak {white-space: nowrap} -span.roman {font-family: initial; font-weight: normal} -span.sansserif {font-family: sans-serif; font-weight: normal} -ul.no-bullet {list-style: none} ---> -</style> - - -</head> - -<body lang="en"> -<span id="Post_002dinstallation"></span><div class="header"> -<p> -Previous: <a href="Making-your-system-bootable.html" accesskey="p" rel="prev">Making your system bootable</a>, Up: <a href="Installation.html" accesskey="u" rel="up">Installation</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> -</div> -<hr> -<span id="Post_002dinstallation-1"></span><h3 class="section">1.6 Post-installation</h3> - -<p>The base installation is now complete, you can now fine tune your system -according to your needs. Rest of these instructions are completely optional. -You can check the rest of the documentation to learn more about the system. -</p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="KISS-repositories.html" accesskey="1">KISS repositories</a></td><td> </td><td align="left" valign="top">Acquire kiss repositories -</td></tr> -</table> - - - - -</body> -</html> diff --git a/docs/docs/Rebooting-after-changing-init.html b/docs/docs/Rebooting-after-changing-init.html deleted file mode 100644 index 85d02cf..0000000 --- a/docs/docs/Rebooting-after-changing-init.html +++ /dev/null @@ -1,73 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> -<html> -<!-- Copyright (C) 2020 Cem Keylan - -Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.3 or -any later version published by the Free Software Foundation; with no -Invariant Sections, with no Front-Cover Texts and no Back-Cover Texts. -A copy of the license is included in the section entitled "GNU Free -Documentation License." - --> -<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> -<title>Rebooting after changing init (Carbs Linux User Manual)</title> - -<meta name="description" content="Rebooting after changing init (Carbs Linux User Manual)"> -<meta name="keywords" content="Rebooting after changing init (Carbs Linux User Manual)"> -<meta name="resource-type" content="document"> -<meta name="distribution" content="global"> -<meta name="Generator" content="makeinfo"> -<link href="index.html" rel="start" title="Top"> -<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents"> -<link href="Changing-Init-Program.html" rel="up" title="Changing Init Program"> -<link href="Contribution-Guidelines.html" rel="next" title="Contribution Guidelines"> -<link href="Changing-Init-Program.html" rel="prev" title="Changing Init Program"> -<style type="text/css"> -<!-- -a.summary-letter {text-decoration: none} -blockquote.indentedblock {margin-right: 0em} -div.display {margin-left: 3.2em} -div.example {margin-left: 3.2em} -div.lisp {margin-left: 3.2em} -kbd {font-style: oblique} -pre.display {font-family: inherit} -pre.format {font-family: inherit} -pre.menu-comment {font-family: serif} -pre.menu-preformatted {font-family: serif} -span.nolinebreak {white-space: nowrap} -span.roman {font-family: initial; font-weight: normal} -span.sansserif {font-family: sans-serif; font-weight: normal} -ul.no-bullet {list-style: none} ---> -</style> - - -</head> - -<body lang="en"> -<span id="Rebooting-after-changing-init"></span><div class="header"> -<p> -Up: <a href="Changing-Init-Program.html" accesskey="u" rel="up">Changing Init Program</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> -</div> -<hr> -<span id="Rebooting-after-changing-init-1"></span><h4 class="subsection">2.2.1 Rebooting after changing init</h4> - -<p>After switching init systems, your running init system may not accept the -new poweroff commands. You will need to reboot/poweroff using the running init’s -utilities for the new utilities to work. These commands are for the init system -currently running on your system and not the one you are switching to. -</p> -<table> -<thead><tr><th>Program</th><th>Command</th></tr></thead> -<tr><td>busybox</td><td>‘<samp>busybox reboot</samp>’</td></tr> -<tr><td>runit</td><td>‘<samp>runit-init 6</samp>’</td></tr> -<tr><td>shinit/sinit</td><td>‘<samp>kill -s INT 1</samp>’</td></tr> -</table> - - - - -</body> -</html> diff --git a/docs/docs/Repository-Conventions.html b/docs/docs/Repository-Conventions.html deleted file mode 100644 index 598cc7a..0000000 --- a/docs/docs/Repository-Conventions.html +++ /dev/null @@ -1,219 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> -<html> -<!-- Copyright (C) 2020 Cem Keylan - -Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.3 or -any later version published by the Free Software Foundation; with no -Invariant Sections, with no Front-Cover Texts and no Back-Cover Texts. -A copy of the license is included in the section entitled "GNU Free -Documentation License." - --> -<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> -<title>Repository Conventions (Carbs Linux User Manual)</title> - -<meta name="description" content="Repository Conventions (Carbs Linux User Manual)"> -<meta name="keywords" content="Repository Conventions (Carbs Linux User Manual)"> -<meta name="resource-type" content="document"> -<meta name="distribution" content="global"> -<meta name="Generator" content="makeinfo"> -<link href="index.html" rel="start" title="Top"> -<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents"> -<link href="Conventions.html" rel="up" title="Conventions"> -<link href="GNU-Free-Documentation-License.html" rel="next" title="GNU Free Documentation License"> -<link href="Shell-Conventions.html" rel="prev" title="Shell Conventions"> -<style type="text/css"> -<!-- -a.summary-letter {text-decoration: none} -blockquote.indentedblock {margin-right: 0em} -div.display {margin-left: 3.2em} -div.example {margin-left: 3.2em} -div.lisp {margin-left: 3.2em} -kbd {font-style: oblique} -pre.display {font-family: inherit} -pre.format {font-family: inherit} -pre.menu-comment {font-family: serif} -pre.menu-preformatted {font-family: serif} -span.nolinebreak {white-space: nowrap} -span.roman {font-family: initial; font-weight: normal} -span.sansserif {font-family: sans-serif; font-weight: normal} -ul.no-bullet {list-style: none} ---> -</style> - - -</head> - -<body lang="en"> -<span id="Repository-Conventions"></span><div class="header"> -<p> -Previous: <a href="Shell-Conventions.html" accesskey="p" rel="prev">Shell Conventions</a>, Up: <a href="Conventions.html" accesskey="u" rel="up">Conventions</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> -</div> -<hr> -<span id="Repository-Conventions-1"></span><h4 class="subsection">3.1.2 Repository Conventions</h4> - -<p>Repository conventions are important in order to ensure every package resemble -themselves. Here are the things to keep in mind: -</p> -<dl compact="compact"> -<dt>[<span id="g_t2010"></span>2010]</dt> -<dd><p>Prefer tarballs over git packages unless there is a -sensible reason. Here are some: -</p><ul> -<li> Every patch is a new release. (See <a href="https://github.com/vim/vim">vim</a>) -</li><li> There are no releases. (See <a href="https://git.suckless.org/sbase">sbase</a>) -</li><li> Following a development branch. -</li><li> There has been a long time since the latest release, but upstream is far -ahead. -</li></ul> -</dd> -<dt>[<span id="g_t2020"></span>2020]</dt> -<dd><p>Prefer sources without a dependency to ‘<samp>automake</samp>’. There -are usually distribution tarballs that are ‘<samp>autoconf</samp>’’ed. Don’t submit tarballs -with an automake dependency unless you are ‘<samp>sure</samp>’ there is no alternative. -</p></dd> -<dt>[<span id="g_t2030"></span>2030]</dt> -<dd><p>Avoid these packages: -</p><dl compact="compact"> -<dt>dbus</dt> -<dd><p>Usually can be disabled by <code>--disable-dbus</code>. -</p></dd> -<dt>gettext</dt> -<dd><p>Usually can be disabled by <code>--disable-nls</code>. -</p></dd> -</dl> -</dd> -<dt>[<span id="g_t2040"></span>2040]</dt> -<dd><ul> -<li> Always install a package to the ‘<samp>/usr</samp>’ prefix. -</li><li> All binaries should go to ‘<samp>/usr/bin</samp>’, not ‘<samp>/usr/sbin</samp>’ or any other directory. -</li><li> All libraries should go to ‘<samp>/usr/lib</samp>’. -</li></ul> -</dd> -<dt>[<span id="g_t2050"></span>2050]</dt> -<dd><p>All build files on the repository should be a POSIX -shell script, and must start with <code>#!/bin/sh -e</code>. -</p></dd> -</dl> - -<p>The next section is about package templates that should be used in order to -ensure stylistic consistency. Note that the option configurations shouldn’t be -taken literally, they are meant as examples. -</p> -<ol> -<li> Make [<span id="g_t2210"></span>2210] - - -<div class="example"> -<pre class="example">#!/bin/sh -e - -make -make DESTDIR="$1" PREFIX=/usr install -</pre></div> - -</li><li> Configure/Make [<span id="g_t2211"></span>2211] - - -<div class="example"> -<pre class="example">#!/bin/sh -e - -./configure \ - --prefix=/usr \ - --disable-option \ - --enable-option - -make -make DESTDIR="$1" install -</pre></div> - -</li><li> Autoconf/Automake [<span id="g_t2212"></span>2212] - - -<p>See <a href="#g_t2020">2020</a> -</p> -<div class="example"> -<pre class="example">#!/bin/sh -e - -autoreconf -fi - -./configure \ - --prefix=/usr \ - --disable-option \ - --enable-option - -make -make DESTDIR="$1" install -</pre></div> - -</li><li> Meson [<span id="g_t2220"></span>2220] - - -<div class="example"> -<pre class="example">#!/bin/sh -e - -export DESTDIR=$1 - -meson \ - --prefix=/usr \ - -Doption=false \ - -Doption2=true \ - . output - -ninja -C output -ninja -C output install -</pre></div> - -</li><li> Cmake [<span id="g_t2230"></span>2230] - - -<div class="example"> -<pre class="example">#!/bin/sh -e - -export DESTDIR=$1 - -cmake -B build \ - -DCMAKE_INSTALL_PREFIX=/usr \ - -DCMAKE_BUILD_TYPE=Release \ - -DOPTION=ON - -cmake --build build -cmake --install build -</pre></div> - -</li><li> Go [<span id="g_t2240"></span>2240] - - -<div class="example"> -<pre class="example">#!/bin/sh -e - -export GOPATH=$PWD/gopath -trap "go clean -modcache" EXIT INT -go mod vendor - -go build -install -Dm755 program "$1/usr/bin/program" -</pre></div> - -</li><li> Python [<span id="g_t2241"></span>2241] - - -<div class="example"> -<pre class="example">#!/bin/sh -e - -python setup.py build -python setup.py install --prefix=/usr --root="$1" -</pre></div> -</li></ol> - -<hr> -<div class="header"> -<p> -Previous: <a href="Shell-Conventions.html" accesskey="p" rel="prev">Shell Conventions</a>, Up: <a href="Conventions.html" accesskey="u" rel="up">Conventions</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> -</div> - - - -</body> -</html> diff --git a/docs/docs/Shell-Conventions.html b/docs/docs/Shell-Conventions.html deleted file mode 100644 index dd841de..0000000 --- a/docs/docs/Shell-Conventions.html +++ /dev/null @@ -1,104 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> -<html> -<!-- Copyright (C) 2020 Cem Keylan - -Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.3 or -any later version published by the Free Software Foundation; with no -Invariant Sections, with no Front-Cover Texts and no Back-Cover Texts. -A copy of the license is included in the section entitled "GNU Free -Documentation License." - --> -<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> -<title>Shell Conventions (Carbs Linux User Manual)</title> - -<meta name="description" content="Shell Conventions (Carbs Linux User Manual)"> -<meta name="keywords" content="Shell Conventions (Carbs Linux User Manual)"> -<meta name="resource-type" content="document"> -<meta name="distribution" content="global"> -<meta name="Generator" content="makeinfo"> -<link href="index.html" rel="start" title="Top"> -<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents"> -<link href="Conventions.html" rel="up" title="Conventions"> -<link href="Repository-Conventions.html" rel="next" title="Repository Conventions"> -<link href="Conventions.html" rel="prev" title="Conventions"> -<style type="text/css"> -<!-- -a.summary-letter {text-decoration: none} -blockquote.indentedblock {margin-right: 0em} -div.display {margin-left: 3.2em} -div.example {margin-left: 3.2em} -div.lisp {margin-left: 3.2em} -kbd {font-style: oblique} -pre.display {font-family: inherit} -pre.format {font-family: inherit} -pre.menu-comment {font-family: serif} -pre.menu-preformatted {font-family: serif} -span.nolinebreak {white-space: nowrap} -span.roman {font-family: initial; font-weight: normal} -span.sansserif {font-family: sans-serif; font-weight: normal} -ul.no-bullet {list-style: none} ---> -</style> - - -</head> - -<body lang="en"> -<span id="Shell-Conventions"></span><div class="header"> -<p> -Next: <a href="Repository-Conventions.html" accesskey="n" rel="next">Repository Conventions</a>, Up: <a href="Conventions.html" accesskey="u" rel="up">Conventions</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> -</div> -<hr> -<span id="Shell-Conventions-1"></span><h4 class="subsection">3.1.1 Shell Conventions</h4> - -<p>Shell is central to Carbs Linux projects. Most of the tools and packages are -written in POSIX sh. -</p> -<dl compact="compact"> -<dt>[<span id="g_t1010"></span>1010]</dt> -<dd><p>Use 4 spaces for indentation, don’t use tabs. -</p></dd> -<dt>[<span id="g_t1020"></span>1020]</dt> -<dd><p>Make sure you don’t use bash-specific code. -</p></dd> -<dt>[<span id="g_t1030"></span>1030]</dt> -<dd><p>Make sure you lint your code with ‘<samp>shellcheck</samp>’ and if -you are new to POSIX sh, use ‘<samp>checkbashisms</samp>’. -</p></dd> -<dt>[<span id="g_t1040"></span>1040]</dt> -<dd><p>Don’t spawn new processes if you don’t absolutely need -to, especially during string manipulation. -</p><dl compact="compact"> -<dt>[<span id="g_t1041"></span>1041]</dt> -<dd><p>Never use a program for text manupilation that isn’t -defined in the POSIX standard. This includes ‘<samp>gawk</samp>’ and ‘<samp>perl</samp>’. -</p></dd> -<dt>[<span id="g_t1042"></span>1042]</dt> -<dd><p>Instead of <code>$(basename $file)</code>, use <code>${file##*}</code>. -</p></dd> -<dt>[<span id="g_t1043"></span>1043]</dt> -<dd><p>Instead of <code>$(dirname $file)</code>, use <code>${file%/*}</code>. -</p></dd> -</dl> - -<div class="example"> -<pre class="example"># This is the same thing as basename /path/to/test.asc .asc - -$ file=/path/to/test.asc file=${file##*/} file=${file%.asc} -$ echo $file -test -</pre></div> -</dd> -<dt>[<span id="g_t1050"></span>1050]</dt> -<dd><p>Instead of backticks, use <code>$(..)</code>. -</p></dd> -</dl> - - - - -</body> -</html> diff --git a/docs/docs/System-Configuration.html b/docs/docs/System-Configuration.html deleted file mode 100644 index 76cf410..0000000 --- a/docs/docs/System-Configuration.html +++ /dev/null @@ -1,71 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> -<html> -<!-- Copyright (C) 2020 Cem Keylan - -Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.3 or -any later version published by the Free Software Foundation; with no -Invariant Sections, with no Front-Cover Texts and no Back-Cover Texts. -A copy of the license is included in the section entitled "GNU Free -Documentation License." - --> -<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> -<title>System Configuration (Carbs Linux User Manual)</title> - -<meta name="description" content="System Configuration (Carbs Linux User Manual)"> -<meta name="keywords" content="System Configuration (Carbs Linux User Manual)"> -<meta name="resource-type" content="document"> -<meta name="distribution" content="global"> -<meta name="Generator" content="makeinfo"> -<link href="index.html" rel="start" title="Top"> -<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents"> -<link href="Installation.html" rel="up" title="Installation"> -<link href="Configuring-hostname.html" rel="next" title="Configuring hostname"> -<link href="Obtaining-the-documentation.html" rel="prev" title="Obtaining the documentation"> -<style type="text/css"> -<!-- -a.summary-letter {text-decoration: none} -blockquote.indentedblock {margin-right: 0em} -div.display {margin-left: 3.2em} -div.example {margin-left: 3.2em} -div.lisp {margin-left: 3.2em} -kbd {font-style: oblique} -pre.display {font-family: inherit} -pre.format {font-family: inherit} -pre.menu-comment {font-family: serif} -pre.menu-preformatted {font-family: serif} -span.nolinebreak {white-space: nowrap} -span.roman {font-family: initial; font-weight: normal} -span.sansserif {font-family: sans-serif; font-weight: normal} -ul.no-bullet {list-style: none} ---> -</style> - - -</head> - -<body lang="en"> -<span id="System-Configuration"></span><div class="header"> -<p> -Next: <a href="Kernel.html" accesskey="n" rel="next">Kernel</a>, Previous: <a href="Chroot.html" accesskey="p" rel="prev">Chroot</a>, Up: <a href="Installation.html" accesskey="u" rel="up">Installation</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> -</div> -<hr> -<span id="System-Configuration-1"></span><h3 class="section">1.3 System Configuration</h3> - -<p>After you have finished installing some extra packages, you can configure your -system to your liking. -</p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="Configuring-hostname.html" accesskey="1">Configuring hostname</a></td><td> </td><td align="left" valign="top">Setting up system hostname (recommended) -</td></tr> -<tr><td align="left" valign="top">• <a href="Hosts-file.html" accesskey="2">Hosts file</a></td><td> </td><td align="left" valign="top">Setting up hosts file for networking (optional) -</td></tr> -</table> - - - - -</body> -</html> diff --git a/docs/docs/_002fetc_002finit_002frcconf-file.html b/docs/docs/_002fetc_002finit_002frcconf-file.html deleted file mode 100644 index 5f33c04..0000000 --- a/docs/docs/_002fetc_002finit_002frcconf-file.html +++ /dev/null @@ -1,66 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> -<html> -<!-- Copyright (C) 2020 Cem Keylan - -Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.3 or -any later version published by the Free Software Foundation; with no -Invariant Sections, with no Front-Cover Texts and no Back-Cover Texts. -A copy of the license is included in the section entitled "GNU Free -Documentation License." - --> -<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> -<title>/etc/init/rcconf file (Carbs Linux User Manual)</title> - -<meta name="description" content="/etc/init/rcconf file (Carbs Linux User Manual)"> -<meta name="keywords" content="/etc/init/rcconf file (Carbs Linux User Manual)"> -<meta name="resource-type" content="document"> -<meta name="distribution" content="global"> -<meta name="Generator" content="makeinfo"> -<link href="index.html" rel="start" title="Top"> -<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents"> -<link href="Configuring-Init.html" rel="up" title="Configuring Init"> -<link href="Init-Hooks.html" rel="next" title="Init Hooks"> -<link href="Kernel-Command-Line.html" rel="prev" title="Kernel Command Line"> -<style type="text/css"> -<!-- -a.summary-letter {text-decoration: none} -blockquote.indentedblock {margin-right: 0em} -div.display {margin-left: 3.2em} -div.example {margin-left: 3.2em} -div.lisp {margin-left: 3.2em} -kbd {font-style: oblique} -pre.display {font-family: inherit} -pre.format {font-family: inherit} -pre.menu-comment {font-family: serif} -pre.menu-preformatted {font-family: serif} -span.nolinebreak {white-space: nowrap} -span.roman {font-family: initial; font-weight: normal} -span.sansserif {font-family: sans-serif; font-weight: normal} -ul.no-bullet {list-style: none} ---> -</style> - - -</head> - -<body lang="en"> -<span id="g_t_002fetc_002finit_002frcconf-file"></span><div class="header"> -<p> -Next: <a href="Init-Hooks.html" accesskey="n" rel="next">Init Hooks</a>, Previous: <a href="Kernel-Command-Line.html" accesskey="p" rel="prev">Kernel Command Line</a>, Up: <a href="Configuring-Init.html" accesskey="u" rel="up">Configuring Init</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> -</div> -<hr> -<span id="g_t_002fetc_002finit_002frc_002econf-file"></span><h4 class="subsection">2.1.2 ‘<samp>/etc/init/rc.conf</samp>’ file</h4> - -<p>However, the kernel command line isn’t the only place to set your boot -parameters. You can specify variables here as well, although note that the -kernel command line always gets the priority for these variables since they can -be set just before boot. -</p> - - - -</body> -</html> diff --git a/docs/docs/carbslinux.html b/docs/docs/carbslinux.html new file mode 100644 index 0000000..e50d6f4 --- /dev/null +++ b/docs/docs/carbslinux.html @@ -0,0 +1,1786 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<html> +<!-- Copyright (C) 2020 Cem Keylan + +Permission is granted to copy, distribute and/or modify this document +under the terms of the GNU Free Documentation License, Version 1.3 or +any later version published by the Free Software Foundation; with no +Invariant Sections, with no Front-Cover Texts and no Back-Cover Texts. +A copy of the license is included in the section entitled "GNU Free +Documentation License." + --> +<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<title>Carbs Linux User Manual</title> + +<meta name="description" content="Carbs Linux User Manual"> +<meta name="keywords" content="Carbs Linux User Manual"> +<meta name="resource-type" content="document"> +<meta name="distribution" content="global"> +<meta name="Generator" content="makeinfo"> +<link href="#Top" rel="start" title="Top"> +<link href="#SEC_Contents" rel="contents" title="Table of Contents"> +<style type="text/css"> +<!-- +a.summary-letter {text-decoration: none} +blockquote.indentedblock {margin-right: 0em} +div.display {margin-left: 3.2em} +div.example {margin-left: 3.2em} +div.lisp {margin-left: 3.2em} +kbd {font-style: oblique} +pre.display {font-family: inherit} +pre.format {font-family: inherit} +pre.menu-comment {font-family: serif} +pre.menu-preformatted {font-family: serif} +span.nolinebreak {white-space: nowrap} +span.roman {font-family: initial; font-weight: normal} +span.sansserif {font-family: sans-serif; font-weight: normal} +ul.no-bullet {list-style: none} +--> +</style> +<link rel="stylesheet" type="text/css" href="https://www.gnu.org/software/gnulib/manual.css"> + + +</head> + +<body lang="en"> +<h1 class="settitle" align="center">Carbs Linux User Manual</h1> + + + + +<span id="SEC_Contents"></span> +<h2 class="contents-heading">Table of Contents</h2> + +<div class="contents"> + +<ul class="no-bullet"> + <li><a id="toc-Installation-1" href="#Installation">1 Installation</a> + <ul class="no-bullet"> + <li><a id="toc-Preparing-Environment-1" href="#Preparing-Environment">1.1 Preparing Environment</a> + <ul class="no-bullet"> + <li><a id="toc-Download-1" href="#Download">1.1.1 Download</a></li> + <li><a id="toc-Signature-verification-1" href="#Signature-verification">1.1.2 Signature verification</a></li> + <li><a id="toc-Extracting-the-tarball-1" href="#Extracting-the-tarball">1.1.3 Extracting the tarball</a></li> + <li><a id="toc-Obtain-the-chroot-helper-1" href="#Obtain-the-chroot-helper">1.1.4 Obtain the chroot helper</a></li> + </ul></li> + <li><a id="toc-Chroot-1" href="#Chroot">1.2 Chroot</a> + <ul class="no-bullet"> + <li><a id="toc-Setting-up-repositories-1" href="#Setting-up-repositories">1.2.1 Setting up repositories</a></li> + <li><a id="toc-Updating-packages-1" href="#Updating-packages">1.2.2 Updating packages</a></li> + <li><a id="toc-Installing-packages-1" href="#Installing-packages">1.2.3 Installing packages</a></li> + <li><a id="toc-Essential-Software-1" href="#Essential-Software">1.2.4 Essential Software</a></li> + <li><a id="toc-Obtaining-the-documentation-1" href="#Obtaining-the-documentation">1.2.5 Obtaining the documentation</a></li> + </ul></li> + <li><a id="toc-System-Configuration-1" href="#System-Configuration">1.3 System Configuration</a> + <ul class="no-bullet"> + <li><a id="toc-Configuring-hostname-1" href="#Configuring-hostname">1.3.1 Configuring hostname</a></li> + <li><a id="toc-Hosts-file-1" href="#Hosts-file">1.3.2 Hosts file</a></li> + </ul></li> + <li><a id="toc-Kernel-1" href="#Kernel">1.4 Kernel</a> + <ul class="no-bullet"> + <li><a id="toc-Obtaining-the-kernel-sources-1" href="#Obtaining-the-kernel-sources">1.4.1 Obtaining the kernel sources</a></li> + <li><a id="toc-Kernel-dependencies-1" href="#Kernel-dependencies">1.4.2 Kernel dependencies</a></li> + <li><a id="toc-Building-the-kernel-1" href="#Building-the-kernel">1.4.3 Building the kernel</a></li> + </ul></li> + <li><a id="toc-Making-your-system-bootable-1" href="#Making-your-system-bootable">1.5 Making your system bootable</a> + <ul class="no-bullet"> + <li><a id="toc-Bootloader-1" href="#Bootloader">1.5.1 Bootloader</a></li> + <li><a id="toc-Init-scripts-1" href="#Init-scripts">1.5.2 Init scripts</a></li> + <li><a id="toc-Fstab-1" href="#Fstab">1.5.3 Fstab</a></li> + </ul></li> + <li><a id="toc-Post_002dinstallation-1" href="#Post_002dinstallation">1.6 Post-installation</a> + <ul class="no-bullet"> + <li><a id="toc-KISS-repositories-1" href="#KISS-repositories">1.6.1 KISS repositories</a></li> + </ul></li> + </ul></li> + <li><a id="toc-Init-System-1" href="#Init-System">2 Init System</a> + <ul class="no-bullet"> + <li><a id="toc-Configuring-Init-1" href="#Configuring-Init">2.1 Configuring Init</a> + <ul class="no-bullet"> + <li><a id="toc-Kernel-Command-Line-1" href="#Kernel-Command-Line">2.1.1 Kernel Command Line</a></li> + <li><a id="toc-_002fetc_002finit_002frc_002econf-file" href="#g_t_002fetc_002finit_002frcconf-file">2.1.2 ‘<samp>/etc/init/rc.conf</samp>’ file</a></li> + <li><a id="toc-Init-Hooks-1" href="#Init-Hooks">2.1.3 Init Hooks</a></li> + </ul></li> + <li><a id="toc-Changing-Init-Program-1" href="#Changing-Init-Program">2.2 Changing Init Program</a> + <ul class="no-bullet"> + <li><a id="toc-Rebooting-after-changing-init-1" href="#Rebooting-after-changing-init">2.2.1 Rebooting after changing init</a></li> + </ul></li> + </ul></li> + <li><a id="toc-Contribution-Guidelines-1" href="#Contribution-Guidelines">3 Contribution Guidelines</a> + <ul class="no-bullet"> + <li><a id="toc-Conventions-1" href="#Conventions">3.1 Conventions</a> + <ul class="no-bullet"> + <li><a id="toc-Shell-Conventions-1" href="#Shell-Conventions">3.1.1 Shell Conventions</a></li> + <li><a id="toc-Repository-Conventions-1" href="#Repository-Conventions">3.1.2 Repository Conventions</a></li> + </ul></li> + </ul></li> + <li><a id="toc-GNU-Free-Documentation-License-1" href="#GNU-Free-Documentation-License">Appendix A GNU Free Documentation License</a> + <ul class="no-bullet"> + <li><a id="toc-ADDENDUM_003a-How-to-use-this-License-for-your-documents" href="#ADDENDUM_003a-How-to-use-this-License-for-your-documents">A.1 ADDENDUM: How to use this License for your documents</a></li> + </ul></li> +</ul> +</div> + + +<span id="Top"></span><div class="header"> +<p> +Next: <a href="#Installation" accesskey="n" rel="next">Installation</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> +</div> +<span id="Carbs-Linux-User-Manual"></span><h1 class="top">Carbs Linux User Manual</h1> + +<p>This is the full documentation of <a href="https://carbslinux.org">Carbs Linux</a>, from the details of the +distribution, installation, to the package manager. It is not yet complete. +</p> + +<p>This documentation is also available in the distribution by the +<code>carbs-docs</code> package, which can be read by either running +<code>info carbslinux</code> or reading <samp>/usr/share/doc/carbslinux.txt</samp> with your +favorite pager. You can install either the <code>info</code> or <code>texinfo</code> +for doing the first. +</p> +<table class="menu" border="0" cellspacing="0"> +<tr><td align="left" valign="top">• <a href="#Installation" accesskey="1">Installation</a></td><td> </td><td align="left" valign="top">Installing Carbs Linux +</td></tr> +<tr><td align="left" valign="top">• <a href="#Init-System" accesskey="2">Init System</a></td><td> </td><td align="left" valign="top">Configure the init system +</td></tr> +<tr><td align="left" valign="top">• <a href="#Contribution-Guidelines" accesskey="3">Contribution Guidelines</a></td><td> </td><td align="left" valign="top">Contribute to Carbs Linux +</td></tr> +<tr><td align="left" valign="top">• <a href="#GNU-Free-Documentation-License" accesskey="4">GNU Free Documentation License</a></td><td> </td><td align="left" valign="top">Your rights +</td></tr> +<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> + +</pre></th></tr><tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">— The Detailed Node Listing — + +Installation + +</pre></th></tr><tr><td align="left" valign="top">• <a href="#Preparing-Environment" accesskey="5">Preparing Environment</a></td><td> </td><td align="left" valign="top">Getting ready to chroot +</td></tr> +<tr><td align="left" valign="top">• <a href="#Chroot" accesskey="6">Chroot</a></td><td> </td><td align="left" valign="top">Going inside your new system +</td></tr> +<tr><td align="left" valign="top">• <a href="#System-Configuration" accesskey="7">System Configuration</a></td><td> </td><td align="left" valign="top">Customizing your system for personal use +</td></tr> +<tr><td align="left" valign="top">• <a href="#Kernel" accesskey="8">Kernel</a></td><td> </td><td align="left" valign="top">Compiling your own kernel +</td></tr> +<tr><td align="left" valign="top">• <a href="#Making-your-system-bootable" accesskey="9">Making your system bootable</a></td><td> </td><td align="left" valign="top">Installing bootloader and boot scripts +</td></tr> +<tr><td align="left" valign="top">• <a href="#Post_002dinstallation">Post-installation</a></td><td> </td><td align="left" valign="top">Post-installation tasks +</td></tr> +<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> + +Preparing Environment + +</pre></th></tr><tr><td align="left" valign="top">• <a href="#Download">Download</a></td><td> </td><td align="left" valign="top">Download the root filesystem tarball +</td></tr> +<tr><td align="left" valign="top">• <a href="#Signature-verification">Signature verification</a></td><td> </td><td align="left" valign="top">Verify the signature of the rootfs tarball +</td></tr> +<tr><td align="left" valign="top">• <a href="#Extracting-the-tarball">Extracting the tarball</a></td><td> </td><td align="left" valign="top">Extracting the root filesystem to the desired location +</td></tr> +<tr><td align="left" valign="top">• <a href="#Obtain-the-chroot-helper">Obtain the chroot helper</a></td><td> </td><td align="left" valign="top">Download the script to easily chroot into the new filesystem +</td></tr> +<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> + +Chroot + +</pre></th></tr><tr><td align="left" valign="top">• <a href="#Setting-up-repositories">Setting up repositories</a></td><td> </td><td align="left" valign="top">Basic setup for obtaining repositories +</td></tr> +<tr><td align="left" valign="top">• <a href="#Updating-packages">Updating packages</a></td><td> </td><td align="left" valign="top">Update your system +</td></tr> +<tr><td align="left" valign="top">• <a href="#Installing-packages">Installing packages</a></td><td> </td><td align="left" valign="top">Install new software on your system +</td></tr> +<tr><td align="left" valign="top">• <a href="#Essential-Software">Essential Software</a></td><td> </td><td align="left" valign="top">Software you might want to include on your system +</td></tr> +<tr><td align="left" valign="top">• <a href="#Obtaining-the-documentation">Obtaining the documentation</a></td><td> </td><td align="left" valign="top">Install documentation for offline use (optional) +</td></tr> +<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> + +System Configuration + +</pre></th></tr><tr><td align="left" valign="top">• <a href="#Configuring-hostname">Configuring hostname</a></td><td> </td><td align="left" valign="top">Setting up system hostname (recommended) +</td></tr> +<tr><td align="left" valign="top">• <a href="#Hosts-file">Hosts file</a></td><td> </td><td align="left" valign="top">Setting up hosts file for networking (optional) +</td></tr> +<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> + +Kernel + +</pre></th></tr><tr><td align="left" valign="top">• <a href="#Obtaining-the-kernel-sources">Obtaining the kernel sources</a></td><td> </td><td align="left" valign="top">Downloading the Linux source code +</td></tr> +<tr><td align="left" valign="top">• <a href="#Kernel-dependencies">Kernel dependencies</a></td><td> </td><td align="left" valign="top">Requirements for building the kernel +</td></tr> +<tr><td align="left" valign="top">• <a href="#Building-the-kernel">Building the kernel</a></td><td> </td><td align="left" valign="top">Configure and compile the kernel +</td></tr> +<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> + +Making your system bootable + +</pre></th></tr><tr><td align="left" valign="top">• <a href="#Bootloader">Bootloader</a></td><td> </td><td align="left" valign="top">Install a bootloader for your system +</td></tr> +<tr><td align="left" valign="top">• <a href="#Init-scripts">Init scripts</a></td><td> </td><td align="left" valign="top">Install init scripts for your system +</td></tr> +<tr><td align="left" valign="top">• <a href="#Fstab">Fstab</a></td><td> </td><td align="left" valign="top">Generating fstab +</td></tr> +<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> + +Post-installation + +</pre></th></tr><tr><td align="left" valign="top">• <a href="#KISS-repositories">KISS repositories</a></td><td> </td><td align="left" valign="top">Acquire kiss repositories +</td></tr> +<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> + +Init System + +</pre></th></tr><tr><td align="left" valign="top">• <a href="#Configuring-Init">Configuring Init</a></td><td> </td><td align="left" valign="top">Ways to configure the init system +</td></tr> +<tr><td align="left" valign="top">• <a href="#Changing-Init-Program">Changing Init Program</a></td><td> </td><td align="left" valign="top">Replace the default busybox init with something new +</td></tr> +<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> + +Configuring Init + +</pre></th></tr><tr><td align="left" valign="top">• <a href="#Kernel-Command-Line">Kernel Command Line</a></td><td> </td><td align="left" valign="top">Configure init through the boot parameters +</td></tr> +<tr><td align="left" valign="top">• <a href="#g_t_002fetc_002finit_002frcconf-file">‘<samp>/etc/init/rc.conf</samp>’ file</a></td><td> </td><td align="left" valign="top">Configure init through the configuration file +</td></tr> +<tr><td align="left" valign="top">• <a href="#Init-Hooks">Init Hooks</a></td><td> </td><td align="left" valign="top">Configure init through hooks +</td></tr> +<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> + +Changing Init Program + +</pre></th></tr><tr><td align="left" valign="top">• <a href="#Rebooting-after-changing-init">Rebooting after changing init</a></td><td> </td><td align="left" valign="top">Ways to reboot after replacing the init system +</td></tr> +<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> + +Contribution Guidelines + +</pre></th></tr><tr><td align="left" valign="top">• <a href="#Conventions">Conventions</a></td><td> </td><td align="left" valign="top">Conventions of the distribution +</td></tr> +<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> + +Conventions + +</pre></th></tr><tr><td align="left" valign="top">• <a href="#Shell-Conventions">Shell Conventions</a></td><td> </td><td align="left" valign="top">Conventions for shell scripts +</td></tr> +<tr><td align="left" valign="top">• <a href="#Repository-Conventions">Repository Conventions</a></td><td> </td><td align="left" valign="top">Conventions for repository build scripts +</td></tr> +<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> + +</pre></th></tr></table> + +<hr> +<span id="Installation"></span><div class="header"> +<p> +Next: <a href="#Init-System" accesskey="n" rel="next">Init System</a>, Previous: <a href="#Top" accesskey="p" rel="prev">Top</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> +</div> +<span id="Installation-1"></span><h2 class="chapter">1 Installation</h2> + +<p>These are the step-by-step instructions for installing Carbs Linux. It can be +acquired as plain-text to be viewed offline with a pager from +<a href="https://carbslinux.org/install.txt">https://carbslinux.org/install.txt</a>. +</p> +<div class="example"> +<pre class="example">curl -sL https://carbslinux.org/install.txt | less +</pre></div> + +<table class="menu" border="0" cellspacing="0"> +<tr><td align="left" valign="top">• <a href="#Preparing-Environment" accesskey="1">Preparing Environment</a></td><td> </td><td align="left" valign="top">Getting ready to chroot +</td></tr> +<tr><td align="left" valign="top">• <a href="#Chroot" accesskey="2">Chroot</a></td><td> </td><td align="left" valign="top">Going inside your new system +</td></tr> +<tr><td align="left" valign="top">• <a href="#System-Configuration" accesskey="3">System Configuration</a></td><td> </td><td align="left" valign="top">Customizing your system for personal use +</td></tr> +<tr><td align="left" valign="top">• <a href="#Kernel" accesskey="4">Kernel</a></td><td> </td><td align="left" valign="top">Compiling your own kernel +</td></tr> +<tr><td align="left" valign="top">• <a href="#Making-your-system-bootable" accesskey="5">Making your system bootable</a></td><td> </td><td align="left" valign="top">Installing bootloader and boot scripts +</td></tr> +<tr><td align="left" valign="top">• <a href="#Post_002dinstallation" accesskey="6">Post-installation</a></td><td> </td><td align="left" valign="top">Post-installation tasks +</td></tr> +</table> + +<hr> +<span id="Preparing-Environment"></span><div class="header"> +<p> +Next: <a href="#Chroot" accesskey="n" rel="next">Chroot</a>, Up: <a href="#Installation" accesskey="u" rel="up">Installation</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> +</div> +<span id="Preparing-Environment-1"></span><h3 class="section">1.1 Preparing Environment</h3> + +<p>To install Carbs Linux, you will need a Live Linux ISO. For that purpose, you +can obtain a Gentoo or Void Linux live image. You can follow their instructions +to boot and setup your network. +</p> +<p>You will need the following programs in order to install Carbs Linux: +</p> +<ul> +<li> tar +</li><li> wget +</li><li> xz +</li><li> some form of base utilities (coreutils, sbase, busybox, etc.) +</li></ul> + +<p>Rest of these instructions will assume that you have set all of these up, and +will continue on that point. +</p> +<table class="menu" border="0" cellspacing="0"> +<tr><td align="left" valign="top">• <a href="#Download" accesskey="1">Download</a></td><td> </td><td align="left" valign="top">Download the root filesystem tarball +</td></tr> +<tr><td align="left" valign="top">• <a href="#Signature-verification" accesskey="2">Signature verification</a></td><td> </td><td align="left" valign="top">Verify the signature of the rootfs tarball +</td></tr> +<tr><td align="left" valign="top">• <a href="#Extracting-the-tarball" accesskey="3">Extracting the tarball</a></td><td> </td><td align="left" valign="top">Extracting the root filesystem to the desired location +</td></tr> +<tr><td align="left" valign="top">• <a href="#Obtain-the-chroot-helper" accesskey="4">Obtain the chroot helper</a></td><td> </td><td align="left" valign="top">Download the script to easily chroot into the new filesystem +</td></tr> +</table> + +<hr> +<span id="Download"></span><div class="header"> +<p> +Next: <a href="#Signature-verification" accesskey="n" rel="next">Signature verification</a>, Up: <a href="#Preparing-Environment" accesskey="u" rel="up">Preparing Environment</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> +</div> +<span id="Download-1"></span><h4 class="subsection">1.1.1 Download</h4> + +<p>First, we need to download the rootfs tarball. You can do the following in order +to obtain the rootfs. If you are using an i686 machine, replace the ‘<samp>x86_64</samp>’ +with ‘<samp>i686</samp>’. We are setting this in a URL variable so that we don’t have to +write it every time. +</p> +<div class="example"> +<pre class="example">wget $URL/carbs-rootfs.tar.xz.sha256 +sha256sum -c carbs-rootfs.tar.xz.sha256 +</pre></div> + +<hr> +<span id="Signature-verification"></span><div class="header"> +<p> +Next: <a href="#Extracting-the-tarball" accesskey="n" rel="next">Extracting the tarball</a>, Previous: <a href="#Download" accesskey="p" rel="prev">Download</a>, Up: <a href="#Preparing-Environment" accesskey="u" rel="up">Preparing Environment</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> +</div> +<span id="Signature-verification-1"></span><h4 class="subsection">1.1.2 Signature verification</h4> + +<p>It is highly recommended to verify the signature of the tarball. You will need +GPG for this. +</p> +<div class="example"> +<pre class="example">wget $URL/carbs-rootfs.tar.xz.sig +gpg --recv-keys FF484BDFEFCEF8FF +gpg --verify carbs-rootfs.tar.xz.sig +</pre></div> + +<hr> +<span id="Extracting-the-tarball"></span><div class="header"> +<p> +Next: <a href="#Obtain-the-chroot-helper" accesskey="n" rel="next">Obtain the chroot helper</a>, Previous: <a href="#Signature-verification" accesskey="p" rel="prev">Signature verification</a>, Up: <a href="#Preparing-Environment" accesskey="u" rel="up">Preparing Environment</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> +</div> +<span id="Extracting-the-tarball-1"></span><h4 class="subsection">1.1.3 Extracting the tarball</h4> + +<p>You will need to extract the tarball to your desired location. For partitioning, +you can follow <a href="https://wiki.archlinux.org/index.php/Partitioning">this guide</a>. This will assume that you will be mounting your root +partition to ‘<samp>/mnt</samp>’. +</p> +<div class="example"> +<pre class="example">mount /dev/sdx1 /mnt +tar xf carbs-rootfs.tar.xz -C /mnt +</pre></div> + +<hr> +<span id="Obtain-the-chroot-helper"></span><div class="header"> +<p> +Previous: <a href="#Extracting-the-tarball" accesskey="p" rel="prev">Extracting the tarball</a>, Up: <a href="#Preparing-Environment" accesskey="u" rel="up">Preparing Environment</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> +</div> +<span id="Obtain-the-chroot-helper-1"></span><h4 class="subsection">1.1.4 Obtain the chroot helper</h4> + +<p>You can obtain the ‘<samp>cpt-chroot</samp>’ script in order to do a simple chroot into your +new root filesystem. +</p> +<div class="example"> +<pre class="example">wget https://dl.carbslinux.org/distfiles/cpt-chroot +chmod a+x cpt-chroot +</pre></div> + +<hr> +<span id="Chroot"></span><div class="header"> +<p> +Next: <a href="#System-Configuration" accesskey="n" rel="next">System Configuration</a>, Previous: <a href="#Preparing-Environment" accesskey="p" rel="prev">Preparing Environment</a>, Up: <a href="#Installation" accesskey="u" rel="up">Installation</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> +</div> +<span id="Chroot-1"></span><h3 class="section">1.2 Chroot</h3> + +<p>Chroot into Carbs Linux! +</p> +<div class="example"> +<pre class="example">./cpt-chroot /mnt +</pre></div> + +<table class="menu" border="0" cellspacing="0"> +<tr><td align="left" valign="top">• <a href="#Setting-up-repositories" accesskey="1">Setting up repositories</a></td><td> </td><td align="left" valign="top">Basic setup for obtaining repositories +</td></tr> +<tr><td align="left" valign="top">• <a href="#Updating-packages" accesskey="2">Updating packages</a></td><td> </td><td align="left" valign="top">Update your system +</td></tr> +<tr><td align="left" valign="top">• <a href="#Installing-packages" accesskey="3">Installing packages</a></td><td> </td><td align="left" valign="top">Install new software on your system +</td></tr> +<tr><td align="left" valign="top">• <a href="#Essential-Software" accesskey="4">Essential Software</a></td><td> </td><td align="left" valign="top">Software you might want to include on your system +</td></tr> +<tr><td align="left" valign="top">• <a href="#Obtaining-the-documentation" accesskey="5">Obtaining the documentation</a></td><td> </td><td align="left" valign="top">Install documentation for offline use (optional) +</td></tr> +</table> + +<hr> +<span id="Setting-up-repositories"></span><div class="header"> +<p> +Next: <a href="#Updating-packages" accesskey="n" rel="next">Updating packages</a>, Up: <a href="#Chroot" accesskey="u" rel="up">Chroot</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> +</div> +<span id="Setting-up-repositories-1"></span><h4 class="subsection">1.2.1 Setting up repositories</h4> + +<p>Newest tarballs do not come with repositories, so you will need to manually +obtain them, and set your ‘<samp>CPT_PATH</samp>’ environment variable. Carbs Linux +repositories can either be obtained by ‘<samp>git</samp>’ or ‘<samp>rsync</samp>’. While rsync +repositories are overall faster and smaller, git offers the whole history of the +repository and a means to manipulate your repository as you like it. If you want +to obtain the git repository, you will need to install ‘<samp>git</samp>’ itself. +</p> +<p>The following guide will assume that you put the repositories into ‘<samp>~/repos/</samp>’ +directory, but you can put the repositories into any directory you want. So go +ahead and create that directory: +</p> +<div class="example"> +<pre class="example">mkdir -p $HOME/repos +</pre></div> + +<ol> +<li> Obtaining from git + + +<p>Carbs Linux git repositories can be found both from the main server and GitHub +(mirror). Here are both their repository links. You can clone any of them. +</p> +<ul> +<li> git://git.carbslinux.org/repository +</li><li> <a href="https://github.com/carbslinux/repository">https://github.com/carbslinux/repository</a> +</li></ul> + +<div class="example"> +<pre class="example">git clone git://git.carbslinux.org/repository $HOME/repos/carbs +</pre></div> + +</li><li> Obtaining from rsync + + +<p>Carbs Linux rsync repositories live in rsync://carbslinux.org/repo. In +order to obtain it, run the following: +</p> +<div class="example"> +<pre class="example">rsync -avc rsync://carbslinux.org/repo $HOME/repos/carbs +</pre></div> + +</li><li> Making the package manager use the repositories + + +<p>In your shell’s configuration file, or in your ‘<samp>~/.profile</samp>’ file, add the +following lines: +</p> +<div class="example"> +<pre class="example">CPT_PATH=$HOME/repos/carbs/core +CPT_PATH=$CPT_PATH:$HOME/repos/carbs/extra +CPT_PATH=$CPT_PATH:$HOME/repos/carbs/xorg +CPT_PATH=$CPT_PATH:$HOME/repos/carbs/community +export CPT_PATH +</pre></div> +</li></ol> + +<hr> +<span id="Updating-packages"></span><div class="header"> +<p> +Next: <a href="#Installing-packages" accesskey="n" rel="next">Installing packages</a>, Previous: <a href="#Setting-up-repositories" accesskey="p" rel="prev">Setting up repositories</a>, Up: <a href="#Chroot" accesskey="u" rel="up">Chroot</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> +</div> +<span id="Updating-packages-1"></span><h4 class="subsection">1.2.2 Updating packages</h4> + +<p>It is good practice to make sure your system is up to date, especially before +building new packages. If there is an update for the package manager you will +need to update twice. +</p> +<div class="example"> +<pre class="example">cpt-update && cpt-update +</pre></div> + +<hr> +<span id="Installing-packages"></span><div class="header"> +<p> +Next: <a href="#Essential-Software" accesskey="n" rel="next">Essential Software</a>, Previous: <a href="#Updating-packages" accesskey="p" rel="prev">Updating packages</a>, Up: <a href="#Chroot" accesskey="u" rel="up">Chroot</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> +</div> +<span id="Installing-packages-1"></span><h4 class="subsection">1.2.3 Installing packages</h4> + +<p>Since you are operating on a really small base, you might need to build and +install new programs to extend the functionality of your system. In order to +build and install packages new packages in Carbs, you need to execute the +following. "Package" is not actually a package and is given as an example. +</p> +<div class="example"> +<pre class="example">cpt-build package +cpt-install package +</pre></div> + +<hr> +<span id="Essential-Software"></span><div class="header"> +<p> +Next: <a href="#Obtaining-the-documentation" accesskey="n" rel="next">Obtaining the documentation</a>, Previous: <a href="#Installing-packages" accesskey="p" rel="prev">Installing packages</a>, Up: <a href="#Chroot" accesskey="u" rel="up">Chroot</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> +</div> +<span id="Essential-Software-1"></span><h4 class="subsection">1.2.4 Essential Software</h4> + +<p>Here is a list of software that you might want to have on your system. +</p> +<p><strong>BOOTLOADERS</strong> +</p> +<ul> +<li> efibootmgr +</li><li> grub +</li></ul> + +<p><strong>FILESYSTEMS</strong> +</p> +<ul> +<li> e2fsprogs +</li><li> dosfstools +</li><li> ntfs-3g +</li></ul> + +<p><strong>NETWORKING</strong> +</p> +<ul> +<li> dhcpcd +</li><li> wpa<em>_supplicant</em> +</li></ul> + +<p><strong>TEXT EDITORS</strong> +</p> +<ul> +<li> nano +</li><li> vim +</li><li> neatvi +</li><li> emacs +</li><li> emacs-nox (terminal-only version of emacs) +</li></ul> + +<p><strong>USER SHELLS</strong> +</p> +<ul> +<li> bash +</li><li> zsh +</li><li> oksh +</li><li> rc +</li></ul> + +<p><strong>POSIX BASE UTILITIES</strong> +</p> +<ul> +<li> busybox +</li><li> sbase +</li><li> coreutils +</li></ul> + +<p><strong>DOCUMENTATION</strong> +</p> +<ul> +<li> carbs-docs +</li><li> man-pages +</li><li> man-pages-posix +</li></ul> + +<hr> +<span id="Obtaining-the-documentation"></span><div class="header"> +<p> +Previous: <a href="#Essential-Software" accesskey="p" rel="prev">Essential Software</a>, Up: <a href="#Chroot" accesskey="u" rel="up">Chroot</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> +</div> +<span id="Obtaining-the-documentation-1"></span><h4 class="subsection">1.2.5 Obtaining the documentation</h4> + +<p>All the documentation for Carbs Linux can be found on a single info manual to be +viewed offline. You can obtain texinfo or the info (standalone) package in order +to view the documentation. +</p> +<div class="example"> +<pre class="example"># Install the documentation. +cpt b carbs-docs && cpt i carbs-docs + +# Install either texinfo or the info package. We will be installing standalone info +# as it doesn't need perl. +cpt b info && cpt i info + +# You can then run info and navigate through the documentation. +info carbslinux +</pre></div> + +<hr> +<span id="System-Configuration"></span><div class="header"> +<p> +Next: <a href="#Kernel" accesskey="n" rel="next">Kernel</a>, Previous: <a href="#Chroot" accesskey="p" rel="prev">Chroot</a>, Up: <a href="#Installation" accesskey="u" rel="up">Installation</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> +</div> +<span id="System-Configuration-1"></span><h3 class="section">1.3 System Configuration</h3> + +<p>After you have finished installing some extra packages, you can configure your +system to your liking. +</p> +<table class="menu" border="0" cellspacing="0"> +<tr><td align="left" valign="top">• <a href="#Configuring-hostname" accesskey="1">Configuring hostname</a></td><td> </td><td align="left" valign="top">Setting up system hostname (recommended) +</td></tr> +<tr><td align="left" valign="top">• <a href="#Hosts-file" accesskey="2">Hosts file</a></td><td> </td><td align="left" valign="top">Setting up hosts file for networking (optional) +</td></tr> +</table> + +<hr> +<span id="Configuring-hostname"></span><div class="header"> +<p> +Next: <a href="#Hosts-file" accesskey="n" rel="next">Hosts file</a>, Up: <a href="#System-Configuration" accesskey="u" rel="up">System Configuration</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> +</div> +<span id="Configuring-hostname-1"></span><h4 class="subsection">1.3.1 Configuring hostname</h4> + +<p>You might want to add a hostname, especially in a networked environment. Your +hostname will default to ’carbslinux’ unless you set this. +</p> +<div class="example"> +<pre class="example">echo your-hostname > /etc/hostname +</pre></div> + +<hr> +<span id="Hosts-file"></span><div class="header"> +<p> +Previous: <a href="#Configuring-hostname" accesskey="p" rel="prev">Configuring hostname</a>, Up: <a href="#System-Configuration" accesskey="u" rel="up">System Configuration</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> +</div> +<span id="Hosts-file-1"></span><h4 class="subsection">1.3.2 Hosts file</h4> + +<p>You can edit your /etc/hosts file, which is the static lookup table for host +names. By default, there are two entries for localhost which are OKAY. You can +replace the ’localhost’ part of these entries to your hostname. +</p> +<div class="example"> +<pre class="example">127.0.0.1 localhost.localdomain localhost +::1 localhost.localdomain localhost ip6-localhost +</pre></div> + +<hr> +<span id="Kernel"></span><div class="header"> +<p> +Next: <a href="#Making-your-system-bootable" accesskey="n" rel="next">Making your system bootable</a>, Previous: <a href="#System-Configuration" accesskey="p" rel="prev">System Configuration</a>, Up: <a href="#Installation" accesskey="u" rel="up">Installation</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> +</div> +<span id="Kernel-1"></span><h3 class="section">1.4 Kernel</h3> + +<p>Kernel isn’t managed under the main repositories, even though you could package +one for your personal use. Here is an <a href="https://github.com/cemkeylan/kiss-repository/tree/master/personal/linux">example kernel package</a>, which you will +need to reconfigure for your specific setup if you want to make use of it. +</p> +<table class="menu" border="0" cellspacing="0"> +<tr><td align="left" valign="top">• <a href="#Obtaining-the-kernel-sources" accesskey="1">Obtaining the kernel sources</a></td><td> </td><td align="left" valign="top">Downloading the Linux source code +</td></tr> +<tr><td align="left" valign="top">• <a href="#Kernel-dependencies" accesskey="2">Kernel dependencies</a></td><td> </td><td align="left" valign="top">Requirements for building the kernel +</td></tr> +<tr><td align="left" valign="top">• <a href="#Building-the-kernel" accesskey="3">Building the kernel</a></td><td> </td><td align="left" valign="top">Configure and compile the kernel +</td></tr> +</table> + +<hr> +<span id="Obtaining-the-kernel-sources"></span><div class="header"> +<p> +Next: <a href="#Kernel-dependencies" accesskey="n" rel="next">Kernel dependencies</a>, Up: <a href="#Kernel" accesskey="u" rel="up">Kernel</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> +</div> +<span id="Obtaining-the-kernel-sources-1"></span><h4 class="subsection">1.4.1 Obtaining the kernel sources</h4> + +<p>You can visit the <a href="https://kernel.org">https://kernel.org</a> website to choose a kernel that you want +to install. Though only the latest stable and longterm (LTS) versions are +supported. +</p> +<div class="example"> +<pre class="example"># Download the kernel and extract it +wget https://cdn.kernel.org/pub/linux/kernel/v5.x/linux-5.9.1.tar.xz +tar xf linux-5.9.1.tar.xz + +# Change directory into the kernel sources +cd linux-5.9.1 +</pre></div> + +<hr> +<span id="Kernel-dependencies"></span><div class="header"> +<p> +Next: <a href="#Building-the-kernel" accesskey="n" rel="next">Building the kernel</a>, Previous: <a href="#Obtaining-the-kernel-sources" accesskey="p" rel="prev">Obtaining the kernel sources</a>, Up: <a href="#Kernel" accesskey="u" rel="up">Kernel</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> +</div> +<span id="Kernel-dependencies-1"></span><h4 class="subsection">1.4.2 Kernel dependencies</h4> + +<p>In order to compile the kernel you will need to install some dependencies. You +will need ‘<samp>libelf</samp>’, and ‘<samp>bison</samp>’ to compile the kernel. If you want to configure +using the menu interface you will also need ‘<samp>ncurses</samp>’. +</p> +<div class="example"> +<pre class="example"># The package manager asks to install if you are building more than one package, +# so no need to run 'cpt i ...' +cpt b libelf ncurses +</pre></div> + +<p>In the vanilla kernel sources, you need perl to compile the kernel, but it can +be easily patched out. You will need to apply the following patch. Patch was +written by <a href="https://github.com/E5ten">E5ten</a>. You will need to obtain and apply the patch in the kernel +source directory. +</p> +<div class="example"> +<pre class="example">wget https://dl.carbslinux.org/distfiles/kernel-no-perl.patch +patch -p1 < kernel-no-perl.patch +</pre></div> + +<hr> +<span id="Building-the-kernel"></span><div class="header"> +<p> +Previous: <a href="#Kernel-dependencies" accesskey="p" rel="prev">Kernel dependencies</a>, Up: <a href="#Kernel" accesskey="u" rel="up">Kernel</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> +</div> +<span id="Building-the-kernel-1"></span><h4 class="subsection">1.4.3 Building the kernel</h4> + +<p>Next step is configuring and building the kernel. You can check Gentoo’s +<a href="https://wiki.gentoo.org/wiki/Kernel/Configuration">kernel configuration guide</a> to learn more about the matter. Overall, Gentoo Wiki +is a good place to learn about configuration according to your hardware. The +following will assume a monolithic kernel. +</p> +<div class="example"> +<pre class="example">make menuconfig +make +install -Dm755 $(make -s image_name) /boot/vmlinuz-linux +</pre></div> + +<hr> +<span id="Making-your-system-bootable"></span><div class="header"> +<p> +Next: <a href="#Post_002dinstallation" accesskey="n" rel="next">Post-installation</a>, Previous: <a href="#Kernel" accesskey="p" rel="prev">Kernel</a>, Up: <a href="#Installation" accesskey="u" rel="up">Installation</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> +</div> +<span id="Making-your-system-bootable-1"></span><h3 class="section">1.5 Making your system bootable</h3> + +<p>In order to be able to boot your fresh system, wou will need an init-daemon, +init-scripts and a bootloader. The init daemon is already provided by busybox, +but you can optionally change it. +</p> +<table class="menu" border="0" cellspacing="0"> +<tr><td align="left" valign="top">• <a href="#Bootloader" accesskey="1">Bootloader</a></td><td> </td><td align="left" valign="top">Install a bootloader for your system +</td></tr> +<tr><td align="left" valign="top">• <a href="#Init-scripts" accesskey="2">Init scripts</a></td><td> </td><td align="left" valign="top">Install init scripts for your system +</td></tr> +<tr><td align="left" valign="top">• <a href="#Fstab" accesskey="3">Fstab</a></td><td> </td><td align="left" valign="top">Generating fstab +</td></tr> +</table> + +<hr> +<span id="Bootloader"></span><div class="header"> +<p> +Next: <a href="#Init-scripts" accesskey="n" rel="next">Init scripts</a>, Up: <a href="#Making-your-system-bootable" accesskey="u" rel="up">Making your system bootable</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> +</div> +<span id="Bootloader-1"></span><h4 class="subsection">1.5.1 Bootloader</h4> + +<p>In the main repository, there is efibootmgr and grub to serve as bootloaders. +efibootmgr can be used as a standalone bootloader, or can be used to install +grub in a UEFI environment. efibootmgr is needed unless you are using a device +without UEFI support (or you really want to use BIOS for a reason). +</p> +<ol> +<li> GRUB BIOS installation + + +<div class="example"> +<pre class="example">cpt b grub && cpt i grub +grub-install --target=i386-pc /dev/sdX +grub-mkconfig -o /boot/grub/grub.cfg +</pre></div> + +</li><li> GRUB UEFI installation + + +<div class="example"> +<pre class="example">cpt b efibootmgr && cpt i efibootmgr +cpt b grub && cpt i grub + +grub-install --target=x86_64-efi \ + --efi-directory=esp \ + --bootloader-id=CarbsLinux + +grub-mkconfig -o /boot/grub/grub.cfg +</pre></div> +</li></ol> + +<hr> +<span id="Init-scripts"></span><div class="header"> +<p> +Next: <a href="#Fstab" accesskey="n" rel="next">Fstab</a>, Previous: <a href="#Bootloader" accesskey="p" rel="prev">Bootloader</a>, Up: <a href="#Making-your-system-bootable" accesskey="u" rel="up">Making your system bootable</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> +</div> +<span id="Init-scripts-1"></span><h4 class="subsection">1.5.2 Init scripts</h4> + +<p>Only thing left to do is installing the init-scripts, and now you are almost +ready to boot your system! +</p> +<div class="example"> +<pre class="example">cpt b carbs-init && cpt i carbs-init +</pre></div> + +<hr> +<span id="Fstab"></span><div class="header"> +<p> +Previous: <a href="#Init-scripts" accesskey="p" rel="prev">Init scripts</a>, Up: <a href="#Making-your-system-bootable" accesskey="u" rel="up">Making your system bootable</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> +</div> +<span id="Fstab-1"></span><h4 class="subsection">1.5.3 Fstab</h4> + +<p>You can now manually edit your fstab entry, or you can use the genfstab tool. +If you want to use the tool, exit the chroot and run the following: +</p> +<div class="example"> +<pre class="example">wget https://github.com/cemkeylan/genfstab/raw/master/genfstab +chmod +x genfstab +./genfstab -U /mnt >> /mnt/etc/fstab +</pre></div> + +<hr> +<span id="Post_002dinstallation"></span><div class="header"> +<p> +Previous: <a href="#Making-your-system-bootable" accesskey="p" rel="prev">Making your system bootable</a>, Up: <a href="#Installation" accesskey="u" rel="up">Installation</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> +</div> +<span id="Post_002dinstallation-1"></span><h3 class="section">1.6 Post-installation</h3> + +<p>The base installation is now complete, you can now fine tune your system +according to your needs. Rest of these instructions are completely optional. +You can check the rest of the documentation to learn more about the system. +</p> +<table class="menu" border="0" cellspacing="0"> +<tr><td align="left" valign="top">• <a href="#KISS-repositories" accesskey="1">KISS repositories</a></td><td> </td><td align="left" valign="top">Acquire kiss repositories +</td></tr> +</table> + +<hr> +<span id="KISS-repositories"></span><div class="header"> +<p> +Up: <a href="#Post_002dinstallation" accesskey="u" rel="up">Post-installation</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> +</div> +<span id="KISS-repositories-1"></span><h4 class="subsection">1.6.1 KISS repositories</h4> + +<p>While not 100% compatible with cpt, you can use kiss repositories in your +system the same way you are using the distribution repositories. Here is an +example for the KISS Linux Community repository. +</p> +<hr> +<span id="Init-System"></span><div class="header"> +<p> +Next: <a href="#Contribution-Guidelines" accesskey="n" rel="next">Contribution Guidelines</a>, Previous: <a href="#Installation" accesskey="p" rel="prev">Installation</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> +</div> +<span id="Init-System-1"></span><h2 class="chapter">2 Init System</h2> + +<p>Carbs Linux init scripts are run by the init daemon (‘<samp>busybox</samp>’ by default) on +boot and shutdown processes. It also provides its own halting program named +shalt. This provides a portable method that doesn’t rely on non-POSIX external +programs. +</p> +<table class="menu" border="0" cellspacing="0"> +<tr><td align="left" valign="top">• <a href="#Configuring-Init" accesskey="1">Configuring Init</a></td><td> </td><td align="left" valign="top">Ways to configure the init system +</td></tr> +<tr><td align="left" valign="top">• <a href="#Changing-Init-Program" accesskey="2">Changing Init Program</a></td><td> </td><td align="left" valign="top">Replace the default busybox init with something new +</td></tr> +</table> + +<hr> +<span id="Configuring-Init"></span><div class="header"> +<p> +Next: <a href="#Changing-Init-Program" accesskey="n" rel="next">Changing Init Program</a>, Up: <a href="#Init-System" accesskey="u" rel="up">Init System</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> +</div> +<span id="Configuring-Init-1"></span><h3 class="section">2.1 Configuring Init</h3> + +<p>There are three ways you can change the behaviour of the init system. Those are: +</p> +<ul> +<li> Kernel Command Line +</li><li> ‘<samp>/etc/init/rc.conf</samp>’ file +</li><li> Init Hooks +</li></ul> + +<table class="menu" border="0" cellspacing="0"> +<tr><td align="left" valign="top">• <a href="#Kernel-Command-Line" accesskey="1">Kernel Command Line</a></td><td> </td><td align="left" valign="top">Configure init through the boot parameters +</td></tr> +<tr><td align="left" valign="top">• <a href="#g_t_002fetc_002finit_002frcconf-file" accesskey="2">‘<samp>/etc/init/rc.conf</samp>’ file</a></td><td> </td><td align="left" valign="top">Configure init through the configuration file +</td></tr> +<tr><td align="left" valign="top">• <a href="#Init-Hooks" accesskey="3">Init Hooks</a></td><td> </td><td align="left" valign="top">Configure init through hooks +</td></tr> +</table> + +<hr> +<span id="Kernel-Command-Line"></span><div class="header"> +<p> +Next: <a href="#g_t_002fetc_002finit_002frcconf-file" accesskey="n" rel="next">‘<samp>/etc/init/rcconf</samp>’ file</a>, Up: <a href="#Configuring-Init" accesskey="u" rel="up">Configuring Init</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> +</div> +<span id="Kernel-Command-Line-1"></span><h4 class="subsection">2.1.1 Kernel Command Line</h4> + +<p>On GRUB, you can edit the kernel command line parameters, which will be parsed +as variables on the init system. Not all of the parameters will be acted upon, +but all of them will be set as variables on the init script. For example an +example command line, and how it is interpreted. +</p> +<div class="example"> +<pre class="example">BOOT_IMAGE=/boot/vmlinuz root=/dev/sda2 rw loglevel=3 quiet +</pre></div> + +<p>This command line will be parsed to set the following variables: +</p> +<div class="example"> +<pre class="example">BOOT_IMAGE=/boot/vmlinuz +root=/dev/sda2 +rw=1 +loglevel=3 +quiet=1 +</pre></div> + +<p>Some of these variables, such as ‘<samp>rw=/=ro</samp>’, ‘<samp>loglevel</samp>’, and ‘<samp>quiet</samp>’, will be +used by the init system to change the behaviour of the startup. +</p> +<hr> +<span id="g_t_002fetc_002finit_002frcconf-file"></span><div class="header"> +<p> +Next: <a href="#Init-Hooks" accesskey="n" rel="next">Init Hooks</a>, Previous: <a href="#Kernel-Command-Line" accesskey="p" rel="prev">Kernel Command Line</a>, Up: <a href="#Configuring-Init" accesskey="u" rel="up">Configuring Init</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> +</div> +<span id="g_t_002fetc_002finit_002frc_002econf-file"></span><h4 class="subsection">2.1.2 ‘<samp>/etc/init/rc.conf</samp>’ file</h4> + +<p>However, the kernel command line isn’t the only place to set your boot +parameters. You can specify variables here as well, although note that the +kernel command line always gets the priority for these variables since they can +be set just before boot. +</p> +<hr> +<span id="Init-Hooks"></span><div class="header"> +<p> +Previous: <a href="#g_t_002fetc_002finit_002frcconf-file" accesskey="p" rel="prev">‘<samp>/etc/init/rcconf</samp>’ file</a>, Up: <a href="#Configuring-Init" accesskey="u" rel="up">Configuring Init</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> +</div> +<span id="Init-Hooks-1"></span><h4 class="subsection">2.1.3 Init Hooks</h4> + +<p>Init hooks are for custom personal commands that the user may want to add to +alter their boot. These can be used to load kernel modules, modify interfaces, +and lot more. Those hooks are added to the ‘<samp>/etc/init</samp>’ directory with the +hook name as the suffix. For example, a boot script will be placed as +‘<samp>/etc/init/my-hook.boot</samp>’. Currently, there are 4 hooks that the user can use. +</p> +<dl compact="compact"> +<dt>early-boot</dt> +<dd><p>Run after pseudo-filesystems are mounted. +</p></dd> +<dt>boot</dt> +<dd><p>Run before the boot stage is completed. +</p></dd> +<dt>pre.shutdown</dt> +<dd><p>Run first when shutting down. +</p></dd> +<dt>umount</dt> +<dd><p>Run just before filesystems are unmounted. +</p></dd> +<dt>post.shutdown</dt> +<dd><p>Run just before the system is halted. +</p></dd> +</dl> + +<hr> +<span id="Changing-Init-Program"></span><div class="header"> +<p> +Previous: <a href="#Configuring-Init" accesskey="p" rel="prev">Configuring Init</a>, Up: <a href="#Init-System" accesskey="u" rel="up">Init System</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> +</div> +<span id="Changing-Init-Program-1"></span><h3 class="section">2.2 Changing Init Program</h3> + +<p>By default, Carbs Linux comes preinstalled with ‘<samp>busybox-init</samp>’, but this can +easily be replaced without any issues. Currently, available init systems are: +</p> +<ul> +<li> ‘<samp>sinit</samp>’ +</li><li> ‘<samp>busybox</samp>’ +</li><li> ‘<samp>runit</samp>’ +</li><li> ‘<samp>shinit</samp>’ +</li></ul> + +<p>This example is for runit, but it will work with all init systems packaged in the +distribution repositories. See the ‘<samp>cpt-alternatives(1)</samp>’ manual page for more +details. +</p> +<div class="example"> +<pre class="example">cpt a runit /usr/bin/init +cpt a runit /usr/bin/poweroff +cpt a runit /usr/bin/reboot +</pre></div> + +<table class="menu" border="0" cellspacing="0"> +<tr><td align="left" valign="top">• <a href="#Rebooting-after-changing-init" accesskey="1">Rebooting after changing init</a></td><td> </td><td align="left" valign="top">Ways to reboot after replacing the init system +</td></tr> +</table> + +<hr> +<span id="Rebooting-after-changing-init"></span><div class="header"> +<p> +Up: <a href="#Changing-Init-Program" accesskey="u" rel="up">Changing Init Program</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> +</div> +<span id="Rebooting-after-changing-init-1"></span><h4 class="subsection">2.2.1 Rebooting after changing init</h4> + +<p>After switching init systems, your running init system may not accept the +new poweroff commands. You will need to reboot/poweroff using the running init’s +utilities for the new utilities to work. These commands are for the init system +currently running on your system and not the one you are switching to. +</p> +<table> +<thead><tr><th>Program</th><th>Command</th></tr></thead> +<tr><td>busybox</td><td>‘<samp>busybox reboot</samp>’</td></tr> +<tr><td>runit</td><td>‘<samp>runit-init 6</samp>’</td></tr> +<tr><td>shinit/sinit</td><td>‘<samp>kill -s INT 1</samp>’</td></tr> +</table> + +<hr> +<span id="Contribution-Guidelines"></span><div class="header"> +<p> +Next: <a href="#GNU-Free-Documentation-License" accesskey="n" rel="next">GNU Free Documentation License</a>, Previous: <a href="#Init-System" accesskey="p" rel="prev">Init System</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> +</div> +<span id="Contribution-Guidelines-1"></span><h2 class="chapter">3 Contribution Guidelines</h2> + +<p>Thanks for taking your time to contribute! To maintain stylistic behaviour +throughout the repositories, one must adhere to these conventions. Exceptions +and changes may occur with good reasoning. +</p> +<table class="menu" border="0" cellspacing="0"> +<tr><td align="left" valign="top">• <a href="#Conventions" accesskey="1">Conventions</a></td><td> </td><td align="left" valign="top">Conventions of the distribution +</td></tr> +</table> + +<hr> +<span id="Conventions"></span><div class="header"> +<p> +Up: <a href="#Contribution-Guidelines" accesskey="u" rel="up">Contribution Guidelines</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> +</div> +<span id="Conventions-1"></span><h3 class="section">3.1 Conventions</h3> + + + +<dl compact="compact"> +<dt>[<span id="g_t0010"></span>0010]</dt> +<dd><p>Try to keep the file readable. +</p><dl compact="compact"> +<dt>[<span id="g_t0011"></span>0011]</dt> +<dd><p>Characters on a line shouldn’t exceed 100 characters. +</p></dd> +<dt>[<span id="g_t0012"></span>0012]</dt> +<dd><p>Make sure you don’t have code commented out during +commit. Uncomment them or remove them completely. +</p></dd> +<dt>[<span id="g_t0013"></span>0013]</dt> +<dd><p>Do not add comments following the code, add them to the +top of the code. It makes it harder to read, and lines longer. Here is an example: +</p></dd> +</dl> + +<div class="example"> +<pre class="example"># Good way of commenting. +your code goes here + +your code goes here # Avoid this way of commenting. +</pre></div> +</dd> +</dl> + +<table class="menu" border="0" cellspacing="0"> +<tr><td align="left" valign="top">• <a href="#Shell-Conventions" accesskey="1">Shell Conventions</a></td><td> </td><td align="left" valign="top">Conventions for shell scripts +</td></tr> +<tr><td align="left" valign="top">• <a href="#Repository-Conventions" accesskey="2">Repository Conventions</a></td><td> </td><td align="left" valign="top">Conventions for repository build scripts +</td></tr> +</table> + +<hr> +<span id="Shell-Conventions"></span><div class="header"> +<p> +Next: <a href="#Repository-Conventions" accesskey="n" rel="next">Repository Conventions</a>, Up: <a href="#Conventions" accesskey="u" rel="up">Conventions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> +</div> +<span id="Shell-Conventions-1"></span><h4 class="subsection">3.1.1 Shell Conventions</h4> + +<p>Shell is central to Carbs Linux projects. Most of the tools and packages are +written in POSIX sh. +</p> +<dl compact="compact"> +<dt>[<span id="g_t1010"></span>1010]</dt> +<dd><p>Use 4 spaces for indentation, don’t use tabs. +</p></dd> +<dt>[<span id="g_t1020"></span>1020]</dt> +<dd><p>Make sure you don’t use bash-specific code. +</p></dd> +<dt>[<span id="g_t1030"></span>1030]</dt> +<dd><p>Make sure you lint your code with ‘<samp>shellcheck</samp>’ and if +you are new to POSIX sh, use ‘<samp>checkbashisms</samp>’. +</p></dd> +<dt>[<span id="g_t1040"></span>1040]</dt> +<dd><p>Don’t spawn new processes if you don’t absolutely need +to, especially during string manipulation. +</p><dl compact="compact"> +<dt>[<span id="g_t1041"></span>1041]</dt> +<dd><p>Never use a program for text manupilation that isn’t +defined in the POSIX standard. This includes ‘<samp>gawk</samp>’ and ‘<samp>perl</samp>’. +</p></dd> +<dt>[<span id="g_t1042"></span>1042]</dt> +<dd><p>Instead of <code>$(basename $file)</code>, use <code>${file##*}</code>. +</p></dd> +<dt>[<span id="g_t1043"></span>1043]</dt> +<dd><p>Instead of <code>$(dirname $file)</code>, use <code>${file%/*}</code>. +</p></dd> +</dl> + +<div class="example"> +<pre class="example"># This is the same thing as basename /path/to/test.asc .asc + +$ file=/path/to/test.asc file=${file##*/} file=${file%.asc} +$ echo $file +test +</pre></div> +</dd> +<dt>[<span id="g_t1050"></span>1050]</dt> +<dd><p>Instead of backticks, use <code>$(..)</code>. +</p></dd> +</dl> + +<hr> +<span id="Repository-Conventions"></span><div class="header"> +<p> +Previous: <a href="#Shell-Conventions" accesskey="p" rel="prev">Shell Conventions</a>, Up: <a href="#Conventions" accesskey="u" rel="up">Conventions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> +</div> +<span id="Repository-Conventions-1"></span><h4 class="subsection">3.1.2 Repository Conventions</h4> + +<p>Repository conventions are important in order to ensure every package resemble +themselves. Here are the things to keep in mind: +</p> +<dl compact="compact"> +<dt>[<span id="g_t2010"></span>2010]</dt> +<dd><p>Prefer tarballs over git packages unless there is a +sensible reason. Here are some: +</p><ul> +<li> Every patch is a new release. (See <a href="https://github.com/vim/vim">vim</a>) +</li><li> There are no releases. (See <a href="https://git.suckless.org/sbase">sbase</a>) +</li><li> Following a development branch. +</li><li> There has been a long time since the latest release, but upstream is far +ahead. +</li></ul> +</dd> +<dt>[<span id="g_t2020"></span>2020]</dt> +<dd><p>Prefer sources without a dependency to ‘<samp>automake</samp>’. There +are usually distribution tarballs that are ‘<samp>autoconf</samp>’’ed. Don’t submit tarballs +with an automake dependency unless you are ‘<samp>sure</samp>’ there is no alternative. +</p></dd> +<dt>[<span id="g_t2030"></span>2030]</dt> +<dd><p>Avoid these packages: +</p><dl compact="compact"> +<dt>dbus</dt> +<dd><p>Usually can be disabled by <code>--disable-dbus</code>. +</p></dd> +<dt>gettext</dt> +<dd><p>Usually can be disabled by <code>--disable-nls</code>. +</p></dd> +</dl> +</dd> +<dt>[<span id="g_t2040"></span>2040]</dt> +<dd><ul> +<li> Always install a package to the ‘<samp>/usr</samp>’ prefix. +</li><li> All binaries should go to ‘<samp>/usr/bin</samp>’, not ‘<samp>/usr/sbin</samp>’ or any other directory. +</li><li> All libraries should go to ‘<samp>/usr/lib</samp>’. +</li></ul> +</dd> +<dt>[<span id="g_t2050"></span>2050]</dt> +<dd><p>All build files on the repository should be a POSIX +shell script, and must start with <code>#!/bin/sh -e</code>. +</p></dd> +</dl> + +<p>The next section is about package templates that should be used in order to +ensure stylistic consistency. Note that the option configurations shouldn’t be +taken literally, they are meant as examples. +</p> +<ol> +<li> Make [<span id="g_t2210"></span>2210] + + +<div class="example"> +<pre class="example">#!/bin/sh -e + +make +make DESTDIR="$1" PREFIX=/usr install +</pre></div> + +</li><li> Configure/Make [<span id="g_t2211"></span>2211] + + +<div class="example"> +<pre class="example">#!/bin/sh -e + +./configure \ + --prefix=/usr \ + --disable-option \ + --enable-option + +make +make DESTDIR="$1" install +</pre></div> + +</li><li> Autoconf/Automake [<span id="g_t2212"></span>2212] + + +<p>See <a href="#g_t2020">2020</a> +</p> +<div class="example"> +<pre class="example">#!/bin/sh -e + +autoreconf -fi + +./configure \ + --prefix=/usr \ + --disable-option \ + --enable-option + +make +make DESTDIR="$1" install +</pre></div> + +</li><li> Meson [<span id="g_t2220"></span>2220] + + +<div class="example"> +<pre class="example">#!/bin/sh -e + +export DESTDIR=$1 + +meson \ + --prefix=/usr \ + -Doption=false \ + -Doption2=true \ + . output + +ninja -C output +ninja -C output install +</pre></div> + +</li><li> Cmake [<span id="g_t2230"></span>2230] + + +<div class="example"> +<pre class="example">#!/bin/sh -e + +export DESTDIR=$1 + +cmake -B build \ + -DCMAKE_INSTALL_PREFIX=/usr \ + -DCMAKE_BUILD_TYPE=Release \ + -DOPTION=ON + +cmake --build build +cmake --install build +</pre></div> + +</li><li> Go [<span id="g_t2240"></span>2240] + + +<div class="example"> +<pre class="example">#!/bin/sh -e + +export GOPATH=$PWD/gopath +trap "go clean -modcache" EXIT INT +go mod vendor + +go build +install -Dm755 program "$1/usr/bin/program" +</pre></div> + +</li><li> Python [<span id="g_t2241"></span>2241] + + +<div class="example"> +<pre class="example">#!/bin/sh -e + +python setup.py build +python setup.py install --prefix=/usr --root="$1" +</pre></div> +</li></ol> + +<hr> +<span id="GNU-Free-Documentation-License"></span><div class="header"> +<p> +Previous: <a href="#Contribution-Guidelines" accesskey="p" rel="prev">Contribution Guidelines</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> +</div> +<span id="GNU-Free-Documentation-License-1"></span><h2 class="appendix">Appendix A GNU Free Documentation License</h2> + +<div align="center">Version 1.3, 3 November 2008 +</div> +<div class="display"> +<pre class="display">Copyright © 2000, 2001, 2002, 2007, 2008 Free Software Foundation, Inc. +<a href="http://fsf.org/">http://fsf.org/</a> + +Everyone is permitted to copy and distribute verbatim copies +of this license document, but changing it is not allowed. +</pre></div> + +<ol start="0"> +<li> PREAMBLE + +<p>The purpose of this License is to make a manual, textbook, or other +functional and useful document <em>free</em> +in the sense of freedom: to assure everyone the effective freedom +to copy and redistribute it, with or without modifying it, either +commercially or noncommercially. Secondarily, this License +preserves for the author and publisher a way to get credit for +their work, while not being considered responsible for +modifications made by others. +</p> +<p>This License is a kind of "copyleft", which means that derivative +works of the document must themselves be free in the same sense. +It complements the GNU General Public License, which is a copyleft +license designed for free software. +</p> +<p>We have designed this License in order to use it for manuals for +free software, because free software needs free documentation: +a free program should come with manuals providing the same freedoms +that the software does. But this License is not limited to +software manuals; it can be used for any textual work, regardless +of subject matter or whether it is published as a printed book. We +recommend this License principally for works whose purpose is +instruction or reference. +</p> +</li><li> APPLICABILITY AND DEFINITIONS + +<p>This License applies to any manual or other work, in any medium, +that contains a notice placed by the copyright holder saying it can +be distributed under the terms of this License. Such a notice +grants a world-wide, royalty-free license, unlimited in duration, +to use that work under the conditions stated herein. The +"Document", below, refers to any such manual or work. Any member +of the public is a licensee, and is addressed as "you". You accept +the license if you copy, modify or distribute the work in a way +requiring permission under copyright law. +</p> +<p>A "Modified Version" of the Document means any work containing the +Document or a portion of it, either copied verbatim, or with +modifications and/or translated into another language. +</p> +<p>A "Secondary Section" is a named appendix or a front-matter section +of the Document that deals exclusively with the relationship of the +publishers or authors of the Document to the Document’s overall +subject (or to related matters) and contains nothing that could +fall directly within that overall subject. (Thus, if the Document +is in part a textbook of mathematics, a Secondary Section may not +explain any mathematics.) The relationship could be a matter of +historical connection with the subject or with related matters, or +of legal, commercial, philosophical, ethical or political position +regarding them. +</p> +<p>The "Invariant Sections" are certain Secondary Sections whose +titles are designated, as being those of Invariant Sections, in the +notice that says that the Document is released under this License. +If a section does not fit the above definition of Secondary then it +is not allowed to be designated as Invariant. The Document may +contain zero Invariant Sections. If the Document does not identify +any Invariant Sections then there are none. +</p> +<p>The "Cover Texts" are certain short passages of text that are +listed, as Front-Cover Texts or Back-Cover Texts, in the notice +that says that the Document is released under this License. +A Front-Cover Text may be at most 5 words, and a Back-Cover Text +may be at most 25 words. +</p> +<p>A "Transparent" copy of the Document means a machine-readable copy, +represented in a format whose specification is available to the +general public, that is suitable for revising the document +straightforwardly with generic text editors or (for images composed +of pixels) generic paint programs or (for drawings) some widely +available drawing editor, and that is suitable for input to text +formatters or for automatic translation to a variety of formats +suitable for input to text formatters. A copy made in an otherwise +Transparent file format whose markup, or absence of markup, has +been arranged to thwart or discourage subsequent modification by +readers is not Transparent. An image format is not Transparent if +used for any substantial amount of text. A copy that is not +"Transparent" is called "Opaque". +</p> +<p>Examples of suitable formats for Transparent copies include plain +ASCII without markup, Texinfo input format, LaTeX input format, +SGML or XML using a publicly available DTD, and standard-conforming +simple HTML, PostScript or PDF designed for human modification. +Examples of transparent image formats include PNG, XCF and JPG. +Opaque formats include proprietary formats that can be read and +edited only by proprietary word processors, SGML or XML for which +the DTD and/or processing tools are not generally available, and +the machine-generated HTML, PostScript or PDF produced by some word +processors for output purposes only. +</p> +<p>The "Title Page" means, for a printed book, the title page itself, +plus such following pages as are needed to hold, legibly, the +material this License requires to appear in the title page. For +works in formats which do not have any title page as such, "Title +Page" means the text near the most prominent appearance of the +work’s title, preceding the beginning of the body of the text. +</p> +<p>The "publisher" means any person or entity that distributes copies +of the Document to the public. +</p> +<p>A section "Entitled XYZ" means a named subunit of the Document +whose title either is precisely XYZ or contains XYZ in parentheses +following text that translates XYZ in another language. (Here XYZ +stands for a specific section name mentioned below, such as +"Acknowledgements", "Dedications", "Endorsements", or "History".) +To "Preserve the Title" of such a section when you modify the +Document means that it remains a section "Entitled XYZ" according +to this definition. +</p> +<p>The Document may include Warranty Disclaimers next to the notice +which states that this License applies to the Document. These +Warranty Disclaimers are considered to be included by reference in +this License, but only as regards disclaiming warranties: any other +implication that these Warranty Disclaimers may have is void and +has no effect on the meaning of this License. +</p> +</li><li> VERBATIM COPYING + +<p>You may copy and distribute the Document in any medium, either +commercially or noncommercially, provided that this License, the +copyright notices, and the license notice saying this License +applies to the Document are reproduced in all copies, and that you +add no other conditions whatsoever to those of this License. You +may not use technical measures to obstruct or control the reading +or further copying of the copies you make or distribute. However, +you may accept compensation in exchange for copies. If you +distribute a large enough number of copies you must also follow the +conditions in section 3. +</p> +<p>You may also lend copies, under the same conditions stated above, +and you may publicly display copies. +</p> +</li><li> COPYING IN QUANTITY + +<p>If you publish printed copies (or copies in media that commonly +have printed covers) of the Document, numbering more than 100, and +the Document’s license notice requires Cover Texts, you must +enclose the copies in covers that carry, clearly and legibly, all +these Cover Texts: Front-Cover Texts on the front cover, and +Back-Cover Texts on the back cover. Both covers must also clearly +and legibly identify you as the publisher of these copies. The +front cover must present the full title with all words of the title +equally prominent and visible. You may add other material on the +covers in addition. Copying with changes limited to the covers, as +long as they preserve the title of the Document and satisfy these +conditions, can be treated as verbatim copying in other respects. +</p> +<p>If the required texts for either cover are too voluminous to fit +legibly, you should put the first ones listed (as many as fit +reasonably) on the actual cover, and continue the rest onto +adjacent pages. +</p> +<p>If you publish or distribute Opaque copies of the Document +numbering more than 100, you must either include a machine-readable +Transparent copy along with each Opaque copy, or state in or with +each Opaque copy a computer-network location from which the general +network-using public has access to download using public-standard +network protocols a complete Transparent copy of the Document, free +of added material. If you use the latter option, you must take +reasonably prudent steps, when you begin distribution of Opaque +copies in quantity, to ensure that this Transparent copy will +remain thus accessible at the stated location until at least one +year after the last time you distribute an Opaque copy (directly or +through your agents or retailers) of that edition to the public. +</p> +<p>It is requested, but not required, that you contact the authors of +the Document well before redistributing any large number of copies, +to give them a chance to provide you with an updated version of the +Document. +</p> +</li><li> MODIFICATIONS + +<p>You may copy and distribute a Modified Version of the Document +under the conditions of sections 2 and 3 above, provided that you +release the Modified Version under precisely this License, with the +Modified Version filling the role of the Document, thus licensing +distribution and modification of the Modified Version to whoever +possesses a copy of it. In addition, you must do these things in +the Modified Version: +</p> +<ol type="A" start="1"> +<li> Use in the Title Page (and on the covers, if any) a title +distinct from that of the Document, and from those of previous +versions (which should, if there were any, be listed in the +History section of the Document). You may use the same title as +a previous version if the original publisher of that version +gives permission. + +</li><li> List on the Title Page, as authors, one or more persons or +entities responsible for authorship of the modifications in the +Modified Version, together with at least five of the principal +authors of the Document (all of its principal authors, if it has +fewer than five), unless they release you from this requirement. + +</li><li> State on the Title page the name of the publisher of the +Modified Version, as the publisher. + +</li><li> Preserve all the copyright notices of the Document. + +</li><li> Add an appropriate copyright notice for your modifications +adjacent to the other copyright notices. + +</li><li> Include, immediately after the copyright notices, a license +notice giving the public permission to use the Modified Version +under the terms of this License, in the form shown in the +Addendum below. + +</li><li> Preserve in that license notice the full lists of Invariant +Sections and required Cover Texts given in the Document’s +license notice. + +</li><li> Include an unaltered copy of this License. + +</li><li> Preserve the section Entitled "History", Preserve its Title, and +add to it an item stating at least the title, year, new authors, +and publisher of the Modified Version as given on the Title +Page. If there is no section Entitled "History" in the Document, +create one stating the title, year, authors, and publisher of +the Document as given on its Title Page, then add an item +describing the Modified Version as stated in the previous +sentence. + +</li><li> Preserve the network location, if any, given in the Document +for public access to a Transparent copy of the Document, and +likewise the network locations given in the Document for +previous versions it was based on. These may be placed in the +"History" section. You may omit a network location for a work +that was published at least four years before the Document +itself, or if the original publisher of the version it refers +to gives permission. + +</li><li> For any section Entitled "Acknowledgements" or "Dedications", +Preserve the Title of the section, and preserve in the section +all the substance and tone of each of the contributor +acknowledgements and/or dedications given therein. + +</li><li> Preserve all the Invariant Sections of the Document, unaltered +in their text and in their titles. Section numbers or the +equivalent are not considered part of the section titles. + +</li><li> Delete any section Entitled "Endorsements". Such a section may +not be included in the Modified Version. + +</li><li> Do not retitle any existing section to be Entitled +"Endorsements" or to conflict in title with any Invariant +Section. + +</li><li> Preserve any Warranty Disclaimers. +</li></ol> + +<p>If the Modified Version includes new front-matter sections or +appendices that qualify as Secondary Sections and contain no material +copied from the Document, you may at your option designate some or all +of these sections as invariant. To do this, add their titles to the +list of Invariant Sections in the Modified Version’s license notice. +These titles must be distinct from any other section titles. +</p> +<p>You may add a section Entitled "Endorsements", provided it contains +nothing but endorsements of your Modified Version by various +parties—for example, statements of peer review or that the text has +been approved by an organization as the authoritative definition of a +standard. +</p> +<p>You may add a passage of up to five words as a Front-Cover Text, and a +passage of up to 25 words as a Back-Cover Text, to the end of the list +of Cover Texts in the Modified Version. Only one passage of +Front-Cover Text and one of Back-Cover Text may be added by (or +through arrangements made by) any one entity. If the Document already +includes a cover text for the same cover, previously added by you or +by arrangement made by the same entity you are acting on behalf of, +you may not add another; but you may replace the old one, on explicit +permission from the previous publisher that added the old one. +</p> +<p>The author(s) and publisher(s) of the Document do not by this License +give permission to use their names for publicity for or to assert or +imply endorsement of any Modified Version. +</p> +</li><li> COMBINING DOCUMENTS + +<p>You may combine the Document with other documents released under +this License, under the terms defined in section 4 above for +modified versions, provided that you include in the combination all +of the Invariant Sections of all of the original documents, +unmodified, and list them all as Invariant Sections of your +combined work in its license notice, and that you preserve all +their Warranty Disclaimers. +</p> +<p>The combined work need only contain one copy of this License, and +multiple identical Invariant Sections may be replaced with a single +copy. If there are multiple Invariant Sections with the same name +but different contents, make the title of each such section unique +by adding at the end of it, in parentheses, the name of the +original author or publisher of that section if known, or else +a unique number. Make the same adjustment to the section titles in +the list of Invariant Sections in the license notice of the +combined work. +</p> +<p>In the combination, you must combine any sections Entitled +"History" in the various original documents, forming one section +Entitled "History"; likewise combine any sections Entitled +"Acknowledgements", and any sections Entitled "Dedications". You +must delete all sections Entitled "Endorsements." +</p> +</li><li> COLLECTIONS OF DOCUMENTS + +<p>You may make a collection consisting of the Document and other +documents released under this License, and replace the individual +copies of this License in the various documents with a single copy +that is included in the collection, provided that you follow the +rules of this License for verbatim copying of each of the documents +in all other respects. +</p> +<p>You may extract a single document from such a collection, and +distribute it individually under this License, provided you insert +a copy of this License into the extracted document, and follow this +License in all other respects regarding verbatim copying of that +document. +</p> +</li><li> AGGREGATION WITH INDEPENDENT WORKS + +<p>A compilation of the Document or its derivatives with other +separate and independent documents or works, in or on a volume of +a storage or distribution medium, is called an "aggregate" if the +copyright resulting from the compilation is not used to limit the +legal rights of the compilation’s users beyond what the individual +works permit. When the Document is included in an aggregate, this +License does not apply to the other works in the aggregate which +are not themselves derivative works of the Document. +</p> +<p>If the Cover Text requirement of section 3 is applicable to these +copies of the Document, then if the Document is less than one half +of the entire aggregate, the Document’s Cover Texts may be placed +on covers that bracket the Document within the aggregate, or the +electronic equivalent of covers if the Document is in electronic +form. Otherwise they must appear on printed covers that bracket +the whole aggregate. +</p> +</li><li> TRANSLATION + +<p>Translation is considered a kind of modification, so you may +distribute translations of the Document under the terms of +section 4. Replacing Invariant Sections with translations requires +special permission from their copyright holders, but you may +include translations of some or all Invariant Sections in addition +to the original versions of these Invariant Sections. You may +include a translation of this License, and all the license notices +in the Document, and any Warranty Disclaimers, provided that you +also include the original English version of this License and the +original versions of those notices and disclaimers. In case of +a disagreement between the translation and the original version of +this License or a notice or disclaimer, the original version will +prevail. +</p> +<p>If a section in the Document is Entitled "Acknowledgements", +"Dedications", or "History", the requirement (section 4) to +Preserve its Title (section 1) will typically require changing the +actual title. +</p> +</li><li> TERMINATION + +<p>You may not copy, modify, sublicense, or distribute the Document +except as expressly provided under this License. Any attempt +otherwise to copy, modify, sublicense, or distribute it is void, +and will automatically terminate your rights under this License. +</p> +<p>However, if you cease all violation of this License, then your +license from a particular copyright holder is reinstated (a) +provisionally, unless and until the copyright holder explicitly and +finally terminates your license, and (b) permanently, if the +copyright holder fails to notify you of the violation by some +reasonable means prior to 60 days after the cessation. +</p> +<p>Moreover, your license from a particular copyright holder is +reinstated permanently if the copyright holder notifies you of the +violation by some reasonable means, this is the first time you have +received notice of violation of this License (for any work) from +that copyright holder, and you cure the violation prior to 30 days +after your receipt of the notice. +</p> +<p>Termination of your rights under this section does not terminate +the licenses of parties who have received copies or rights from you +under this License. If your rights have been terminated and not +permanently reinstated, receipt of a copy of some or all of the +same material does not give you any rights to use it. +</p> +</li><li> FUTURE REVISIONS OF THIS LICENSE + +<p>The Free Software Foundation may publish new, revised versions of +the GNU Free Documentation License from time to time. Such new +versions will be similar in spirit to the present version, but may +differ in detail to address new problems or concerns. See +<a href="http://www.gnu.org/copyleft/">http://www.gnu.org/copyleft/</a>. +</p> +<p>Each version of the License is given a distinguishing version +number. If the Document specifies that a particular numbered +version of this License "or any later version" applies to it, you +have the option of following the terms and conditions either of +that specified version or of any later version that has been +published (not as a draft) by the Free Software Foundation. If +the Document does not specify a version number of this License, +you may choose any version ever published (not as a draft) by the +Free Software Foundation. If the Document specifies that a proxy +can decide which future versions of this License can be used, that +proxy’s public statement of acceptance of a version permanently +authorizes you to choose that version for the Document. +</p> +</li><li> RELICENSING + +<p>"Massive Multiauthor Collaboration Site" (or "MMC Site") means any +World Wide Web server that publishes copyrightable works and also +provides prominent facilities for anybody to edit those works. +A public wiki that anybody can edit is an example of such +a server. A "Massive Multiauthor Collaboration" (or "MMC") +contained in the site means any set of copyrightable works thus +published on the MMC site. +</p> +<p>"CC-BY-SA" means the Creative Commons Attribution-Share Alike 3.0 +license published by Creative Commons Corporation, +a not-for-profit corporation with a principal place of business in +San Francisco, California, as well as future copyleft versions of +that license published by that same organization. +</p> +<p>"Incorporate" means to publish or republish a Document, in whole +or in part, as part of another Document. +</p> +<p>An MMC is "eligible for relicensing" if it is licensed under this +License, and if all works that were first published under this +License somewhere other than this MMC, and subsequently +incorporated in whole or in part into the MMC, (1) had no cover +texts or invariant sections, and (2) were thus incorporated prior +to November 1, 2008. +</p> +<p>The operator of an MMC Site may republish an MMC contained in the +site under CC-BY-SA on the same site at any time before August 1, +2009, provided the MMC is eligible for relicensing. +</p></li></ol> + + +<span id="ADDENDUM-How-to-use-this-License-for-your-documents"></span><span id="ADDENDUM_003a-How-to-use-this-License-for-your-documents"></span><h3 class="appendixsec">A.1 ADDENDUM: How to use this License for your documents</h3> + +<p>To use this License in a document you have written, include a copy of +the License in the document and put the following copyright and +license notices just after the title page: +</p> +<div class="example"> +<pre class="example">Copyright (C) YEAR YOUR NAME. +Permission is granted to copy, distribute and/or modify this document +under the terms of the GNU Free Documentation License, Version 1.3 +or any later version published by the Free Software Foundation; +with no Invariant Sections, no Front-Cover Texts, and no Back-Cover +Texts. A copy of the license is included in the section entitled ``GNU +Free Documentation License''. +</pre></div> + +<p>If you have Invariant Sections, Front-Cover Texts and Back-Cover Texts, +replace the "with…Texts." line with this: +</p> +<div class="example"> +<pre class="example">with the Invariant Sections being LIST THEIR TITLES, with +the Front-Cover Texts being LIST, and with the Back-Cover Texts +being LIST. +</pre></div> + +<p>If you have Invariant Sections without Cover Texts, or some other +combination of the three, merge those two alternatives to suit the +situation. +</p> +<p>If your document contains nontrivial examples of program code, we +recommend releasing these examples in parallel under your choice of +free software license, such as the GNU General Public License, to +permit their use in free software. +</p> +<hr> + + + +</body> +</html> diff --git a/docs/docs/carbslinux.txt b/docs/docs/carbslinux.txt new file mode 100644 index 0000000..a969c74 --- /dev/null +++ b/docs/docs/carbslinux.txt @@ -0,0 +1,1356 @@ + _________________________ + + CARBS LINUX USER MANUAL + + Cem Keylan + _________________________ + + +Table of Contents +_________________ + +1. Copying +2. Installation +.. 1. Preparing Environment +..... 1. Download +..... 2. Signature verification +..... 3. Extracting the tarball +..... 4. Obtain the chroot helper +.. 2. Chroot +..... 1. Setting up repositories +..... 2. Updating packages +..... 3. Installing packages +..... 4. Essential Software +..... 5. Obtaining the documentation +.. 3. System Configuration +..... 1. Configuring hostname +..... 2. Hosts file +.. 4. Kernel +..... 1. Obtaining the kernel sources +..... 2. Kernel dependencies +..... 3. Building the kernel +.. 5. Making your system bootable +..... 1. Bootloader +..... 2. Init scripts +..... 3. Fstab +.. 6. Post-installation +..... 1. KISS repositories +3. Init System +.. 1. Configuring Init +..... 1. Kernel Command Line +..... 2. `/etc/init/rc.conf' file +..... 3. Init Hooks +.. 2. Changing Init Program +..... 1. Rebooting after changing init +4. Contribution Guidelines +.. 1. Conventions +..... 1. Shell Conventions +..... 2. Repository Conventions +5. GNU Free Documentation License + + +This is the full documentation of [Carbs Linux], from the details of the +distribution, installation, to the package manager. It is not yet +complete. + +You can build and install the 'info' package in order to view this documentation +with the info reader. It is divided into sections and easier to read. + + +[Carbs Linux] <https://carbslinux.org> + + +1 Copying +========= + + Copyright (c) 2020 Cem Keylan + + Permission is granted to copy, distribute and/or modify + this document under the terms of the GNU Free + Documentation License, Version 1.3 or any later version + published by the Free Software Foundation; with no + Invariant Sections, with no Front-Cover Texts and no + Back-Cover Texts. A copy of the license is included in + the section entitled "GNU Free Documentation License." + + +2 Installation +============== + + These are the step-by-step instructions for installing Carbs Linux. It + can be acquired as plain-text to be viewed offline with a pager from + <https://carbslinux.org/install.txt>. + + ,---- + | curl -sL https://carbslinux.org/install.txt | less + `---- + + .. 1. Preparing Environment + ..... 1. Download + ..... 2. Signature verification + ..... 3. Extracting the tarball + ..... 4. Obtain the chroot helper + .. 2. Chroot + ..... 1. Setting up repositories + ..... 2. Updating packages + ..... 3. Installing packages + ..... 4. Essential Software + ..... 5. Obtaining the documentation + .. 3. System Configuration + ..... 1. Configuring hostname + ..... 2. Hosts file + .. 4. Kernel + ..... 1. Obtaining the kernel sources + ..... 2. Kernel dependencies + ..... 3. Building the kernel + .. 5. Making your system bootable + ..... 1. Bootloader + ..... 2. Init scripts + ..... 3. Fstab + .. 6. Post-installation + ..... 1. KISS repositories + + +2.1 Preparing Environment +~~~~~~~~~~~~~~~~~~~~~~~~~ + + To install Carbs Linux, you will need a Live Linux ISO. For that + purpose, you can obtain a Gentoo or Void Linux live image. You can + follow their instructions to boot and setup your network. + + You will need the following programs in order to install Carbs Linux: + + - tar + - wget + - xz + - some form of base utilities (coreutils, sbase, busybox, etc.) + + Rest of these instructions will assume that you have set all of these + up, and will continue on that point. + + +2.1.1 Download +-------------- + + First, we need to download the rootfs tarball. You can do the + following in order to obtain the rootfs. If you are using an i686 + machine, replace the `x86_64' with `i686'. We are setting this in a + URL variable so that we don't have to write it every time. + + ,---- + | wget $URL/carbs-rootfs.tar.xz.sha256 + | sha256sum -c carbs-rootfs.tar.xz.sha256 + `---- + + +2.1.2 Signature verification +---------------------------- + + It is highly recommended to verify the signature of the tarball. You + will need GPG for this. + + ,---- + | wget $URL/carbs-rootfs.tar.xz.sig + | gpg --recv-keys FF484BDFEFCEF8FF + | gpg --verify carbs-rootfs.tar.xz.sig + `---- + + +2.1.3 Extracting the tarball +---------------------------- + + You will need to extract the tarball to your desired location. For + partitioning, you can follow [this guide]. This will assume that you + will be mounting your root partition to `/mnt'. + + ,---- + | mount /dev/sdx1 /mnt + | tar xf carbs-rootfs.tar.xz -C /mnt + `---- + + +[this guide] <https://wiki.archlinux.org/index.php/Partitioning> + + +2.1.4 Obtain the chroot helper +------------------------------ + + You can obtain the `cpt-chroot' script in order to do a simple chroot + into your new root filesystem. + + ,---- + | wget https://dl.carbslinux.org/distfiles/cpt-chroot + | chmod a+x cpt-chroot + `---- + + +2.2 Chroot +~~~~~~~~~~ + + Chroot into Carbs Linux! + + ,---- + | ./cpt-chroot /mnt + `---- + + +2.2.1 Setting up repositories +----------------------------- + + Newest tarballs do not come with repositories, so you will need to + manually obtain them, and set your `CPT_PATH' environment + variable. Carbs Linux repositories can either be obtained by `git' or + `rsync'. While rsync repositories are overall faster and smaller, git + offers the whole history of the repository and a means to manipulate + your repository as you like it. If you want to obtain the git + repository, you will need to install `git' itself. + + The following guide will assume that you put the repositories into + `~/repos/' directory, but you can put the repositories into any + directory you want. So go ahead and create that directory: + + ,---- + | mkdir -p $HOME/repos + `---- + + +* 2.2.1.1 Obtaining from git + + Carbs Linux git repositories can be found both from the main server + and GitHub (mirror). Here are both their repository links. You can + clone any of them. + + - git://git.carbslinux.org/repository + - <https://github.com/carbslinux/repository> + + ,---- + | git clone git://git.carbslinux.org/repository $HOME/repos/carbs + `---- + + +* 2.2.1.2 Obtaining from rsync + + Carbs Linux rsync repositories live in rsync://carbslinux.org/repo. In + order to obtain it, run the following: + + ,---- + | rsync -avc rsync://carbslinux.org/repo $HOME/repos/carbs + `---- + + +* 2.2.1.3 Making the package manager use the repositories + + In your shell's configuration file, or in your `~/.profile' file, add + the following lines: + + ,---- + | CPT_PATH=$HOME/repos/carbs/core + | CPT_PATH=$CPT_PATH:$HOME/repos/carbs/extra + | CPT_PATH=$CPT_PATH:$HOME/repos/carbs/xorg + | CPT_PATH=$CPT_PATH:$HOME/repos/carbs/community + | export CPT_PATH + `---- + + +2.2.2 Updating packages +----------------------- + + It is good practice to make sure your system is up to date, especially + before building new packages. If there is an update for the package + manager you will need to update twice. + + ,---- + | cpt-update && cpt-update + `---- + + +2.2.3 Installing packages +------------------------- + + Since you are operating on a really small base, you might need to + build and install new programs to extend the functionality of your + system. In order to build and install packages new packages in Carbs, + you need to execute the following. "Package" is not actually a package + and is given as an example. + + ,---- + | cpt-build package + | cpt-install package + `---- + + +2.2.4 Essential Software +------------------------ + + Here is a list of software that you might want to have on your system. + + *BOOTLOADERS* + + - efibootmgr + - grub + + *FILESYSTEMS* + + - e2fsprogs + - dosfstools + - ntfs-3g + + *NETWORKING* + + - dhcpcd + - wpa_supplicant + + *TEXT EDITORS* + + - nano + - vim + - neatvi + - emacs + - emacs-nox (terminal-only version of emacs) + + *USER SHELLS* + + - bash + - zsh + - oksh + - rc + + *POSIX BASE UTILITIES* + + - busybox + - sbase + - coreutils + + *DOCUMENTATION* + + - carbs-docs + - man-pages + - man-pages-posix + + +2.2.5 Obtaining the documentation +--------------------------------- + + All the documentation for Carbs Linux can be found on a single info + manual to be viewed offline. You can obtain texinfo or the info + (standalone) package in order to view the documentation. + + ,---- + | # Install the documentation. + | cpt b carbs-docs && cpt i carbs-docs + | + | # Install either texinfo or the info package. We will be installing standalone info + | # as it doesn't need perl. + | cpt b info && cpt i info + | + | # You can then run info and navigate through the documentation. + | info carbslinux + `---- + + +2.3 System Configuration +~~~~~~~~~~~~~~~~~~~~~~~~ + + After you have finished installing some extra packages, you can + configure your system to your liking. + + +2.3.1 Configuring hostname +-------------------------- + + You might want to add a hostname, especially in a networked + environment. Your hostname will default to 'carbslinux' unless you set + this. + + ,---- + | echo your-hostname > /etc/hostname + `---- + + +2.3.2 Hosts file +---------------- + + You can edit your /etc/hosts file, which is the static lookup table + for host names. By default, there are two entries for localhost which + are OKAY. You can replace the 'localhost' part of these entries to + your hostname. + + ,---- + | 127.0.0.1 localhost.localdomain localhost + | ::1 localhost.localdomain localhost ip6-localhost + `---- + + +2.4 Kernel +~~~~~~~~~~ + + Kernel isn't managed under the main repositories, even though you + could package one for your personal use. Here is an [example kernel + package], which you will need to reconfigure for your specific setup + if you want to make use of it. + + +[example kernel package] +<https://github.com/cemkeylan/kiss-repository/tree/master/personal/linux> + +2.4.1 Obtaining the kernel sources +---------------------------------- + + You can visit the <https://kernel.org> website to choose a kernel that + you want to install. Though only the latest stable and longterm (LTS) + versions are supported. + + ,---- + | # Download the kernel and extract it + | wget https://cdn.kernel.org/pub/linux/kernel/v5.x/linux-5.9.1.tar.xz + | tar xf linux-5.9.1.tar.xz + | + | # Change directory into the kernel sources + | cd linux-5.9.1 + `---- + + +2.4.2 Kernel dependencies +------------------------- + + In order to compile the kernel you will need to install some + dependencies. You will need `libelf', and `bison' to compile the + kernel. If you want to configure using the menu interface you will + also need `ncurses'. + + ,---- + | # The package manager asks to install if you are building more than one package, + | # so no need to run 'cpt i ...' + | cpt b libelf ncurses + `---- + + In the vanilla kernel sources, you need perl to compile the kernel, + but it can be easily patched out. You will need to apply the following + patch. Patch was written by [E5ten]. You will need to obtain and apply + the patch in the kernel source directory. + + ,---- + | wget https://dl.carbslinux.org/distfiles/kernel-no-perl.patch + | patch -p1 < kernel-no-perl.patch + `---- + + +[E5ten] <https://github.com/E5ten> + + +2.4.3 Building the kernel +------------------------- + + Next step is configuring and building the kernel. You can check + Gentoo's [kernel configuration guide] to learn more about the + matter. Overall, Gentoo Wiki is a good place to learn about + configuration according to your hardware. The following will assume a + monolithic kernel. + + ,---- + | make menuconfig + | make + | install -Dm755 $(make -s image_name) /boot/vmlinuz-linux + `---- + + +[kernel configuration guide] +<https://wiki.gentoo.org/wiki/Kernel/Configuration> + + +2.5 Making your system bootable +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + In order to be able to boot your fresh system, wou will need an + init-daemon, init-scripts and a bootloader. The init daemon is already + provided by busybox, but you can optionally change it. + + +2.5.1 Bootloader +---------------- + + In the main repository, there is efibootmgr and grub to serve as + bootloaders. efibootmgr can be used as a standalone bootloader, or + can be used to install grub in a UEFI environment. efibootmgr is + needed unless you are using a device without UEFI support (or you + really want to use BIOS for a reason). + + +* 2.5.1.1 GRUB BIOS installation + + ,---- + | cpt b grub && cpt i grub + | grub-install --target=i386-pc /dev/sdX + | grub-mkconfig -o /boot/grub/grub.cfg + `---- + + +* 2.5.1.2 GRUB UEFI installation + + ,---- + | cpt b efibootmgr && cpt i efibootmgr + | cpt b grub && cpt i grub + | + | grub-install --target=x86_64-efi \ + | --efi-directory=esp \ + | --bootloader-id=CarbsLinux + | + | grub-mkconfig -o /boot/grub/grub.cfg + `---- + + +2.5.2 Init scripts +------------------ + + Only thing left to do is installing the init-scripts, and now you are + almost ready to boot your system! + + ,---- + | cpt b carbs-init && cpt i carbs-init + `---- + + +2.5.3 Fstab +----------- + + You can now manually edit your fstab entry, or you can use the + genfstab tool. If you want to use the tool, exit the chroot and run + the following: + + ,---- + | wget https://github.com/cemkeylan/genfstab/raw/master/genfstab + | chmod +x genfstab + | ./genfstab -U /mnt >> /mnt/etc/fstab + `---- + + +2.6 Post-installation +~~~~~~~~~~~~~~~~~~~~~ + + The base installation is now complete, you can now fine tune your + system according to your needs. Rest of these instructions are + completely optional. You can check the rest of the documentation to + learn more about the system. + + +2.6.1 KISS repositories +----------------------- + + While not 100% compatible with cpt, you can use kiss repositories in + your system the same way you are using the distribution + repositories. Here is an example for the KISS Linux Community + repository. + + +3 Init System +============= + + Carbs Linux init scripts are run by the init daemon (`busybox' by + default) on boot and shutdown processes. It also provides its own + halting program named shalt. This provides a portable method that + doesn't rely on non-POSIX external programs. + + +3.1 Configuring Init +~~~~~~~~~~~~~~~~~~~~ + + There are three ways you can change the behaviour of the init + system. Those are: + + - Kernel Command Line + - `/etc/init/rc.conf' file + - Init Hooks + + +3.1.1 Kernel Command Line +------------------------- + + On GRUB, you can edit the kernel command line parameters, which will + be parsed as variables on the init system. Not all of the parameters + will be acted upon, but all of them will be set as variables on the + init script. For example an example command line, and how it is + interpreted. + + ,---- + | BOOT_IMAGE=/boot/vmlinuz root=/dev/sda2 rw loglevel=3 quiet + `---- + + This command line will be parsed to set the following variables: + + ,---- + | BOOT_IMAGE=/boot/vmlinuz + | root=/dev/sda2 + | rw=1 + | loglevel=3 + | quiet=1 + `---- + + Some of these variables, such as `rw=/=ro', `loglevel', and `quiet', + will be used by the init system to change the behaviour of the + startup. + + +3.1.2 `/etc/init/rc.conf' file +------------------------------ + + However, the kernel command line isn't the only place to set your boot + parameters. You can specify variables here as well, although note that + the kernel command line always gets the priority for these variables + since they can be set just before boot. + + +3.1.3 Init Hooks +---------------- + + Init hooks are for custom personal commands that the user may want to + add to alter their boot. These can be used to load kernel modules, + modify interfaces, and lot more. Those hooks are added to the + `/etc/init' directory with the hook name as the suffix. For example, a + boot script will be placed as `/etc/init/my-hook.boot'. Currently, + there are 4 hooks that the user can use. + + early-boot + Run after pseudo-filesystems are mounted. + boot + Run before the boot stage is completed. + pre.shutdown + Run first when shutting down. + umount + Run just before filesystems are unmounted. + post.shutdown + Run just before the system is halted. + + +3.2 Changing Init Program +~~~~~~~~~~~~~~~~~~~~~~~~~ + + By default, Carbs Linux comes preinstalled with `busybox-init', but + this can easily be replaced without any issues. Currently, available + init systems are: + + - `sinit' + - `busybox' + - `runit' + - `shinit' + + This example is for runit, but it will work with all init systems + packaged in the distribution repositories. See the + `cpt-alternatives(1)' manual page for more details. + + ,---- + | cpt a runit /usr/bin/init + | cpt a runit /usr/bin/poweroff + | cpt a runit /usr/bin/reboot + `---- + + +3.2.1 Rebooting after changing init +----------------------------------- + + After switching init systems, your running init system may not accept + the new poweroff commands. You will need to reboot/poweroff using the + running init's utilities for the new utilities to work. These commands + are for the init system currently running on your system and not the + one you are switching to. + + Program Command + -------------------------------- + busybox `busybox reboot' + runit `runit-init 6' + shinit/sinit `kill -s INT 1' + + +4 Contribution Guidelines +========================= + + Thanks for taking your time to contribute! To maintain stylistic + behaviour throughout the repositories, one must adhere to these + conventions. Exceptions and changes may occur with good reasoning. + + +4.1 Conventions +~~~~~~~~~~~~~~~ + + [0010] + Try to keep the file readable. + [0011] + Characters on a line shouldn't exceed 100 characters. + [0012] + Make sure you don't have code commented out during + commit. Uncomment them or remove them completely. + [0013] + Do not add comments following the code, add them to the + top of the code. It makes it harder to read, and lines + longer. Here is an example: + + ,---- + | # Good way of commenting. + | your code goes here + | + | your code goes here # Avoid this way of commenting. + `---- + + +4.1.1 Shell Conventions +----------------------- + + Shell is central to Carbs Linux projects. Most of the tools and + packages are written in POSIX sh. + + [1010] + Use 4 spaces for indentation, don't use tabs. + [1020] + Make sure you don't use bash-specific code. + [1030] + Make sure you lint your code with `shellcheck' and if you are + new to POSIX sh, use `checkbashisms'. + [1040] + Don't spawn new processes if you don't absolutely need to, + especially during string manipulation. + [1041] + Never use a program for text manupilation that isn't + defined in the POSIX standard. This includes `gawk' and + `perl'. + [1042] + Instead of `$(basename $file)', use `${file##*}'. + [1043] + Instead of `$(dirname $file)', use `${file%/*}'. + + ,---- + | # This is the same thing as basename /path/to/test.asc .asc + | + | $ file=/path/to/test.asc file=${file##*/} file=${file%.asc} + | $ echo $file + | test + `---- + [1050] + Instead of backticks, use `$(..)'. + + +4.1.2 Repository Conventions +---------------------------- + + Repository conventions are important in order to ensure every package + resemble themselves. Here are the things to keep in mind: + + [2010] + Prefer tarballs over git packages unless there is a sensible + reason. Here are some: + - Every patch is a new release. (See [vim]) + - There are no releases. (See [sbase]) + - Following a development branch. + - There has been a long time since the latest release, but + upstream is far ahead. + [2020] + Prefer sources without a dependency to `automake'. There are + usually distribution tarballs that are `autoconf''ed. Don't + submit tarballs with an automake dependency unless you are + `sure' there is no alternative. + [2030] + Avoid these packages: + dbus + Usually can be disabled by `--disable-dbus'. + gettext + Usually can be disabled by `--disable-nls'. + [2040] + - Always install a package to the `/usr' prefix. + - All binaries should go to `/usr/bin', not `/usr/sbin' or any + other directory. + - All libraries should go to `/usr/lib'. + [2050] + All build files on the repository should be a POSIX shell + script, and must start with `#!/bin/sh -e'. + + The next section is about package templates that should be used in + order to ensure stylistic consistency. Note that the option + configurations shouldn't be taken literally, they are meant as + examples. + + +[vim] <https://github.com/vim/vim> + +[sbase] <https://git.suckless.org/sbase> + +* 4.1.2.1 Make [2210] + + ,---- + | #!/bin/sh -e + | + | make + | make DESTDIR="$1" PREFIX=/usr install + `---- + + +* 4.1.2.2 Configure/Make [2211] + + ,---- + | #!/bin/sh -e + | + | ./configure \ + | --prefix=/usr \ + | --disable-option \ + | --enable-option + | + | make + | make DESTDIR="$1" install + `---- + + +* 4.1.2.3 Autoconf/Automake [2212] + + ,---- + | #!/bin/sh -e + | + | autoreconf -fi + | + | ./configure \ + | --prefix=/usr \ + | --disable-option \ + | --enable-option + | + | make + | make DESTDIR="$1" install + `---- + + +* 4.1.2.4 Meson [2220] + + ,---- + | #!/bin/sh -e + | + | export DESTDIR=$1 + | + | meson \ + | --prefix=/usr \ + | -Doption=false \ + | -Doption2=true \ + | . output + | + | ninja -C output + | ninja -C output install + `---- + + +* 4.1.2.5 Cmake [2230] + + ,---- + | #!/bin/sh -e + | + | export DESTDIR=$1 + | + | cmake -B build \ + | -DCMAKE_INSTALL_PREFIX=/usr \ + | -DCMAKE_BUILD_TYPE=Release \ + | -DOPTION=ON + | + | cmake --build build + | cmake --install build + `---- + + +* 4.1.2.6 Go [2240] + + ,---- + | #!/bin/sh -e + | + | export GOPATH=$PWD/gopath + | trap "go clean -modcache" EXIT INT + | go mod vendor + | + | go build + | install -Dm755 program "$1/usr/bin/program" + `---- + + +* 4.1.2.7 Python [2241] + + ,---- + | #!/bin/sh -e + | + | python setup.py build + | python setup.py install --prefix=/usr --root="$1" + `---- + + +5 GNU Free Documentation License +================================ + + Version 1.3, 3 November 2008 + + Copyright (c) 2000, 2001, 2002, 2007, 2008 Free Software Foundation, Inc. + <http://fsf.org/> + + Everyone is permitted to copy and distribute verbatim copies + of this license document, but changing it is not allowed. + + 0. PREAMBLE + + The purpose of this License is to make a manual, textbook, or other + functional and useful document free in the sense of freedom: to + assure everyone the effective freedom to copy and redistribute it, + with or without modifying it, either commercially or + noncommercially. Secondarily, this License preserves for the author + and publisher a way to get credit for their work, while not being + considered responsible for modifications made by others. + + This License is a kind of "copyleft", which means that derivative + works of the document must themselves be free in the same sense. + It complements the GNU General Public License, which is a copyleft + license designed for free software. + + We have designed this License in order to use it for manuals for + free software, because free software needs free documentation: a + free program should come with manuals providing the same freedoms + that the software does. But this License is not limited to + software manuals; it can be used for any textual work, regardless + of subject matter or whether it is published as a printed book. We + recommend this License principally for works whose purpose is + instruction or reference. + + 1. APPLICABILITY AND DEFINITIONS + + This License applies to any manual or other work, in any medium, + that contains a notice placed by the copyright holder saying it can + be distributed under the terms of this License. Such a notice + grants a world-wide, royalty-free license, unlimited in duration, + to use that work under the conditions stated herein. The + "Document", below, refers to any such manual or work. Any member + of the public is a licensee, and is addressed as "you". You accept + the license if you copy, modify or distribute the work in a way + requiring permission under copyright law. + + A "Modified Version" of the Document means any work containing the + Document or a portion of it, either copied verbatim, or with + modifications and/or translated into another language. + + A "Secondary Section" is a named appendix or a front-matter section + of the Document that deals exclusively with the relationship of the + publishers or authors of the Document to the Document's overall + subject (or to related matters) and contains nothing that could + fall directly within that overall subject. (Thus, if the Document + is in part a textbook of mathematics, a Secondary Section may not + explain any mathematics.) The relationship could be a matter of + historical connection with the subject or with related matters, or + of legal, commercial, philosophical, ethical or political position + regarding them. + + The "Invariant Sections" are certain Secondary Sections whose + titles are designated, as being those of Invariant Sections, in the + notice that says that the Document is released under this License. + If a section does not fit the above definition of Secondary then it + is not allowed to be designated as Invariant. The Document may + contain zero Invariant Sections. If the Document does not identify + any Invariant Sections then there are none. + + The "Cover Texts" are certain short passages of text that are + listed, as Front-Cover Texts or Back-Cover Texts, in the notice + that says that the Document is released under this License. A + Front-Cover Text may be at most 5 words, and a Back-Cover Text may + be at most 25 words. + + A "Transparent" copy of the Document means a machine-readable copy, + represented in a format whose specification is available to the + general public, that is suitable for revising the document + straightforwardly with generic text editors or (for images composed + of pixels) generic paint programs or (for drawings) some widely + available drawing editor, and that is suitable for input to text + formatters or for automatic translation to a variety of formats + suitable for input to text formatters. A copy made in an otherwise + Transparent file format whose markup, or absence of markup, has + been arranged to thwart or discourage subsequent modification by + readers is not Transparent. An image format is not Transparent if + used for any substantial amount of text. A copy that is not + "Transparent" is called "Opaque". + + Examples of suitable formats for Transparent copies include plain + ASCII without markup, Texinfo input format, LaTeX input format, + SGML or XML using a publicly available DTD, and standard-conforming + simple HTML, PostScript or PDF designed for human modification. + Examples of transparent image formats include PNG, XCF and JPG. + Opaque formats include proprietary formats that can be read and + edited only by proprietary word processors, SGML or XML for which + the DTD and/or processing tools are not generally available, and + the machine-generated HTML, PostScript or PDF produced by some word + processors for output purposes only. + + The "Title Page" means, for a printed book, the title page itself, + plus such following pages as are needed to hold, legibly, the + material this License requires to appear in the title page. For + works in formats which do not have any title page as such, "Title + Page" means the text near the most prominent appearance of the + work's title, preceding the beginning of the body of the text. + + The "publisher" means any person or entity that distributes copies + of the Document to the public. + + A section "Entitled XYZ" means a named subunit of the Document + whose title either is precisely XYZ or contains XYZ in parentheses + following text that translates XYZ in another language. (Here XYZ + stands for a specific section name mentioned below, such as + "Acknowledgements", "Dedications", "Endorsements", or "History".) + To "Preserve the Title" of such a section when you modify the + Document means that it remains a section "Entitled XYZ" according + to this definition. + + The Document may include Warranty Disclaimers next to the notice + which states that this License applies to the Document. These + Warranty Disclaimers are considered to be included by reference in + this License, but only as regards disclaiming warranties: any other + implication that these Warranty Disclaimers may have is void and + has no effect on the meaning of this License. + + 2. VERBATIM COPYING + + You may copy and distribute the Document in any medium, either + commercially or noncommercially, provided that this License, the + copyright notices, and the license notice saying this License + applies to the Document are reproduced in all copies, and that you + add no other conditions whatsoever to those of this License. You + may not use technical measures to obstruct or control the reading + or further copying of the copies you make or distribute. However, + you may accept compensation in exchange for copies. If you + distribute a large enough number of copies you must also follow the + conditions in section 3. + + You may also lend copies, under the same conditions stated above, + and you may publicly display copies. + + 3. COPYING IN QUANTITY + + If you publish printed copies (or copies in media that commonly + have printed covers) of the Document, numbering more than 100, and + the Document's license notice requires Cover Texts, you must + enclose the copies in covers that carry, clearly and legibly, all + these Cover Texts: Front-Cover Texts on the front cover, and + Back-Cover Texts on the back cover. Both covers must also clearly + and legibly identify you as the publisher of these copies. The + front cover must present the full title with all words of the title + equally prominent and visible. You may add other material on the + covers in addition. Copying with changes limited to the covers, as + long as they preserve the title of the Document and satisfy these + conditions, can be treated as verbatim copying in other respects. + + If the required texts for either cover are too voluminous to fit + legibly, you should put the first ones listed (as many as fit + reasonably) on the actual cover, and continue the rest onto + adjacent pages. + + If you publish or distribute Opaque copies of the Document + numbering more than 100, you must either include a machine-readable + Transparent copy along with each Opaque copy, or state in or with + each Opaque copy a computer-network location from which the general + network-using public has access to download using public-standard + network protocols a complete Transparent copy of the Document, free + of added material. If you use the latter option, you must take + reasonably prudent steps, when you begin distribution of Opaque + copies in quantity, to ensure that this Transparent copy will + remain thus accessible at the stated location until at least one + year after the last time you distribute an Opaque copy (directly or + through your agents or retailers) of that edition to the public. + + It is requested, but not required, that you contact the authors of + the Document well before redistributing any large number of copies, + to give them a chance to provide you with an updated version of the + Document. + + 4. MODIFICATIONS + + You may copy and distribute a Modified Version of the Document + under the conditions of sections 2 and 3 above, provided that you + release the Modified Version under precisely this License, with the + Modified Version filling the role of the Document, thus licensing + distribution and modification of the Modified Version to whoever + possesses a copy of it. In addition, you must do these things in + the Modified Version: + + 1. Use in the Title Page (and on the covers, if any) a title + distinct from that of the Document, and from those of previous + versions (which should, if there were any, be listed in the + History section of the Document). You may use the same title as + a previous version if the original publisher of that version + gives permission. + + 2. List on the Title Page, as authors, one or more persons or + entities responsible for authorship of the modifications in the + Modified Version, together with at least five of the principal + authors of the Document (all of its principal authors, if it has + fewer than five), unless they release you from this requirement. + + 3. State on the Title page the name of the publisher of the + Modified Version, as the publisher. + + 4. Preserve all the copyright notices of the Document. + + 5. Add an appropriate copyright notice for your modifications + adjacent to the other copyright notices. + + 6. Include, immediately after the copyright notices, a license + notice giving the public permission to use the Modified Version + under the terms of this License, in the form shown in the + Addendum below. + + 7. Preserve in that license notice the full lists of Invariant + Sections and required Cover Texts given in the Document's + license notice. + + 8. Include an unaltered copy of this License. + + 9. Preserve the section Entitled "History", Preserve its Title, and + add to it an item stating at least the title, year, new authors, + and publisher of the Modified Version as given on the Title + Page. If there is no section Entitled "History" in the Document, + create one stating the title, year, authors, and publisher of + the Document as given on its Title Page, then add an item + describing the Modified Version as stated in the previous + sentence. + + 10. Preserve the network location, if any, given in the Document + for public access to a Transparent copy of the Document, and + likewise the network locations given in the Document for + previous versions it was based on. These may be placed in the + "History" section. You may omit a network location for a work + that was published at least four years before the Document + itself, or if the original publisher of the version it refers + to gives permission. + + 11. For any section Entitled "Acknowledgements" or "Dedications", + Preserve the Title of the section, and preserve in the section + all the substance and tone of each of the contributor + acknowledgements and/or dedications given therein. + + 12. Preserve all the Invariant Sections of the Document, unaltered + in their text and in their titles. Section numbers or the + equivalent are not considered part of the section titles. + + 13. Delete any section Entitled "Endorsements". Such a section may + not be included in the Modified Version. + + 14. Do not retitle any existing section to be Entitled + "Endorsements" or to conflict in title with any Invariant + Section. + + 15. Preserve any Warranty Disclaimers. + + If the Modified Version includes new front-matter sections or + appendices that qualify as Secondary Sections and contain no + material copied from the Document, you may at your option designate + some or all of these sections as invariant. To do this, add their + titles to the list of Invariant Sections in the Modified Version's + license notice. These titles must be distinct from any other + section titles. + + You may add a section Entitled "Endorsements", provided it contains + nothing but endorsements of your Modified Version by various + parties---for example, statements of peer review or that the text + has been approved by an organization as the authoritative + definition of a standard. + + You may add a passage of up to five words as a Front-Cover Text, + and a passage of up to 25 words as a Back-Cover Text, to the end of + the list of Cover Texts in the Modified Version. Only one passage + of Front-Cover Text and one of Back-Cover Text may be added by (or + through arrangements made by) any one entity. If the Document + already includes a cover text for the same cover, previously added + by you or by arrangement made by the same entity you are acting on + behalf of, you may not add another; but you may replace the old + one, on explicit permission from the previous publisher that added + the old one. + + The author(s) and publisher(s) of the Document do not by this + License give permission to use their names for publicity for or to + assert or imply endorsement of any Modified Version. + + 5. COMBINING DOCUMENTS + + You may combine the Document with other documents released under + this License, under the terms defined in section 4 above for + modified versions, provided that you include in the combination all + of the Invariant Sections of all of the original documents, + unmodified, and list them all as Invariant Sections of your + combined work in its license notice, and that you preserve all + their Warranty Disclaimers. + + The combined work need only contain one copy of this License, and + multiple identical Invariant Sections may be replaced with a single + copy. If there are multiple Invariant Sections with the same name + but different contents, make the title of each such section unique + by adding at the end of it, in parentheses, the name of the + original author or publisher of that section if known, or else a + unique number. Make the same adjustment to the section titles in + the list of Invariant Sections in the license notice of the + combined work. + + In the combination, you must combine any sections Entitled + "History" in the various original documents, forming one section + Entitled "History"; likewise combine any sections Entitled + "Acknowledgements", and any sections Entitled "Dedications". You + must delete all sections Entitled "Endorsements." + + 6. COLLECTIONS OF DOCUMENTS + + You may make a collection consisting of the Document and other + documents released under this License, and replace the individual + copies of this License in the various documents with a single copy + that is included in the collection, provided that you follow the + rules of this License for verbatim copying of each of the documents + in all other respects. + + You may extract a single document from such a collection, and + distribute it individually under this License, provided you insert + a copy of this License into the extracted document, and follow this + License in all other respects regarding verbatim copying of that + document. + + 7. AGGREGATION WITH INDEPENDENT WORKS + + A compilation of the Document or its derivatives with other + separate and independent documents or works, in or on a volume of a + storage or distribution medium, is called an "aggregate" if the + copyright resulting from the compilation is not used to limit the + legal rights of the compilation's users beyond what the individual + works permit. When the Document is included in an aggregate, this + License does not apply to the other works in the aggregate which + are not themselves derivative works of the Document. + + If the Cover Text requirement of section 3 is applicable to these + copies of the Document, then if the Document is less than one half + of the entire aggregate, the Document's Cover Texts may be placed + on covers that bracket the Document within the aggregate, or the + electronic equivalent of covers if the Document is in electronic + form. Otherwise they must appear on printed covers that bracket + the whole aggregate. + + 8. TRANSLATION + + Translation is considered a kind of modification, so you may + distribute translations of the Document under the terms of section + 4. Replacing Invariant Sections with translations requires special + permission from their copyright holders, but you may include + translations of some or all Invariant Sections in addition to the + original versions of these Invariant Sections. You may include a + translation of this License, and all the license notices in the + Document, and any Warranty Disclaimers, provided that you also + include the original English version of this License and the + original versions of those notices and disclaimers. In case of a + disagreement between the translation and the original version of + this License or a notice or disclaimer, the original version will + prevail. + + If a section in the Document is Entitled "Acknowledgements", + "Dedications", or "History", the requirement (section 4) to + Preserve its Title (section 1) will typically require changing the + actual title. + + 9. TERMINATION + + You may not copy, modify, sublicense, or distribute the Document + except as expressly provided under this License. Any attempt + otherwise to copy, modify, sublicense, or distribute it is void, + and will automatically terminate your rights under this License. + + However, if you cease all violation of this License, then your + license from a particular copyright holder is reinstated (a) + provisionally, unless and until the copyright holder explicitly and + finally terminates your license, and (b) permanently, if the + copyright holder fails to notify you of the violation by some + reasonable means prior to 60 days after the cessation. + + Moreover, your license from a particular copyright holder is + reinstated permanently if the copyright holder notifies you of the + violation by some reasonable means, this is the first time you have + received notice of violation of this License (for any work) from + that copyright holder, and you cure the violation prior to 30 days + after your receipt of the notice. + + Termination of your rights under this section does not terminate + the licenses of parties who have received copies or rights from you + under this License. If your rights have been terminated and not + permanently reinstated, receipt of a copy of some or all of the + same material does not give you any rights to use it. + + 10. FUTURE REVISIONS OF THIS LICENSE + + The Free Software Foundation may publish new, revised versions of + the GNU Free Documentation License from time to time. Such new + versions will be similar in spirit to the present version, but may + differ in detail to address new problems or concerns. See + <http://www.gnu.org/copyleft/>. + + Each version of the License is given a distinguishing version + number. If the Document specifies that a particular numbered + version of this License "or any later version" applies to it, you + have the option of following the terms and conditions either of + that specified version or of any later version that has been + published (not as a draft) by the Free Software Foundation. If + the Document does not specify a version number of this License, + you may choose any version ever published (not as a draft) by the + Free Software Foundation. If the Document specifies that a proxy + can decide which future versions of this License can be used, that + proxy's public statement of acceptance of a version permanently + authorizes you to choose that version for the Document. + + 11. RELICENSING + + "Massive Multiauthor Collaboration Site" (or "MMC Site") means any + World Wide Web server that publishes copyrightable works and also + provides prominent facilities for anybody to edit those works. A + public wiki that anybody can edit is an example of such a server. + A "Massive Multiauthor Collaboration" (or "MMC") contained in the + site means any set of copyrightable works thus published on the + MMC site. + + "CC-BY-SA" means the Creative Commons Attribution-Share Alike 3.0 + license published by Creative Commons Corporation, a + not-for-profit corporation with a principal place of business in + San Francisco, California, as well as future copyleft versions of + that license published by that same organization. + + "Incorporate" means to publish or republish a Document, in whole + or in part, as part of another Document. + + An MMC is "eligible for relicensing" if it is licensed under this + License, and if all works that were first published under this + License somewhere other than this MMC, and subsequently + incorporated in whole or in part into the MMC, (1) had no cover + texts or invariant sections, and (2) were thus incorporated prior + to November 1, 2008. + + The operator of an MMC Site may republish an MMC contained in the + site under CC-BY-SA on the same site at any time before August 1, + 2009, provided the MMC is eligible for relicensing. + + +ADDENDUM: How to use this License for your documents +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + To use this License in a document you have written, include a copy of + the License in the document and put the following copyright and + license notices just after the title page: + + ,---- + | Copyright (C) YEAR YOUR NAME. + | Permission is granted to copy, distribute and/or modify this document + | under the terms of the GNU Free Documentation License, Version 1.3 + | or any later version published by the Free Software Foundation; + | with no Invariant Sections, no Front-Cover Texts, and no Back-Cover + | Texts. A copy of the license is included in the section entitled ``GNU + | Free Documentation License''. + `---- + + If you have Invariant Sections, Front-Cover Texts and Back-Cover + Texts, replace the "with...Texts." line with this: + + ,---- + | with the Invariant Sections being LIST THEIR TITLES, with + | the Front-Cover Texts being LIST, and with the Back-Cover Texts + | being LIST. + `---- + + If you have Invariant Sections without Cover Texts, or some other + combination of the three, merge those two alternatives to suit the + situation. + + If your document contains nontrivial examples of program code, we + recommend releasing these examples in parallel under your choice of + free software license, such as the GNU General Public License, to + permit their use in free software. diff --git a/src/docs/0010.html b/docs/docs/carbslinux/0010.html index fad5ef3..fa3dd1b 100644 --- a/src/docs/0010.html +++ b/docs/docs/carbslinux/0010.html @@ -38,6 +38,7 @@ span.sansserif {font-family: sans-serif; font-weight: normal} ul.no-bullet {list-style: none} --> </style> +<link rel="stylesheet" type="text/css" href="https://www.gnu.org/software/gnulib/manual.css"> <meta http-equiv="Refresh" content="0; url=Conventions.html#g_t0010"> diff --git a/src/docs/0011.html b/docs/docs/carbslinux/0011.html index ab45257..69daf27 100644 --- a/src/docs/0011.html +++ b/docs/docs/carbslinux/0011.html @@ -38,6 +38,7 @@ span.sansserif {font-family: sans-serif; font-weight: normal} ul.no-bullet {list-style: none} --> </style> +<link rel="stylesheet" type="text/css" href="https://www.gnu.org/software/gnulib/manual.css"> <meta http-equiv="Refresh" content="0; url=Conventions.html#g_t0011"> diff --git a/src/docs/0012.html b/docs/docs/carbslinux/0012.html index 32dca75..e2bed83 100644 --- a/src/docs/0012.html +++ b/docs/docs/carbslinux/0012.html @@ -38,6 +38,7 @@ span.sansserif {font-family: sans-serif; font-weight: normal} ul.no-bullet {list-style: none} --> </style> +<link rel="stylesheet" type="text/css" href="https://www.gnu.org/software/gnulib/manual.css"> <meta http-equiv="Refresh" content="0; url=Conventions.html#g_t0012"> diff --git a/docs/docs/0013.html b/docs/docs/carbslinux/0013.html index 27102b1..5551717 100644 --- a/docs/docs/0013.html +++ b/docs/docs/carbslinux/0013.html @@ -38,6 +38,7 @@ span.sansserif {font-family: sans-serif; font-weight: normal} ul.no-bullet {list-style: none} --> </style> +<link rel="stylesheet" type="text/css" href="https://www.gnu.org/software/gnulib/manual.css"> <meta http-equiv="Refresh" content="0; url=Conventions.html#g_t0013"> diff --git a/docs/docs/1010.html b/docs/docs/carbslinux/1010.html index a9635e8..fd3abcf 100644 --- a/docs/docs/1010.html +++ b/docs/docs/carbslinux/1010.html @@ -38,6 +38,7 @@ span.sansserif {font-family: sans-serif; font-weight: normal} ul.no-bullet {list-style: none} --> </style> +<link rel="stylesheet" type="text/css" href="https://www.gnu.org/software/gnulib/manual.css"> <meta http-equiv="Refresh" content="0; url=Shell-Conventions.html#g_t1010"> diff --git a/src/docs/1020.html b/docs/docs/carbslinux/1020.html index 2f73bac..6c23536 100644 --- a/src/docs/1020.html +++ b/docs/docs/carbslinux/1020.html @@ -38,6 +38,7 @@ span.sansserif {font-family: sans-serif; font-weight: normal} ul.no-bullet {list-style: none} --> </style> +<link rel="stylesheet" type="text/css" href="https://www.gnu.org/software/gnulib/manual.css"> <meta http-equiv="Refresh" content="0; url=Shell-Conventions.html#g_t1020"> diff --git a/src/docs/1030.html b/docs/docs/carbslinux/1030.html index bb51640..ca4c4f1 100644 --- a/src/docs/1030.html +++ b/docs/docs/carbslinux/1030.html @@ -38,6 +38,7 @@ span.sansserif {font-family: sans-serif; font-weight: normal} ul.no-bullet {list-style: none} --> </style> +<link rel="stylesheet" type="text/css" href="https://www.gnu.org/software/gnulib/manual.css"> <meta http-equiv="Refresh" content="0; url=Shell-Conventions.html#g_t1030"> diff --git a/src/docs/1040.html b/docs/docs/carbslinux/1040.html index ae10d79..783086a 100644 --- a/src/docs/1040.html +++ b/docs/docs/carbslinux/1040.html @@ -38,6 +38,7 @@ span.sansserif {font-family: sans-serif; font-weight: normal} ul.no-bullet {list-style: none} --> </style> +<link rel="stylesheet" type="text/css" href="https://www.gnu.org/software/gnulib/manual.css"> <meta http-equiv="Refresh" content="0; url=Shell-Conventions.html#g_t1040"> diff --git a/docs/docs/1041.html b/docs/docs/carbslinux/1041.html index a75e629..0105a70 100644 --- a/docs/docs/1041.html +++ b/docs/docs/carbslinux/1041.html @@ -38,6 +38,7 @@ span.sansserif {font-family: sans-serif; font-weight: normal} ul.no-bullet {list-style: none} --> </style> +<link rel="stylesheet" type="text/css" href="https://www.gnu.org/software/gnulib/manual.css"> <meta http-equiv="Refresh" content="0; url=Shell-Conventions.html#g_t1041"> diff --git a/docs/docs/1042.html b/docs/docs/carbslinux/1042.html index c9e5426..433eef2 100644 --- a/docs/docs/1042.html +++ b/docs/docs/carbslinux/1042.html @@ -38,6 +38,7 @@ span.sansserif {font-family: sans-serif; font-weight: normal} ul.no-bullet {list-style: none} --> </style> +<link rel="stylesheet" type="text/css" href="https://www.gnu.org/software/gnulib/manual.css"> <meta http-equiv="Refresh" content="0; url=Shell-Conventions.html#g_t1042"> diff --git a/docs/docs/1043.html b/docs/docs/carbslinux/1043.html index 32807ad..d15d15c 100644 --- a/docs/docs/1043.html +++ b/docs/docs/carbslinux/1043.html @@ -38,6 +38,7 @@ span.sansserif {font-family: sans-serif; font-weight: normal} ul.no-bullet {list-style: none} --> </style> +<link rel="stylesheet" type="text/css" href="https://www.gnu.org/software/gnulib/manual.css"> <meta http-equiv="Refresh" content="0; url=Shell-Conventions.html#g_t1043"> diff --git a/docs/docs/1050.html b/docs/docs/carbslinux/1050.html index c913527..8908db4 100644 --- a/docs/docs/1050.html +++ b/docs/docs/carbslinux/1050.html @@ -38,6 +38,7 @@ span.sansserif {font-family: sans-serif; font-weight: normal} ul.no-bullet {list-style: none} --> </style> +<link rel="stylesheet" type="text/css" href="https://www.gnu.org/software/gnulib/manual.css"> <meta http-equiv="Refresh" content="0; url=Shell-Conventions.html#g_t1050"> diff --git a/docs/docs/2010.html b/docs/docs/carbslinux/2010.html index 482ddf3..a6b7f67 100644 --- a/docs/docs/2010.html +++ b/docs/docs/carbslinux/2010.html @@ -38,6 +38,7 @@ span.sansserif {font-family: sans-serif; font-weight: normal} ul.no-bullet {list-style: none} --> </style> +<link rel="stylesheet" type="text/css" href="https://www.gnu.org/software/gnulib/manual.css"> <meta http-equiv="Refresh" content="0; url=Repository-Conventions.html#g_t2010"> diff --git a/src/docs/2020.html b/docs/docs/carbslinux/2020.html index dab5be2..28febe7 100644 --- a/src/docs/2020.html +++ b/docs/docs/carbslinux/2020.html @@ -38,6 +38,7 @@ span.sansserif {font-family: sans-serif; font-weight: normal} ul.no-bullet {list-style: none} --> </style> +<link rel="stylesheet" type="text/css" href="https://www.gnu.org/software/gnulib/manual.css"> <meta http-equiv="Refresh" content="0; url=Repository-Conventions.html#g_t2020"> diff --git a/src/docs/2030.html b/docs/docs/carbslinux/2030.html index 353fd6f..451a74c 100644 --- a/src/docs/2030.html +++ b/docs/docs/carbslinux/2030.html @@ -38,6 +38,7 @@ span.sansserif {font-family: sans-serif; font-weight: normal} ul.no-bullet {list-style: none} --> </style> +<link rel="stylesheet" type="text/css" href="https://www.gnu.org/software/gnulib/manual.css"> <meta http-equiv="Refresh" content="0; url=Repository-Conventions.html#g_t2030"> diff --git a/src/docs/2040.html b/docs/docs/carbslinux/2040.html index 84e108a..8263dbc 100644 --- a/src/docs/2040.html +++ b/docs/docs/carbslinux/2040.html @@ -38,6 +38,7 @@ span.sansserif {font-family: sans-serif; font-weight: normal} ul.no-bullet {list-style: none} --> </style> +<link rel="stylesheet" type="text/css" href="https://www.gnu.org/software/gnulib/manual.css"> <meta http-equiv="Refresh" content="0; url=Repository-Conventions.html#g_t2040"> diff --git a/docs/docs/2050.html b/docs/docs/carbslinux/2050.html index a8b2a70..38e5164 100644 --- a/docs/docs/2050.html +++ b/docs/docs/carbslinux/2050.html @@ -38,6 +38,7 @@ span.sansserif {font-family: sans-serif; font-weight: normal} ul.no-bullet {list-style: none} --> </style> +<link rel="stylesheet" type="text/css" href="https://www.gnu.org/software/gnulib/manual.css"> <meta http-equiv="Refresh" content="0; url=Repository-Conventions.html#g_t2050"> diff --git a/docs/docs/2210.html b/docs/docs/carbslinux/2210.html index 1304a27..a48998d 100644 --- a/docs/docs/2210.html +++ b/docs/docs/carbslinux/2210.html @@ -38,6 +38,7 @@ span.sansserif {font-family: sans-serif; font-weight: normal} ul.no-bullet {list-style: none} --> </style> +<link rel="stylesheet" type="text/css" href="https://www.gnu.org/software/gnulib/manual.css"> <meta http-equiv="Refresh" content="0; url=Repository-Conventions.html#g_t2210"> diff --git a/docs/docs/2211.html b/docs/docs/carbslinux/2211.html index 9d2f2b3..018f16b 100644 --- a/docs/docs/2211.html +++ b/docs/docs/carbslinux/2211.html @@ -38,6 +38,7 @@ span.sansserif {font-family: sans-serif; font-weight: normal} ul.no-bullet {list-style: none} --> </style> +<link rel="stylesheet" type="text/css" href="https://www.gnu.org/software/gnulib/manual.css"> <meta http-equiv="Refresh" content="0; url=Repository-Conventions.html#g_t2211"> diff --git a/docs/docs/2212.html b/docs/docs/carbslinux/2212.html index e14d231..8937bda 100644 --- a/docs/docs/2212.html +++ b/docs/docs/carbslinux/2212.html @@ -38,6 +38,7 @@ span.sansserif {font-family: sans-serif; font-weight: normal} ul.no-bullet {list-style: none} --> </style> +<link rel="stylesheet" type="text/css" href="https://www.gnu.org/software/gnulib/manual.css"> <meta http-equiv="Refresh" content="0; url=Repository-Conventions.html#g_t2212"> diff --git a/docs/docs/2220.html b/docs/docs/carbslinux/2220.html index 4012c71..505b409 100644 --- a/docs/docs/2220.html +++ b/docs/docs/carbslinux/2220.html @@ -38,6 +38,7 @@ span.sansserif {font-family: sans-serif; font-weight: normal} ul.no-bullet {list-style: none} --> </style> +<link rel="stylesheet" type="text/css" href="https://www.gnu.org/software/gnulib/manual.css"> <meta http-equiv="Refresh" content="0; url=Repository-Conventions.html#g_t2220"> diff --git a/docs/docs/2230.html b/docs/docs/carbslinux/2230.html index b03a69c..36319c1 100644 --- a/docs/docs/2230.html +++ b/docs/docs/carbslinux/2230.html @@ -38,6 +38,7 @@ span.sansserif {font-family: sans-serif; font-weight: normal} ul.no-bullet {list-style: none} --> </style> +<link rel="stylesheet" type="text/css" href="https://www.gnu.org/software/gnulib/manual.css"> <meta http-equiv="Refresh" content="0; url=Repository-Conventions.html#g_t2230"> diff --git a/docs/docs/2240.html b/docs/docs/carbslinux/2240.html index c8e98f2..44b3647 100644 --- a/docs/docs/2240.html +++ b/docs/docs/carbslinux/2240.html @@ -38,6 +38,7 @@ span.sansserif {font-family: sans-serif; font-weight: normal} ul.no-bullet {list-style: none} --> </style> +<link rel="stylesheet" type="text/css" href="https://www.gnu.org/software/gnulib/manual.css"> <meta http-equiv="Refresh" content="0; url=Repository-Conventions.html#g_t2240"> diff --git a/docs/docs/2241.html b/docs/docs/carbslinux/2241.html index dba5354..73d123e 100644 --- a/docs/docs/2241.html +++ b/docs/docs/carbslinux/2241.html @@ -38,6 +38,7 @@ span.sansserif {font-family: sans-serif; font-weight: normal} ul.no-bullet {list-style: none} --> </style> +<link rel="stylesheet" type="text/css" href="https://www.gnu.org/software/gnulib/manual.css"> <meta http-equiv="Refresh" content="0; url=Repository-Conventions.html#g_t2241"> diff --git a/docs/docs/ADDENDUM-How-to-use-this-License-for-your-documents.html b/docs/docs/carbslinux/ADDENDUM-How-to-use-this-License-for-your-documents.html index b3423c8..0664ccd 100644 --- a/docs/docs/ADDENDUM-How-to-use-this-License-for-your-documents.html +++ b/docs/docs/carbslinux/ADDENDUM-How-to-use-this-License-for-your-documents.html @@ -38,6 +38,7 @@ span.sansserif {font-family: sans-serif; font-weight: normal} ul.no-bullet {list-style: none} --> </style> +<link rel="stylesheet" type="text/css" href="https://www.gnu.org/software/gnulib/manual.css"> <meta http-equiv="Refresh" content="0; url=GNU-Free-Documentation-License.html#ADDENDUM-How-to-use-this-License-for-your-documents"> diff --git a/docs/docs/Bootloader.html b/docs/docs/carbslinux/Bootloader.html index 6f23a5b..8b52d9d 100644 --- a/docs/docs/Bootloader.html +++ b/docs/docs/carbslinux/Bootloader.html @@ -42,6 +42,7 @@ span.sansserif {font-family: sans-serif; font-weight: normal} ul.no-bullet {list-style: none} --> </style> +<link rel="stylesheet" type="text/css" href="https://www.gnu.org/software/gnulib/manual.css"> </head> diff --git a/docs/docs/Building-the-kernel.html b/docs/docs/carbslinux/Building-the-kernel.html index e0f5ee2..250925d 100644 --- a/docs/docs/Building-the-kernel.html +++ b/docs/docs/carbslinux/Building-the-kernel.html @@ -42,6 +42,7 @@ span.sansserif {font-family: sans-serif; font-weight: normal} ul.no-bullet {list-style: none} --> </style> +<link rel="stylesheet" type="text/css" href="https://www.gnu.org/software/gnulib/manual.css"> </head> diff --git a/src/docs/Changing-Init-Program.html b/docs/docs/carbslinux/Changing-Init-Program.html index d1cc7ce..41568f9 100644 --- a/src/docs/Changing-Init-Program.html +++ b/docs/docs/carbslinux/Changing-Init-Program.html @@ -42,6 +42,7 @@ span.sansserif {font-family: sans-serif; font-weight: normal} ul.no-bullet {list-style: none} --> </style> +<link rel="stylesheet" type="text/css" href="https://www.gnu.org/software/gnulib/manual.css"> </head> diff --git a/docs/docs/Chroot.html b/docs/docs/carbslinux/Chroot.html index c648361..02749c4 100644 --- a/docs/docs/Chroot.html +++ b/docs/docs/carbslinux/Chroot.html @@ -42,6 +42,7 @@ span.sansserif {font-family: sans-serif; font-weight: normal} ul.no-bullet {list-style: none} --> </style> +<link rel="stylesheet" type="text/css" href="https://www.gnu.org/software/gnulib/manual.css"> </head> diff --git a/docs/docs/Configuring-Init.html b/docs/docs/carbslinux/Configuring-Init.html index 93f7f35..d8fe8fd 100644 --- a/docs/docs/Configuring-Init.html +++ b/docs/docs/carbslinux/Configuring-Init.html @@ -42,6 +42,7 @@ span.sansserif {font-family: sans-serif; font-weight: normal} ul.no-bullet {list-style: none} --> </style> +<link rel="stylesheet" type="text/css" href="https://www.gnu.org/software/gnulib/manual.css"> </head> diff --git a/docs/docs/Configuring-hostname.html b/docs/docs/carbslinux/Configuring-hostname.html index f4d4bee..b3c2a29 100644 --- a/docs/docs/Configuring-hostname.html +++ b/docs/docs/carbslinux/Configuring-hostname.html @@ -42,6 +42,7 @@ span.sansserif {font-family: sans-serif; font-weight: normal} ul.no-bullet {list-style: none} --> </style> +<link rel="stylesheet" type="text/css" href="https://www.gnu.org/software/gnulib/manual.css"> </head> diff --git a/src/docs/Contribution-Guidelines.html b/docs/docs/carbslinux/Contribution-Guidelines.html index 5b2c7cf..df6c4b1 100644 --- a/src/docs/Contribution-Guidelines.html +++ b/docs/docs/carbslinux/Contribution-Guidelines.html @@ -42,6 +42,7 @@ span.sansserif {font-family: sans-serif; font-weight: normal} ul.no-bullet {list-style: none} --> </style> +<link rel="stylesheet" type="text/css" href="https://www.gnu.org/software/gnulib/manual.css"> </head> diff --git a/src/docs/Conventions.html b/docs/docs/carbslinux/Conventions.html index e1b3ac6..b91b9a7 100644 --- a/src/docs/Conventions.html +++ b/docs/docs/carbslinux/Conventions.html @@ -42,6 +42,7 @@ span.sansserif {font-family: sans-serif; font-weight: normal} ul.no-bullet {list-style: none} --> </style> +<link rel="stylesheet" type="text/css" href="https://www.gnu.org/software/gnulib/manual.css"> </head> diff --git a/src/docs/Download.html b/docs/docs/carbslinux/Download.html index 5d2a595..ef12617 100644 --- a/src/docs/Download.html +++ b/docs/docs/carbslinux/Download.html @@ -42,6 +42,7 @@ span.sansserif {font-family: sans-serif; font-weight: normal} ul.no-bullet {list-style: none} --> </style> +<link rel="stylesheet" type="text/css" href="https://www.gnu.org/software/gnulib/manual.css"> </head> diff --git a/docs/docs/Essential-Software.html b/docs/docs/carbslinux/Essential-Software.html index 3910e9b..2c24ed7 100644 --- a/docs/docs/Essential-Software.html +++ b/docs/docs/carbslinux/Essential-Software.html @@ -42,6 +42,7 @@ span.sansserif {font-family: sans-serif; font-weight: normal} ul.no-bullet {list-style: none} --> </style> +<link rel="stylesheet" type="text/css" href="https://www.gnu.org/software/gnulib/manual.css"> </head> diff --git a/docs/docs/Extracting-the-tarball.html b/docs/docs/carbslinux/Extracting-the-tarball.html index 8659608..a562feb 100644 --- a/docs/docs/Extracting-the-tarball.html +++ b/docs/docs/carbslinux/Extracting-the-tarball.html @@ -42,6 +42,7 @@ span.sansserif {font-family: sans-serif; font-weight: normal} ul.no-bullet {list-style: none} --> </style> +<link rel="stylesheet" type="text/css" href="https://www.gnu.org/software/gnulib/manual.css"> </head> diff --git a/docs/docs/Fstab.html b/docs/docs/carbslinux/Fstab.html index d4573ec..43ab331 100644 --- a/docs/docs/Fstab.html +++ b/docs/docs/carbslinux/Fstab.html @@ -42,6 +42,7 @@ span.sansserif {font-family: sans-serif; font-weight: normal} ul.no-bullet {list-style: none} --> </style> +<link rel="stylesheet" type="text/css" href="https://www.gnu.org/software/gnulib/manual.css"> </head> diff --git a/docs/docs/GNU-Free-Documentation-License.html b/docs/docs/carbslinux/GNU-Free-Documentation-License.html index 4fb6747..bda1afd 100644 --- a/docs/docs/GNU-Free-Documentation-License.html +++ b/docs/docs/carbslinux/GNU-Free-Documentation-License.html @@ -41,6 +41,7 @@ span.sansserif {font-family: sans-serif; font-weight: normal} ul.no-bullet {list-style: none} --> </style> +<link rel="stylesheet" type="text/css" href="https://www.gnu.org/software/gnulib/manual.css"> </head> diff --git a/src/docs/Hosts-file.html b/docs/docs/carbslinux/Hosts-file.html index ed26d62..8ca871d 100644 --- a/src/docs/Hosts-file.html +++ b/docs/docs/carbslinux/Hosts-file.html @@ -42,6 +42,7 @@ span.sansserif {font-family: sans-serif; font-weight: normal} ul.no-bullet {list-style: none} --> </style> +<link rel="stylesheet" type="text/css" href="https://www.gnu.org/software/gnulib/manual.css"> </head> diff --git a/src/docs/Init-Hooks.html b/docs/docs/carbslinux/Init-Hooks.html index 52e2e84..03ea867 100644 --- a/src/docs/Init-Hooks.html +++ b/docs/docs/carbslinux/Init-Hooks.html @@ -42,6 +42,7 @@ span.sansserif {font-family: sans-serif; font-weight: normal} ul.no-bullet {list-style: none} --> </style> +<link rel="stylesheet" type="text/css" href="https://www.gnu.org/software/gnulib/manual.css"> </head> diff --git a/src/docs/Init-System.html b/docs/docs/carbslinux/Init-System.html index 3d23ab0..bbba51f 100644 --- a/src/docs/Init-System.html +++ b/docs/docs/carbslinux/Init-System.html @@ -42,6 +42,7 @@ span.sansserif {font-family: sans-serif; font-weight: normal} ul.no-bullet {list-style: none} --> </style> +<link rel="stylesheet" type="text/css" href="https://www.gnu.org/software/gnulib/manual.css"> </head> diff --git a/docs/docs/Init-scripts.html b/docs/docs/carbslinux/Init-scripts.html index bd5a32a..6b81ed0 100644 --- a/docs/docs/Init-scripts.html +++ b/docs/docs/carbslinux/Init-scripts.html @@ -42,6 +42,7 @@ span.sansserif {font-family: sans-serif; font-weight: normal} ul.no-bullet {list-style: none} --> </style> +<link rel="stylesheet" type="text/css" href="https://www.gnu.org/software/gnulib/manual.css"> </head> diff --git a/src/docs/Installation.html b/docs/docs/carbslinux/Installation.html index d088c4d..64dd231 100644 --- a/src/docs/Installation.html +++ b/docs/docs/carbslinux/Installation.html @@ -42,6 +42,7 @@ span.sansserif {font-family: sans-serif; font-weight: normal} ul.no-bullet {list-style: none} --> </style> +<link rel="stylesheet" type="text/css" href="https://www.gnu.org/software/gnulib/manual.css"> </head> @@ -56,10 +57,10 @@ Next: <a href="Init-System.html" accesskey="n" rel="next">Init System</a>, Previ <p>These are the step-by-step instructions for installing Carbs Linux. It can be acquired as plain-text to be viewed offline with a pager from -<a href="https://carbslinux.org/docs/install.txt">https://carbslinux.org/docs/install.txt</a>. +<a href="https://carbslinux.org/install.txt">https://carbslinux.org/install.txt</a>. </p> <div class="example"> -<pre class="example">curl -sL https://carbslinux.org/docs/install.txt | less +<pre class="example">curl -sL https://carbslinux.org/install.txt | less </pre></div> <table class="menu" border="0" cellspacing="0"> diff --git a/docs/docs/Installing-packages.html b/docs/docs/carbslinux/Installing-packages.html index 2a2e342..3838155 100644 --- a/docs/docs/Installing-packages.html +++ b/docs/docs/carbslinux/Installing-packages.html @@ -42,6 +42,7 @@ span.sansserif {font-family: sans-serif; font-weight: normal} ul.no-bullet {list-style: none} --> </style> +<link rel="stylesheet" type="text/css" href="https://www.gnu.org/software/gnulib/manual.css"> </head> diff --git a/docs/docs/KISS-repositories.html b/docs/docs/carbslinux/KISS-repositories.html index 3824e9e..755007d 100644 --- a/docs/docs/KISS-repositories.html +++ b/docs/docs/carbslinux/KISS-repositories.html @@ -42,6 +42,7 @@ span.sansserif {font-family: sans-serif; font-weight: normal} ul.no-bullet {list-style: none} --> </style> +<link rel="stylesheet" type="text/css" href="https://www.gnu.org/software/gnulib/manual.css"> </head> diff --git a/docs/docs/Kernel-Command-Line.html b/docs/docs/carbslinux/Kernel-Command-Line.html index a099dc8..2f73ec9 100644 --- a/docs/docs/Kernel-Command-Line.html +++ b/docs/docs/carbslinux/Kernel-Command-Line.html @@ -42,6 +42,7 @@ span.sansserif {font-family: sans-serif; font-weight: normal} ul.no-bullet {list-style: none} --> </style> +<link rel="stylesheet" type="text/css" href="https://www.gnu.org/software/gnulib/manual.css"> </head> diff --git a/src/docs/Kernel-dependencies.html b/docs/docs/carbslinux/Kernel-dependencies.html index 192479b..f5ee8b0 100644 --- a/src/docs/Kernel-dependencies.html +++ b/docs/docs/carbslinux/Kernel-dependencies.html @@ -42,6 +42,7 @@ span.sansserif {font-family: sans-serif; font-weight: normal} ul.no-bullet {list-style: none} --> </style> +<link rel="stylesheet" type="text/css" href="https://www.gnu.org/software/gnulib/manual.css"> </head> @@ -55,8 +56,8 @@ Next: <a href="Building-the-kernel.html" accesskey="n" rel="next">Building the k <span id="Kernel-dependencies-1"></span><h4 class="subsection">1.4.2 Kernel dependencies</h4> <p>In order to compile the kernel you will need to install some dependencies. You -will need ‘<samp>libelf</samp>’ to compile the kernel. If you want to configure using the -menu interface you will also need ‘<samp>ncurses</samp>’. +will need ‘<samp>libelf</samp>’, and ‘<samp>bison</samp>’ to compile the kernel. If you want to configure +using the menu interface you will also need ‘<samp>ncurses</samp>’. </p> <div class="example"> <pre class="example"># The package manager asks to install if you are building more than one package, diff --git a/docs/docs/Kernel.html b/docs/docs/carbslinux/Kernel.html index 10f3945..fe31cd7 100644 --- a/docs/docs/Kernel.html +++ b/docs/docs/carbslinux/Kernel.html @@ -42,6 +42,7 @@ span.sansserif {font-family: sans-serif; font-weight: normal} ul.no-bullet {list-style: none} --> </style> +<link rel="stylesheet" type="text/css" href="https://www.gnu.org/software/gnulib/manual.css"> </head> diff --git a/docs/docs/Making-your-system-bootable.html b/docs/docs/carbslinux/Making-your-system-bootable.html index 2e3a759..43c369d 100644 --- a/docs/docs/Making-your-system-bootable.html +++ b/docs/docs/carbslinux/Making-your-system-bootable.html @@ -42,6 +42,7 @@ span.sansserif {font-family: sans-serif; font-weight: normal} ul.no-bullet {list-style: none} --> </style> +<link rel="stylesheet" type="text/css" href="https://www.gnu.org/software/gnulib/manual.css"> </head> diff --git a/src/docs/Obtain-the-chroot-helper.html b/docs/docs/carbslinux/Obtain-the-chroot-helper.html index e5fc1d3..3a29294 100644 --- a/src/docs/Obtain-the-chroot-helper.html +++ b/docs/docs/carbslinux/Obtain-the-chroot-helper.html @@ -42,6 +42,7 @@ span.sansserif {font-family: sans-serif; font-weight: normal} ul.no-bullet {list-style: none} --> </style> +<link rel="stylesheet" type="text/css" href="https://www.gnu.org/software/gnulib/manual.css"> </head> diff --git a/docs/docs/Obtaining-the-documentation.html b/docs/docs/carbslinux/Obtaining-the-documentation.html index 03739b5..c9ff1c8 100644 --- a/docs/docs/Obtaining-the-documentation.html +++ b/docs/docs/carbslinux/Obtaining-the-documentation.html @@ -42,6 +42,7 @@ span.sansserif {font-family: sans-serif; font-weight: normal} ul.no-bullet {list-style: none} --> </style> +<link rel="stylesheet" type="text/css" href="https://www.gnu.org/software/gnulib/manual.css"> </head> diff --git a/src/docs/Obtaining-the-kernel-sources.html b/docs/docs/carbslinux/Obtaining-the-kernel-sources.html index 5acdb26..34c92ed 100644 --- a/src/docs/Obtaining-the-kernel-sources.html +++ b/docs/docs/carbslinux/Obtaining-the-kernel-sources.html @@ -42,6 +42,7 @@ span.sansserif {font-family: sans-serif; font-weight: normal} ul.no-bullet {list-style: none} --> </style> +<link rel="stylesheet" type="text/css" href="https://www.gnu.org/software/gnulib/manual.css"> </head> diff --git a/src/docs/Post_002dinstallation.html b/docs/docs/carbslinux/Post_002dinstallation.html index da1dc05..9dcfed8 100644 --- a/src/docs/Post_002dinstallation.html +++ b/docs/docs/carbslinux/Post_002dinstallation.html @@ -42,6 +42,7 @@ span.sansserif {font-family: sans-serif; font-weight: normal} ul.no-bullet {list-style: none} --> </style> +<link rel="stylesheet" type="text/css" href="https://www.gnu.org/software/gnulib/manual.css"> </head> diff --git a/docs/docs/Preparing-Environment.html b/docs/docs/carbslinux/Preparing-Environment.html index 89fc029..a6c2ce8 100644 --- a/docs/docs/Preparing-Environment.html +++ b/docs/docs/carbslinux/Preparing-Environment.html @@ -42,6 +42,7 @@ span.sansserif {font-family: sans-serif; font-weight: normal} ul.no-bullet {list-style: none} --> </style> +<link rel="stylesheet" type="text/css" href="https://www.gnu.org/software/gnulib/manual.css"> </head> diff --git a/src/docs/Rebooting-after-changing-init.html b/docs/docs/carbslinux/Rebooting-after-changing-init.html index 85d02cf..d586bbd 100644 --- a/src/docs/Rebooting-after-changing-init.html +++ b/docs/docs/carbslinux/Rebooting-after-changing-init.html @@ -42,6 +42,7 @@ span.sansserif {font-family: sans-serif; font-weight: normal} ul.no-bullet {list-style: none} --> </style> +<link rel="stylesheet" type="text/css" href="https://www.gnu.org/software/gnulib/manual.css"> </head> diff --git a/src/docs/Repository-Conventions.html b/docs/docs/carbslinux/Repository-Conventions.html index 598cc7a..79b7eec 100644 --- a/src/docs/Repository-Conventions.html +++ b/docs/docs/carbslinux/Repository-Conventions.html @@ -42,6 +42,7 @@ span.sansserif {font-family: sans-serif; font-weight: normal} ul.no-bullet {list-style: none} --> </style> +<link rel="stylesheet" type="text/css" href="https://www.gnu.org/software/gnulib/manual.css"> </head> diff --git a/docs/docs/Setting-up-repositories.html b/docs/docs/carbslinux/Setting-up-repositories.html index 44360ab..1c7310e 100644 --- a/docs/docs/Setting-up-repositories.html +++ b/docs/docs/carbslinux/Setting-up-repositories.html @@ -42,6 +42,7 @@ span.sansserif {font-family: sans-serif; font-weight: normal} ul.no-bullet {list-style: none} --> </style> +<link rel="stylesheet" type="text/css" href="https://www.gnu.org/software/gnulib/manual.css"> </head> diff --git a/src/docs/Shell-Conventions.html b/docs/docs/carbslinux/Shell-Conventions.html index dd841de..5902238 100644 --- a/src/docs/Shell-Conventions.html +++ b/docs/docs/carbslinux/Shell-Conventions.html @@ -42,6 +42,7 @@ span.sansserif {font-family: sans-serif; font-weight: normal} ul.no-bullet {list-style: none} --> </style> +<link rel="stylesheet" type="text/css" href="https://www.gnu.org/software/gnulib/manual.css"> </head> diff --git a/docs/docs/Signature-verification.html b/docs/docs/carbslinux/Signature-verification.html index 8dccbe3..9eb486d 100644 --- a/docs/docs/Signature-verification.html +++ b/docs/docs/carbslinux/Signature-verification.html @@ -42,6 +42,7 @@ span.sansserif {font-family: sans-serif; font-weight: normal} ul.no-bullet {list-style: none} --> </style> +<link rel="stylesheet" type="text/css" href="https://www.gnu.org/software/gnulib/manual.css"> </head> diff --git a/src/docs/System-Configuration.html b/docs/docs/carbslinux/System-Configuration.html index 76cf410..aed313d 100644 --- a/src/docs/System-Configuration.html +++ b/docs/docs/carbslinux/System-Configuration.html @@ -42,6 +42,7 @@ span.sansserif {font-family: sans-serif; font-weight: normal} ul.no-bullet {list-style: none} --> </style> +<link rel="stylesheet" type="text/css" href="https://www.gnu.org/software/gnulib/manual.css"> </head> diff --git a/docs/docs/Updating-packages.html b/docs/docs/carbslinux/Updating-packages.html index 0c65553..47e186c 100644 --- a/docs/docs/Updating-packages.html +++ b/docs/docs/carbslinux/Updating-packages.html @@ -42,6 +42,7 @@ span.sansserif {font-family: sans-serif; font-weight: normal} ul.no-bullet {list-style: none} --> </style> +<link rel="stylesheet" type="text/css" href="https://www.gnu.org/software/gnulib/manual.css"> </head> diff --git a/src/docs/_002fetc_002finit_002frcconf-file.html b/docs/docs/carbslinux/_002fetc_002finit_002frcconf-file.html index 5f33c04..1a34d8f 100644 --- a/src/docs/_002fetc_002finit_002frcconf-file.html +++ b/docs/docs/carbslinux/_002fetc_002finit_002frcconf-file.html @@ -42,6 +42,7 @@ span.sansserif {font-family: sans-serif; font-weight: normal} ul.no-bullet {list-style: none} --> </style> +<link rel="stylesheet" type="text/css" href="https://www.gnu.org/software/gnulib/manual.css"> </head> diff --git a/docs/docs/index.html b/docs/docs/carbslinux/index.html index 68cef39..2a4bbbe 100644 --- a/docs/docs/index.html +++ b/docs/docs/carbslinux/index.html @@ -40,6 +40,7 @@ span.sansserif {font-family: sans-serif; font-weight: normal} ul.no-bullet {list-style: none} --> </style> +<link rel="stylesheet" type="text/css" href="https://www.gnu.org/software/gnulib/manual.css"> </head> diff --git a/docs/docs/install.html b/docs/docs/install.html deleted file mode 100644 index 176aacd..0000000 --- a/docs/docs/install.html +++ /dev/null @@ -1,822 +0,0 @@ -<?xml version="1.0" encoding="utf-8"?> -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" -"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> -<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"> -<head> -<!-- 2020-12-26 Sat 03:17 --> -<meta http-equiv="Content-Type" content="text/html;charset=utf-8" /> -<meta name="viewport" content="width=device-width, initial-scale=1" /> -<title>Carbs Linux Installation Guide</title> -<meta name="generator" content="Org mode" /> -<meta name="author" content="Cem Keylan" /> -<style type="text/css"> - <!--/*--><![CDATA[/*><!--*/ - .title { text-align: center; - margin-bottom: .2em; } - .subtitle { text-align: center; - font-size: medium; - font-weight: bold; - margin-top:0; } - .todo { font-family: monospace; color: red; } - .done { font-family: monospace; color: green; } - .priority { font-family: monospace; color: orange; } - .tag { background-color: #eee; font-family: monospace; - padding: 2px; font-size: 80%; font-weight: normal; } - .timestamp { color: #bebebe; } - .timestamp-kwd { color: #5f9ea0; } - .org-right { margin-left: auto; margin-right: 0px; text-align: right; } - .org-left { margin-left: 0px; margin-right: auto; text-align: left; } - .org-center { margin-left: auto; margin-right: auto; text-align: center; } - .underline { text-decoration: underline; } - #postamble p, #preamble p { font-size: 90%; margin: .2em; } - p.verse { margin-left: 3%; } - pre { - border: 1px solid #ccc; - box-shadow: 3px 3px 3px #eee; - padding: 8pt; - font-family: monospace; - overflow: auto; - margin: 1.2em; - } - pre.src { - position: relative; - overflow: visible; - padding-top: 1.2em; - } - pre.src:before { - display: none; - position: absolute; - background-color: white; - top: -10px; - right: 10px; - padding: 3px; - border: 1px solid black; - } - pre.src:hover:before { display: inline;} - /* Languages per Org manual */ - pre.src-asymptote:before { content: 'Asymptote'; } - pre.src-awk:before { content: 'Awk'; } - pre.src-C:before { content: 'C'; } - /* pre.src-C++ doesn't work in CSS */ - pre.src-clojure:before { content: 'Clojure'; } - pre.src-css:before { content: 'CSS'; } - pre.src-D:before { content: 'D'; } - pre.src-ditaa:before { content: 'ditaa'; } - pre.src-dot:before { content: 'Graphviz'; } - pre.src-calc:before { content: 'Emacs Calc'; } - pre.src-emacs-lisp:before { content: 'Emacs Lisp'; } - pre.src-fortran:before { content: 'Fortran'; } - pre.src-gnuplot:before { content: 'gnuplot'; } - pre.src-haskell:before { content: 'Haskell'; } - pre.src-hledger:before { content: 'hledger'; } - pre.src-java:before { content: 'Java'; } - pre.src-js:before { content: 'Javascript'; } - pre.src-latex:before { content: 'LaTeX'; } - pre.src-ledger:before { content: 'Ledger'; } - pre.src-lisp:before { content: 'Lisp'; } - pre.src-lilypond:before { content: 'Lilypond'; } - pre.src-lua:before { content: 'Lua'; } - pre.src-matlab:before { content: 'MATLAB'; } - pre.src-mscgen:before { content: 'Mscgen'; } - pre.src-ocaml:before { content: 'Objective Caml'; } - pre.src-octave:before { content: 'Octave'; } - pre.src-org:before { content: 'Org mode'; } - pre.src-oz:before { content: 'OZ'; } - pre.src-plantuml:before { content: 'Plantuml'; } - pre.src-processing:before { content: 'Processing.js'; } - pre.src-python:before { content: 'Python'; } - pre.src-R:before { content: 'R'; } - pre.src-ruby:before { content: 'Ruby'; } - pre.src-sass:before { content: 'Sass'; } - pre.src-scheme:before { content: 'Scheme'; } - pre.src-screen:before { content: 'Gnu Screen'; } - pre.src-sed:before { content: 'Sed'; } - pre.src-sh:before { content: 'shell'; } - pre.src-sql:before { content: 'SQL'; } - pre.src-sqlite:before { content: 'SQLite'; } - /* additional languages in org.el's org-babel-load-languages alist */ - pre.src-forth:before { content: 'Forth'; } - pre.src-io:before { content: 'IO'; } - pre.src-J:before { content: 'J'; } - pre.src-makefile:before { content: 'Makefile'; } - pre.src-maxima:before { content: 'Maxima'; } - pre.src-perl:before { content: 'Perl'; } - pre.src-picolisp:before { content: 'Pico Lisp'; } - pre.src-scala:before { content: 'Scala'; } - pre.src-shell:before { content: 'Shell Script'; } - pre.src-ebnf2ps:before { content: 'ebfn2ps'; } - /* additional language identifiers per "defun org-babel-execute" - in ob-*.el */ - pre.src-cpp:before { content: 'C++'; } - pre.src-abc:before { content: 'ABC'; } - pre.src-coq:before { content: 'Coq'; } - pre.src-groovy:before { content: 'Groovy'; } - /* additional language identifiers from org-babel-shell-names in - ob-shell.el: ob-shell is the only babel language using a lambda to put - the execution function name together. */ - pre.src-bash:before { content: 'bash'; } - pre.src-csh:before { content: 'csh'; } - pre.src-ash:before { content: 'ash'; } - pre.src-dash:before { content: 'dash'; } - pre.src-ksh:before { content: 'ksh'; } - pre.src-mksh:before { content: 'mksh'; } - pre.src-posh:before { content: 'posh'; } - /* Additional Emacs modes also supported by the LaTeX listings package */ - pre.src-ada:before { content: 'Ada'; } - pre.src-asm:before { content: 'Assembler'; } - pre.src-caml:before { content: 'Caml'; } - pre.src-delphi:before { content: 'Delphi'; } - pre.src-html:before { content: 'HTML'; } - pre.src-idl:before { content: 'IDL'; } - pre.src-mercury:before { content: 'Mercury'; } - pre.src-metapost:before { content: 'MetaPost'; } - pre.src-modula-2:before { content: 'Modula-2'; } - pre.src-pascal:before { content: 'Pascal'; } - pre.src-ps:before { content: 'PostScript'; } - pre.src-prolog:before { content: 'Prolog'; } - pre.src-simula:before { content: 'Simula'; } - pre.src-tcl:before { content: 'tcl'; } - pre.src-tex:before { content: 'TeX'; } - pre.src-plain-tex:before { content: 'Plain TeX'; } - pre.src-verilog:before { content: 'Verilog'; } - pre.src-vhdl:before { content: 'VHDL'; } - pre.src-xml:before { content: 'XML'; } - pre.src-nxml:before { content: 'XML'; } - /* add a generic configuration mode; LaTeX export needs an additional - (add-to-list 'org-latex-listings-langs '(conf " ")) in .emacs */ - pre.src-conf:before { content: 'Configuration File'; } - - table { border-collapse:collapse; } - caption.t-above { caption-side: top; } - caption.t-bottom { caption-side: bottom; } - td, th { vertical-align:top; } - th.org-right { text-align: center; } - th.org-left { text-align: center; } - th.org-center { text-align: center; } - td.org-right { text-align: right; } - td.org-left { text-align: left; } - td.org-center { text-align: center; } - dt { font-weight: bold; } - .footpara { display: inline; } - .footdef { margin-bottom: 1em; } - .figure { padding: 1em; } - .figure p { text-align: center; } - .equation-container { - display: table; - text-align: center; - width: 100%; - } - .equation { - vertical-align: middle; - } - .equation-label { - display: table-cell; - text-align: right; - vertical-align: middle; - } - .inlinetask { - padding: 10px; - border: 2px solid gray; - margin: 10px; - background: #ffffcc; - } - #org-div-home-and-up - { text-align: right; font-size: 70%; white-space: nowrap; } - textarea { overflow-x: auto; } - .linenr { font-size: smaller } - .code-highlighted { background-color: #ffff00; } - .org-info-js_info-navigation { border-style: none; } - #org-info-js_console-label - { font-size: 10px; font-weight: bold; white-space: nowrap; } - .org-info-js_search-highlight - { background-color: #ffff00; color: #000000; font-weight: bold; } - .org-svg { width: 90%; } - /*]]>*/--> -</style> -</head> -<body> -<div id="content"> -<h1 class="title">Carbs Linux Installation Guide</h1> -<div id="table-of-contents"> -<h2>Table of Contents</h2> -<div id="text-table-of-contents"> -<ul> -<li><a href="#orgf69e554">1. Preparing Environment</a> -<ul> -<li><a href="#org95a0e69">1.1. Download</a></li> -<li><a href="#org8e36ac6">1.2. Signature verification</a></li> -<li><a href="#orgea2754a">1.3. Extracting the tarball</a></li> -<li><a href="#org04cd78e">1.4. Obtain the chroot helper</a></li> -</ul> -</li> -<li><a href="#org75ac2b4">2. Chroot</a> -<ul> -<li><a href="#org8778be8">2.1. Setting up repositories</a> -<ul> -<li><a href="#orga965761">2.1.1. Obtaining from git</a></li> -<li><a href="#orgb7bea54">2.1.2. Obtaining from rsync</a></li> -<li><a href="#orgb72886d">2.1.3. Making the package manager use the repositories</a></li> -</ul> -</li> -<li><a href="#org2a9ee98">2.2. Updating packages</a></li> -<li><a href="#orgf04d2d5">2.3. Installing packages</a></li> -<li><a href="#orgb80a3a8">2.4. Essential Software</a></li> -<li><a href="#org1e0d5e0">2.5. Obtaining the documentation</a></li> -</ul> -</li> -<li><a href="#orgd61a283">3. System Configuration</a> -<ul> -<li><a href="#orgc097724">3.1. Configuring hostname</a></li> -<li><a href="#org88a7ef3">3.2. Hosts file</a></li> -</ul> -</li> -<li><a href="#org92806b4">4. Kernel</a> -<ul> -<li><a href="#orgb246a4d">4.1. Obtaining the kernel sources</a></li> -<li><a href="#orgf9a076f">4.2. Kernel dependencies</a></li> -<li><a href="#orga3c74bc">4.3. Building the kernel</a></li> -</ul> -</li> -<li><a href="#orgb176eb1">5. Making your system bootable</a> -<ul> -<li><a href="#org31a5fde">5.1. Bootloader</a> -<ul> -<li><a href="#org43ed898">5.1.1. GRUB BIOS installation</a></li> -<li><a href="#orgf826efe">5.1.2. GRUB UEFI installation</a></li> -</ul> -</li> -<li><a href="#org2d43b5f">5.2. Init scripts</a></li> -<li><a href="#orgfe8161b">5.3. Fstab</a></li> -</ul> -</li> -<li><a href="#org917e2c8">6. Post-installation</a> -<ul> -<li><a href="#org96641ac">6.1. KISS repositories</a></li> -</ul> -</li> -</ul> -</div> -</div> -<p> -These are the step-by-step instructions for installing Carbs Linux. It can be -acquired as plain-text to be viewed offline with a pager from -<a href="https://carbslinux.org/docs/install.txt">https://carbslinux.org/docs/install.txt</a>. -</p> - -<div id="outline-container-orgf69e554" class="outline-2"> -<h2 id="orgf69e554"><span class="section-number-2">1</span> Preparing Environment</h2> -<div class="outline-text-2" id="text-1"> -<p> -To install Carbs Linux, you will need a Live Linux ISO. For that purpose, you -can obtain a Gentoo or Void Linux live image. You can follow their instructions -to boot and setup your network. -</p> - -<p> -You will need the following programs in order to install Carbs Linux: -</p> - -<ul class="org-ul"> -<li>tar</li> -<li>wget</li> -<li>xz</li> -<li>some form of base utilities (coreutils, sbase, busybox, etc.)</li> -</ul> - -<p> -Rest of these instructions will assume that you have set all of these up, and -will continue on that point. -</p> -</div> - -<div id="outline-container-org95a0e69" class="outline-3"> -<h3 id="org95a0e69"><span class="section-number-3">1.1</span> Download</h3> -<div class="outline-text-3" id="text-1-1"> -<p> -First, we need to download the rootfs tarball. You can do the following in order -to obtain the rootfs. If you are using an i686 machine, replace the <code>x86_64</code> -with <code>i686</code>. We are setting this in a URL variable so that we don't have to -write it every time. -</p> - -<div class="org-src-container"> -<pre class="src src-sh">wget $<span style="color: #8e44ad;">URL</span>/carbs-rootfs.tar.xz.sha256 -sha256sum -c carbs-rootfs.tar.xz.sha256 -</pre> -</div> -</div> -</div> - -<div id="outline-container-org8e36ac6" class="outline-3"> -<h3 id="org8e36ac6"><span class="section-number-3">1.2</span> Signature verification</h3> -<div class="outline-text-3" id="text-1-2"> -<p> -It is highly recommended to verify the signature of the tarball. You will need -GPG for this. -</p> - -<div class="org-src-container"> -<pre class="src src-sh">wget $<span style="color: #8e44ad;">URL</span>/carbs-rootfs.tar.xz.sig -gpg --recv-keys FF484BDFEFCEF8FF -gpg --verify carbs-rootfs.tar.xz.sig -</pre> -</div> -</div> -</div> - -<div id="outline-container-orgea2754a" class="outline-3"> -<h3 id="orgea2754a"><span class="section-number-3">1.3</span> Extracting the tarball</h3> -<div class="outline-text-3" id="text-1-3"> -<p> -You will need to extract the tarball to your desired location. For partitioning, -you can follow <a href="https://wiki.archlinux.org/index.php/Partitioning">this guide</a>. This will assume that you will be mounting your root -partition to <code>/mnt</code>. -</p> - -<div class="org-src-container"> -<pre class="src src-sh">mount /dev/sdx1 /mnt -tar xf carbs-rootfs.tar.xz -C /mnt -</pre> -</div> -</div> -</div> - -<div id="outline-container-org04cd78e" class="outline-3"> -<h3 id="org04cd78e"><span class="section-number-3">1.4</span> Obtain the chroot helper</h3> -<div class="outline-text-3" id="text-1-4"> -<p> -You can obtain the <code>cpt-chroot</code> script in order to do a simple chroot into your -new root filesystem. -</p> - -<div class="org-src-container"> -<pre class="src src-sh">wget https://dl.carbslinux.org/distfiles/cpt-chroot -chmod a+x cpt-chroot -</pre> -</div> -</div> -</div> -</div> - -<div id="outline-container-org75ac2b4" class="outline-2"> -<h2 id="org75ac2b4"><span class="section-number-2">2</span> Chroot</h2> -<div class="outline-text-2" id="text-2"> -<p> -Chroot into Carbs Linux! -</p> - -<div class="org-src-container"> -<pre class="src src-sh">./cpt-chroot /mnt -</pre> -</div> -</div> - -<div id="outline-container-org8778be8" class="outline-3"> -<h3 id="org8778be8"><span class="section-number-3">2.1</span> Setting up repositories</h3> -<div class="outline-text-3" id="text-2-1"> -<p> -Newest tarballs do not come with repositories, so you will need to manually -obtain them, and set your <code>CPT_PATH</code> environment variable. Carbs Linux -repositories can either be obtained by <code>git</code> or <code>rsync</code>. While rsync -repositories are overall faster and smaller, git offers the whole history of the -repository and a means to manipulate your repository as you like it. If you want -to obtain the git repository, you will need to install <code>git</code> itself. -</p> - -<p> -The following guide will assume that you put the repositories into <code>~/repos/</code> -directory, but you can put the repositories into any directory you want. So go -ahead and create that directory: -</p> - -<div class="org-src-container"> -<pre class="src src-sh">mkdir -p $<span style="color: #8e44ad;">HOME</span>/repos -</pre> -</div> -</div> - -<div id="outline-container-orga965761" class="outline-4"> -<h4 id="orga965761"><span class="section-number-4">2.1.1</span> Obtaining from git</h4> -<div class="outline-text-4" id="text-2-1-1"> -<p> -Carbs Linux git repositories can be found both from the main server and GitHub -(mirror). Here are both their repository links. You can clone any of them. -</p> - -<ul class="org-ul"> -<li>git://git.carbslinux.org/repository</li> -<li><a href="https://github.com/carbslinux/repository">https://github.com/carbslinux/repository</a></li> -</ul> - -<div class="org-src-container"> -<pre class="src src-sh">git clone git://git.carbslinux.org/repository $<span style="color: #8e44ad;">HOME</span>/repos/carbs -</pre> -</div> -</div> -</div> - -<div id="outline-container-orgb7bea54" class="outline-4"> -<h4 id="orgb7bea54"><span class="section-number-4">2.1.2</span> Obtaining from rsync</h4> -<div class="outline-text-4" id="text-2-1-2"> -<p> -Carbs Linux rsync repositories live in rsync://carbslinux.org/repo. In -order to obtain it, run the following: -</p> - -<div class="org-src-container"> -<pre class="src src-sh">rsync -avc rsync://carbslinux.org/repo $<span style="color: #8e44ad;">HOME</span>/repos/carbs -</pre> -</div> -</div> -</div> - -<div id="outline-container-orgb72886d" class="outline-4"> -<h4 id="orgb72886d"><span class="section-number-4">2.1.3</span> Making the package manager use the repositories</h4> -<div class="outline-text-4" id="text-2-1-3"> -<p> -In your shell's configuration file, or in your <code>~/.profile</code> file, add the -following lines: -</p> - -<div class="org-src-container"> -<pre class="src src-sh"><span style="color: #8e44ad;">CPT_PATH</span>=$<span style="color: #8e44ad;">HOME</span>/repos/carbs/core -<span style="color: #8e44ad;">CPT_PATH</span>=$<span style="color: #8e44ad;">CPT_PATH</span>:$<span style="color: #8e44ad;">HOME</span>/repos/carbs/extra -<span style="color: #8e44ad;">CPT_PATH</span>=$<span style="color: #8e44ad;">CPT_PATH</span>:$<span style="color: #8e44ad;">HOME</span>/repos/carbs/xorg -<span style="color: #8e44ad;">CPT_PATH</span>=$<span style="color: #8e44ad;">CPT_PATH</span>:$<span style="color: #8e44ad;">HOME</span>/repos/carbs/community -<span style="color: #16a085;">export</span> CPT_PATH -</pre> -</div> -</div> -</div> -</div> - -<div id="outline-container-org2a9ee98" class="outline-3"> -<h3 id="org2a9ee98"><span class="section-number-3">2.2</span> Updating packages</h3> -<div class="outline-text-3" id="text-2-2"> -<p> -It is good practice to make sure your system is up to date, especially before -building new packages. If there is an update for the package manager you will -need to update twice. -</p> - -<div class="org-src-container"> -<pre class="src src-sh">cpt-update && cpt-update -</pre> -</div> -</div> -</div> - -<div id="outline-container-orgf04d2d5" class="outline-3"> -<h3 id="orgf04d2d5"><span class="section-number-3">2.3</span> Installing packages</h3> -<div class="outline-text-3" id="text-2-3"> -<p> -Since you are operating on a really small base, you might need to build and -install new programs to extend the functionality of your system. In order to -build and install packages new packages in Carbs, you need to execute the -following. "Package" is not actually a package and is given as an example. -</p> - -<div class="org-src-container"> -<pre class="src src-sh">cpt-build package -cpt-install package -</pre> -</div> -</div> -</div> - -<div id="outline-container-orgb80a3a8" class="outline-3"> -<h3 id="orgb80a3a8"><span class="section-number-3">2.4</span> Essential Software</h3> -<div class="outline-text-3" id="text-2-4"> -<p> -Here is a list of software that you might want to have on your system. -</p> - -<p> -<b>BOOTLOADERS</b> -</p> - -<ul class="org-ul"> -<li>efibootmgr</li> -<li>grub</li> -</ul> - -<p> -<b>FILESYSTEMS</b> -</p> - -<ul class="org-ul"> -<li>e2fsprogs</li> -<li>dosfstools</li> -<li>ntfs-3g</li> -</ul> - -<p> -<b>NETWORKING</b> -</p> - -<ul class="org-ul"> -<li>dhcpcd</li> -<li>wpa<sub>supplicant</sub></li> -</ul> - -<p> -<b>TEXT EDITORS</b> -</p> - -<ul class="org-ul"> -<li>nano</li> -<li>vim</li> -<li>neatvi</li> -<li>emacs</li> -<li>emacs-nox (terminal-only version of emacs)</li> -</ul> - -<p> -<b>USER SHELLS</b> -</p> - -<ul class="org-ul"> -<li>bash</li> -<li>zsh</li> -<li>oksh</li> -<li>rc</li> -</ul> - -<p> -<b>POSIX BASE UTILITIES</b> -</p> - -<ul class="org-ul"> -<li>busybox</li> -<li>sbase</li> -<li>coreutils</li> -</ul> - -<p> -<b>DOCUMENTATION</b> -</p> - -<ul class="org-ul"> -<li>carbs-docs</li> -<li>man-pages</li> -<li>man-pages-posix</li> -</ul> -</div> -</div> - -<div id="outline-container-org1e0d5e0" class="outline-3"> -<h3 id="org1e0d5e0"><span class="section-number-3">2.5</span> Obtaining the documentation</h3> -<div class="outline-text-3" id="text-2-5"> -<p> -All the documentation for Carbs Linux can be found on a single info manual to be -viewed offline. You can obtain texinfo or the info (standalone) package in order -to view the documentation. -</p> - -<div class="org-src-container"> -<pre class="src src-sh"><span style="color: #95a5a6;"># </span><span style="color: #7f8c8d;">Install the documentation.</span> -cpt b carbs-docs && cpt i carbs-docs - -<span style="color: #95a5a6;"># </span><span style="color: #7f8c8d;">Install either texinfo or the info package. We will be installing standalone info</span> -<span style="color: #95a5a6;"># </span><span style="color: #7f8c8d;">as it doesn't need perl.</span> -cpt b info && cpt i info - -<span style="color: #95a5a6;"># </span><span style="color: #7f8c8d;">You can then run info and navigate through the documentation.</span> -info carbslinux -</pre> -</div> -</div> -</div> -</div> - -<div id="outline-container-orgd61a283" class="outline-2"> -<h2 id="orgd61a283"><span class="section-number-2">3</span> System Configuration</h2> -<div class="outline-text-2" id="text-3"> -<p> -After you have finished installing some extra packages, you can configure your -system to your liking. -</p> -</div> - -<div id="outline-container-orgc097724" class="outline-3"> -<h3 id="orgc097724"><span class="section-number-3">3.1</span> Configuring hostname</h3> -<div class="outline-text-3" id="text-3-1"> -<p> -You might want to add a hostname, especially in a networked environment. Your -hostname will default to 'carbslinux' unless you set this. -</p> - -<div class="org-src-container"> -<pre class="src src-sh"><span style="color: #16a085;">echo</span> your-hostname > /etc/hostname -</pre> -</div> -</div> -</div> - -<div id="outline-container-org88a7ef3" class="outline-3"> -<h3 id="org88a7ef3"><span class="section-number-3">3.2</span> Hosts file</h3> -<div class="outline-text-3" id="text-3-2"> -<p> -You can edit your /etc/hosts file, which is the static lookup table for host -names. By default, there are two entries for localhost which are OKAY. You can -replace the 'localhost' part of these entries to your hostname. -</p> - -<pre class="example"> -127.0.0.1 localhost.localdomain localhost -::1 localhost.localdomain localhost ip6-localhost -</pre> -</div> -</div> -</div> - -<div id="outline-container-org92806b4" class="outline-2"> -<h2 id="org92806b4"><span class="section-number-2">4</span> Kernel</h2> -<div class="outline-text-2" id="text-4"> -<p> -Kernel isn't managed under the main repositories, even though you could package -one for your personal use. Here is an <a href="https://github.com/cemkeylan/kiss-repository/tree/master/personal/linux">example kernel package</a>, which you will -need to reconfigure for your specific setup if you want to make use of it. -</p> -</div> - -<div id="outline-container-orgb246a4d" class="outline-3"> -<h3 id="orgb246a4d"><span class="section-number-3">4.1</span> Obtaining the kernel sources</h3> -<div class="outline-text-3" id="text-4-1"> -<p> -You can visit the <a href="https://kernel.org">https://kernel.org</a> website to choose a kernel that you want -to install. Though only the latest stable and longterm (LTS) versions are -supported. -</p> - -<div class="org-src-container"> -<pre class="src src-sh"><span style="color: #95a5a6;"># </span><span style="color: #7f8c8d;">Download the kernel and extract it</span> -wget https://cdn.kernel.org/pub/linux/kernel/v5.x/linux-5.9.1.tar.xz -tar xf linux-5.9.1.tar.xz - -<span style="color: #95a5a6;"># </span><span style="color: #7f8c8d;">Change directory into the kernel sources</span> -<span style="color: #16a085;">cd</span> linux-5.9.1 -</pre> -</div> -</div> -</div> - -<div id="outline-container-orgf9a076f" class="outline-3"> -<h3 id="orgf9a076f"><span class="section-number-3">4.2</span> Kernel dependencies</h3> -<div class="outline-text-3" id="text-4-2"> -<p> -In order to compile the kernel you will need to install some dependencies. You -will need <code>libelf</code> to compile the kernel. If you want to configure using the -menu interface you will also need <code>ncurses</code>. -</p> - -<div class="org-src-container"> -<pre class="src src-sh"><span style="color: #95a5a6;"># </span><span style="color: #7f8c8d;">The package manager asks to install if you are building more than one package,</span> -<span style="color: #95a5a6;"># </span><span style="color: #7f8c8d;">so no need to run 'cpt i ...'</span> -cpt b libelf ncurses -</pre> -</div> - -<p> -In the vanilla kernel sources, you need perl to compile the kernel, but it can -be easily patched out. You will need to apply the following patch. Patch was -written by <a href="https://github.com/E5ten">E5ten</a>. You will need to obtain and apply the patch in the kernel -source directory. -</p> - -<div class="org-src-container"> -<pre class="src src-sh">wget https://dl.carbslinux.org/distfiles/kernel-no-perl.patch -patch -p1 < kernel-no-perl.patch -</pre> -</div> -</div> -</div> - -<div id="outline-container-orga3c74bc" class="outline-3"> -<h3 id="orga3c74bc"><span class="section-number-3">4.3</span> Building the kernel</h3> -<div class="outline-text-3" id="text-4-3"> -<p> -Next step is configuring and building the kernel. You can check Gentoo's -<a href="https://wiki.gentoo.org/wiki/Kernel/Configuration">kernel configuration guide</a> to learn more about the matter. Overall, Gentoo Wiki -is a good place to learn about configuration according to your hardware. The -following will assume a monolithic kernel. -</p> - -<div class="org-src-container"> -<pre class="src src-sh">make menuconfig -make -install -Dm755 $(make -s image_name) /boot/vmlinuz-linux -</pre> -</div> -</div> -</div> -</div> - -<div id="outline-container-orgb176eb1" class="outline-2"> -<h2 id="orgb176eb1"><span class="section-number-2">5</span> Making your system bootable</h2> -<div class="outline-text-2" id="text-5"> -<p> -In order to be able to boot your fresh system, wou will need an init-daemon, -init-scripts and a bootloader. The init daemon is already provided by busybox, -but you can optionally change it. -</p> -</div> - -<div id="outline-container-org31a5fde" class="outline-3"> -<h3 id="org31a5fde"><span class="section-number-3">5.1</span> Bootloader</h3> -<div class="outline-text-3" id="text-5-1"> -<p> -In the main repository, there is efibootmgr and grub to serve as bootloaders. -efibootmgr can be used as a standalone bootloader, or can be used to install -grub in a UEFI environment. efibootmgr is needed unless you are using a device -without UEFI support (or you really want to use BIOS for a reason). -</p> -</div> - -<div id="outline-container-org43ed898" class="outline-4"> -<h4 id="org43ed898"><span class="section-number-4">5.1.1</span> GRUB BIOS installation</h4> -<div class="outline-text-4" id="text-5-1-1"> -<div class="org-src-container"> -<pre class="src src-sh">cpt b grub && cpt i grub -grub-install --target=i386-pc /dev/sdX -grub-mkconfig -o /boot/grub/grub.cfg -</pre> -</div> -</div> -</div> - -<div id="outline-container-orgf826efe" class="outline-4"> -<h4 id="orgf826efe"><span class="section-number-4">5.1.2</span> GRUB UEFI installation</h4> -<div class="outline-text-4" id="text-5-1-2"> -<div class="org-src-container"> -<pre class="src src-sh">cpt b efibootmgr && cpt i efibootmgr -cpt b grub && cpt i grub - -grub-install --target=x86_64-efi <span style="color: #0a74b9;">\</span> - --efi-directory=esp <span style="color: #0a74b9;">\</span> - --bootloader-id=CarbsLinux - -grub-mkconfig -o /boot/grub/grub.cfg -</pre> -</div> -</div> -</div> -</div> - -<div id="outline-container-org2d43b5f" class="outline-3"> -<h3 id="org2d43b5f"><span class="section-number-3">5.2</span> Init scripts</h3> -<div class="outline-text-3" id="text-5-2"> -<p> -Only thing left to do is installing the init-scripts, and now you are almost -ready to boot your system! -</p> - -<div class="org-src-container"> -<pre class="src src-sh">cpt b carbs-init && cpt i carbs-init -</pre> -</div> -</div> -</div> - -<div id="outline-container-orgfe8161b" class="outline-3"> -<h3 id="orgfe8161b"><span class="section-number-3">5.3</span> Fstab</h3> -<div class="outline-text-3" id="text-5-3"> -<p> -You can now manually edit your fstab entry, or you can use the genfstab tool. -If you want to use the tool, exit the chroot and run the following: -</p> - -<div class="org-src-container"> -<pre class="src src-sh">wget https://github.com/cemkeylan/genfstab/raw/master/genfstab -chmod +x genfstab -./genfstab -U /mnt >> /mnt/etc/fstab -</pre> -</div> -</div> -</div> -</div> - -<div id="outline-container-org917e2c8" class="outline-2"> -<h2 id="org917e2c8"><span class="section-number-2">6</span> Post-installation</h2> -<div class="outline-text-2" id="text-6"> -<p> -The base installation is now complete, you can now fine tune your system -according to your needs. Rest of these instructions are completely optional. -You can check the rest of the documentation to learn more about the system. -</p> -</div> - -<div id="outline-container-org96641ac" class="outline-3"> -<h3 id="org96641ac"><span class="section-number-3">6.1</span> KISS repositories</h3> -<div class="outline-text-3" id="text-6-1"> -<p> -While not 100% compatible with cpt, you can use kiss repositories in your -system the same way you are using the distribution repositories. Here is an -example for the KISS Linux Community repository. -</p> -</div> -</div> -</div> -</div> -</body> -</html> diff --git a/docs/docs/install.txt b/docs/docs/install.txt deleted file mode 100644 index 6f51fa8..0000000 --- a/docs/docs/install.txt +++ /dev/null @@ -1,485 +0,0 @@ - ________________________________ - - CARBS LINUX INSTALLATION GUIDE - - Cem Keylan - ________________________________ - - -Table of Contents -_________________ - -1. Preparing Environment -.. 1. Download -.. 2. Signature verification -.. 3. Extracting the tarball -.. 4. Obtain the chroot helper -2. Chroot -.. 1. Setting up repositories -..... 1. Obtaining from git -..... 2. Obtaining from rsync -..... 3. Making the package manager use the repositories -.. 2. Updating packages -.. 3. Installing packages -.. 4. Essential Software -.. 5. Obtaining the documentation -3. System Configuration -.. 1. Configuring hostname -.. 2. Hosts file -4. Kernel -.. 1. Obtaining the kernel sources -.. 2. Kernel dependencies -.. 3. Building the kernel -5. Making your system bootable -.. 1. Bootloader -..... 1. GRUB BIOS installation -..... 2. GRUB UEFI installation -.. 2. Init scripts -.. 3. Fstab -6. Post-installation -.. 1. KISS repositories - - -These are the step-by-step instructions for installing Carbs Linux. It -can be acquired as plain-text to be viewed offline with a pager from -<https://carbslinux.org/docs/install.txt>. - -,---- -| curl -sL https://carbslinux.org/docs/install.txt | less -`---- - - -1 Preparing Environment -======================= - - To install Carbs Linux, you will need a Live Linux ISO. For that - purpose, you can obtain a Gentoo or Void Linux live image. You can - follow their instructions to boot and setup your network. - - You will need the following programs in order to install Carbs Linux: - - - tar - - wget - - xz - - some form of base utilities (coreutils, sbase, busybox, etc.) - - Rest of these instructions will assume that you have set all of these - up, and will continue on that point. - - -1.1 Download -~~~~~~~~~~~~ - - First, we need to download the rootfs tarball. You can do the - following in order to obtain the rootfs. If you are using an i686 - machine, replace the `x86_64' with `i686'. We are setting this in a - URL variable so that we don't have to write it every time. - - ,---- - | wget $URL/carbs-rootfs.tar.xz.sha256 - | sha256sum -c carbs-rootfs.tar.xz.sha256 - `---- - - -1.2 Signature verification -~~~~~~~~~~~~~~~~~~~~~~~~~~ - - It is highly recommended to verify the signature of the tarball. You - will need GPG for this. - - ,---- - | wget $URL/carbs-rootfs.tar.xz.sig - | gpg --recv-keys FF484BDFEFCEF8FF - | gpg --verify carbs-rootfs.tar.xz.sig - `---- - - -1.3 Extracting the tarball -~~~~~~~~~~~~~~~~~~~~~~~~~~ - - You will need to extract the tarball to your desired location. For - partitioning, you can follow [this guide]. This will assume that you - will be mounting your root partition to `/mnt'. - - ,---- - | mount /dev/sdx1 /mnt - | tar xf carbs-rootfs.tar.xz -C /mnt - `---- - - -[this guide] <https://wiki.archlinux.org/index.php/Partitioning> - - -1.4 Obtain the chroot helper -~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - - You can obtain the `cpt-chroot' script in order to do a simple chroot - into your new root filesystem. - - ,---- - | wget https://dl.carbslinux.org/distfiles/cpt-chroot - | chmod a+x cpt-chroot - `---- - - -2 Chroot -======== - - Chroot into Carbs Linux! - - ,---- - | ./cpt-chroot /mnt - `---- - - -2.1 Setting up repositories -~~~~~~~~~~~~~~~~~~~~~~~~~~~ - - Newest tarballs do not come with repositories, so you will need to - manually obtain them, and set your `CPT_PATH' environment - variable. Carbs Linux repositories can either be obtained by `git' or - `rsync'. While rsync repositories are overall faster and smaller, git - offers the whole history of the repository and a means to manipulate - your repository as you like it. If you want to obtain the git - repository, you will need to install `git' itself. - - The following guide will assume that you put the repositories into - `~/repos/' directory, but you can put the repositories into any - directory you want. So go ahead and create that directory: - - ,---- - | mkdir -p $HOME/repos - `---- - - -2.1.1 Obtaining from git ------------------------- - - Carbs Linux git repositories can be found both from the main server - and GitHub (mirror). Here are both their repository links. You can - clone any of them. - - - git://git.carbslinux.org/repository - - <https://github.com/carbslinux/repository> - - ,---- - | git clone git://git.carbslinux.org/repository $HOME/repos/carbs - `---- - - -2.1.2 Obtaining from rsync --------------------------- - - Carbs Linux rsync repositories live in rsync://carbslinux.org/repo. In - order to obtain it, run the following: - - ,---- - | rsync -avc rsync://carbslinux.org/repo $HOME/repos/carbs - `---- - - -2.1.3 Making the package manager use the repositories ------------------------------------------------------ - - In your shell's configuration file, or in your `~/.profile' file, add - the following lines: - - ,---- - | CPT_PATH=$HOME/repos/carbs/core - | CPT_PATH=$CPT_PATH:$HOME/repos/carbs/extra - | CPT_PATH=$CPT_PATH:$HOME/repos/carbs/xorg - | CPT_PATH=$CPT_PATH:$HOME/repos/carbs/community - | export CPT_PATH - `---- - - -2.2 Updating packages -~~~~~~~~~~~~~~~~~~~~~ - - It is good practice to make sure your system is up to date, especially - before building new packages. If there is an update for the package - manager you will need to update twice. - - ,---- - | cpt-update && cpt-update - `---- - - -2.3 Installing packages -~~~~~~~~~~~~~~~~~~~~~~~ - - Since you are operating on a really small base, you might need to - build and install new programs to extend the functionality of your - system. In order to build and install packages new packages in Carbs, - you need to execute the following. "Package" is not actually a package - and is given as an example. - - ,---- - | cpt-build package - | cpt-install package - `---- - - -2.4 Essential Software -~~~~~~~~~~~~~~~~~~~~~~ - - Here is a list of software that you might want to have on your system. - - *BOOTLOADERS* - - - efibootmgr - - grub - - *FILESYSTEMS* - - - e2fsprogs - - dosfstools - - ntfs-3g - - *NETWORKING* - - - dhcpcd - - wpa_supplicant - - *TEXT EDITORS* - - - nano - - vim - - neatvi - - emacs - - emacs-nox (terminal-only version of emacs) - - *USER SHELLS* - - - bash - - zsh - - oksh - - rc - - *POSIX BASE UTILITIES* - - - busybox - - sbase - - coreutils - - *DOCUMENTATION* - - - carbs-docs - - man-pages - - man-pages-posix - - -2.5 Obtaining the documentation -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - - All the documentation for Carbs Linux can be found on a single info - manual to be viewed offline. You can obtain texinfo or the info - (standalone) package in order to view the documentation. - - ,---- - | # Install the documentation. - | cpt b carbs-docs && cpt i carbs-docs - | - | # Install either texinfo or the info package. We will be installing standalone info - | # as it doesn't need perl. - | cpt b info && cpt i info - | - | # You can then run info and navigate through the documentation. - | info carbslinux - `---- - - -3 System Configuration -====================== - - After you have finished installing some extra packages, you can - configure your system to your liking. - - -3.1 Configuring hostname -~~~~~~~~~~~~~~~~~~~~~~~~ - - You might want to add a hostname, especially in a networked - environment. Your hostname will default to 'carbslinux' unless you set - this. - - ,---- - | echo your-hostname > /etc/hostname - `---- - - -3.2 Hosts file -~~~~~~~~~~~~~~ - - You can edit your /etc/hosts file, which is the static lookup table - for host names. By default, there are two entries for localhost which - are OKAY. You can replace the 'localhost' part of these entries to - your hostname. - - ,---- - | 127.0.0.1 localhost.localdomain localhost - | ::1 localhost.localdomain localhost ip6-localhost - `---- - - -4 Kernel -======== - - Kernel isn't managed under the main repositories, even though you - could package one for your personal use. Here is an [example kernel - package], which you will need to reconfigure for your specific setup - if you want to make use of it. - - -[example kernel package] -<https://github.com/cemkeylan/kiss-repository/tree/master/personal/linux> - -4.1 Obtaining the kernel sources -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - - You can visit the <https://kernel.org> website to choose a kernel that - you want to install. Though only the latest stable and longterm (LTS) - versions are supported. - - ,---- - | # Download the kernel and extract it - | wget https://cdn.kernel.org/pub/linux/kernel/v5.x/linux-5.9.1.tar.xz - | tar xf linux-5.9.1.tar.xz - | - | # Change directory into the kernel sources - | cd linux-5.9.1 - `---- - - -4.2 Kernel dependencies -~~~~~~~~~~~~~~~~~~~~~~~ - - In order to compile the kernel you will need to install some - dependencies. You will need `libelf' to compile the kernel. If you - want to configure using the menu interface you will also need - `ncurses'. - - ,---- - | # The package manager asks to install if you are building more than one package, - | # so no need to run 'cpt i ...' - | cpt b libelf ncurses - `---- - - In the vanilla kernel sources, you need perl to compile the kernel, - but it can be easily patched out. You will need to apply the following - patch. Patch was written by [E5ten]. You will need to obtain and apply - the patch in the kernel source directory. - - ,---- - | wget https://dl.carbslinux.org/distfiles/kernel-no-perl.patch - | patch -p1 < kernel-no-perl.patch - `---- - - -[E5ten] <https://github.com/E5ten> - - -4.3 Building the kernel -~~~~~~~~~~~~~~~~~~~~~~~ - - Next step is configuring and building the kernel. You can check - Gentoo's [kernel configuration guide] to learn more about the - matter. Overall, Gentoo Wiki is a good place to learn about - configuration according to your hardware. The following will assume a - monolithic kernel. - - ,---- - | make menuconfig - | make - | install -Dm755 $(make -s image_name) /boot/vmlinuz-linux - `---- - - -[kernel configuration guide] -<https://wiki.gentoo.org/wiki/Kernel/Configuration> - - -5 Making your system bootable -============================= - - In order to be able to boot your fresh system, wou will need an - init-daemon, init-scripts and a bootloader. The init daemon is already - provided by busybox, but you can optionally change it. - - -5.1 Bootloader -~~~~~~~~~~~~~~ - - In the main repository, there is efibootmgr and grub to serve as - bootloaders. efibootmgr can be used as a standalone bootloader, or - can be used to install grub in a UEFI environment. efibootmgr is - needed unless you are using a device without UEFI support (or you - really want to use BIOS for a reason). - - -5.1.1 GRUB BIOS installation ----------------------------- - - ,---- - | cpt b grub && cpt i grub - | grub-install --target=i386-pc /dev/sdX - | grub-mkconfig -o /boot/grub/grub.cfg - `---- - - -5.1.2 GRUB UEFI installation ----------------------------- - - ,---- - | cpt b efibootmgr && cpt i efibootmgr - | cpt b grub && cpt i grub - | - | grub-install --target=x86_64-efi \ - | --efi-directory=esp \ - | --bootloader-id=CarbsLinux - | - | grub-mkconfig -o /boot/grub/grub.cfg - `---- - - -5.2 Init scripts -~~~~~~~~~~~~~~~~ - - Only thing left to do is installing the init-scripts, and now you are - almost ready to boot your system! - - ,---- - | cpt b carbs-init && cpt i carbs-init - `---- - - -5.3 Fstab -~~~~~~~~~ - - You can now manually edit your fstab entry, or you can use the - genfstab tool. If you want to use the tool, exit the chroot and run - the following: - - ,---- - | wget https://github.com/cemkeylan/genfstab/raw/master/genfstab - | chmod +x genfstab - | ./genfstab -U /mnt >> /mnt/etc/fstab - `---- - - -6 Post-installation -=================== - - The base installation is now complete, you can now fine tune your - system according to your needs. Rest of these instructions are - completely optional. You can check the rest of the documentation to - learn more about the system. - - -6.1 KISS repositories -~~~~~~~~~~~~~~~~~~~~~ - - While not 100% compatible with cpt, you can use kiss repositories in - your system the same way you are using the distribution - repositories. Here is an example for the KISS Linux Community - repository. diff --git a/docs/download.html b/docs/download.html new file mode 100644 index 0000000..5f26b60 --- /dev/null +++ b/docs/download.html @@ -0,0 +1,64 @@ +<!DOCTYPE html> +<html lang="en"> +<head> +<!-- 2021-02-02 --> +<meta charset="utf-8"> +<meta name="viewport" content="width=device-width, initial-scale=1"> +<title>Download Carbs Linux</title> +<meta name="generator" content="Org mode"> +<meta name="author" content="Cem Keylan"> +<link rel="stylesheet" type="text/css" href="/style.css"> +</head> +<body> +<div id="preamble" class="status"> +<nav id="navbar"> + <a href="/" class=navbartitle>Carbs Linux</a> + + <label for="hamburger">☰</label> + <input type="checkbox" id="hamburger" /> + <ul id=navbarlist> + <li><a href="/" title="Home Page">Home</a></li> + <li><a href="//git.carbslinux.org" title="Git Repository">Git</a></li> + <li><a href="/download.html" title="Download Carbs Linux">Download</a></li> + <li><a href="/blog" title="Blog Posts">Blog</a></li> + <li><a href="/install.html" title="Installation Instructions">Installation</a></li> + <li><a href="/docs.html" title="Documentation">Docs</a></li> + </ul> +</nav> +</div> +<div id="content"> +<header> +<h1 class="title">Download Carbs Linux</h1> +</header><p> +Below are the latest tarballs for the <code>x86_64</code> and <code>i686</code> architectures. You can +visit <a href="https://dl.carbslinux.org/releases">https://dl.carbslinux.org/releases</a> for all downloads. Follow the +<a href="install.html">Installation guide</a> to learn more about verifying the releases, and the required +steps for installing the system. +</p> + +<div id="outline-container-orgc43a100" class="outline-2"> +<h2 id="orgc43a100">x86-64</h2> +<div class="outline-text-2" id="text-orgc43a100"> +<p> +<a href="https://dl.carbslinux.org/releases/x86_64/carbs-rootfs.tar.xz">carbs-rootfs.tar.xz</a> | <a href="https://dl.carbslinux.org/releases/x86_64/carbs-rootfs.tar.xz.sha256">SHA256SUM</a> | <a href="https://dl.carbslinux.org/releases/x86_64/carbs-rootfs.tar.xz.sig">Signature</a> +</p> +</div> +</div> + +<div id="outline-container-orgb23d005" class="outline-2"> +<h2 id="orgb23d005">i686</h2> +<div class="outline-text-2" id="text-orgb23d005"> +<p> +<a href="https://dl.carbslinux.org/releases/i686/carbs-rootfs.tar.xz">carbs-rootfs.tar.xz</a> | <a href="https://dl.carbslinux.org/releases/i686/carbs-rootfs.tar.xz.sha256">SHA256SUM</a> | <a href="https://dl.carbslinux.org/releases/i686/carbs-rootfs.tar.xz.sig">Signature</a> +</p> +</div> +</div> +</div> +<div id="postamble" class="status"> +<footer> + <p>Linux® is a registered trademark of Linus Torvalds</p> + <p>Copyright © 2019-2021 Cem Keylan</p> +</footer> +</div> +</body> +</html> diff --git a/docs/download.txt b/docs/download.txt new file mode 100644 index 0000000..8364fdd --- /dev/null +++ b/docs/download.txt @@ -0,0 +1,46 @@ + ______________________ + + DOWNLOAD CARBS LINUX + ______________________ + + +Below are the latest tarballs for the `x86_64' and `i686' +architectures. You can visit <https://dl.carbslinux.org/releases> for +all downloads. Follow the [Installation guide] to learn more about +verifying the releases, and the required steps for installing the +system. + + +[Installation guide] <file:install.org> + + +x86-64 +====== + + [carbs-rootfs.tar.xz] | [SHA256SUM] | [Signature] + + +[carbs-rootfs.tar.xz] +<https://dl.carbslinux.org/releases/x86_64/carbs-rootfs.tar.xz> + +[SHA256SUM] +<https://dl.carbslinux.org/releases/x86_64/carbs-rootfs.tar.xz.sha256> + +[Signature] +<https://dl.carbslinux.org/releases/x86_64/carbs-rootfs.tar.xz.sig> + + +i686 +==== + + [carbs-rootfs.tar.xz] | [SHA256SUM] | [Signature] + + +[carbs-rootfs.tar.xz] +<https://dl.carbslinux.org/releases/i686/carbs-rootfs.tar.xz> + +[SHA256SUM] +<https://dl.carbslinux.org/releases/i686/carbs-rootfs.tar.xz.sha256> + +[Signature] +<https://dl.carbslinux.org/releases/i686/carbs-rootfs.tar.xz.sig> diff --git a/docs/index.html b/docs/index.html index 6397956..904339a 100644 --- a/docs/index.html +++ b/docs/index.html @@ -1,112 +1,177 @@ -<!DOCTYPE HTML> -<html lan=en> - <head> - <title>index | Carbs Linux</title> - <link rel="stylesheet" href="/style.css"> - <meta charset="utf-8"> - <meta name="Description" content="Carbs Linux - a simple linux distribution"> - <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no"> - </head> - <body> - <p class=header><strong>Carbs Linux - a simple linux distribution</strong></p> - <div class="header"> - <nav> - <a href='/'>index</a> - <a href="//git.carbslinux.org">git</a> - <a href='//dl.carbslinux.org'>downloads</a> - <a href='/blog'>blog</a> - <a href='/docs/install.html'>installation</a> - <a href='/docs'>user manual</a> - </nav> - </div><div class="border"></div> -<p>Carbs Linux is an in-development Linux® distribution with a suckless mindset. -The base system consists of only the necessary programs to create a Linux -distribution.</p> - -<h2>Package Manager</h2> - -<p>Carbs Linux uses its own package manager <a href="https://github.com/CarbsLinux/cpt">Carbs Packaging Tools</a>, a POSIX shell -package manager forked from KISS with the tool-based approach of xbps.</p> - -<h2>Small base</h2> - -<p>By default, Carbs Linux comes with busybox for coreutils, bearssl for its +<!DOCTYPE html> +<html lang="en"> +<head> +<!-- 2021-02-02 --> +<meta charset="utf-8"> +<meta name="viewport" content="width=device-width, initial-scale=1"> +<title>Carbs Linux</title> +<meta name="generator" content="Org mode"> +<meta name="author" content="Cem Keylan"> +<meta name="description" content="a simple Linux distribution" +> +<link rel="stylesheet" type="text/css" href="/style.css"> +</head> +<body> +<div id="preamble" class="status"> +<nav id="navbar"> + <a href="/" class=navbartitle>Carbs Linux</a> + + <label for="hamburger">☰</label> + <input type="checkbox" id="hamburger" /> + <ul id=navbarlist> + <li><a href="/" title="Home Page">Home</a></li> + <li><a href="//git.carbslinux.org" title="Git Repository">Git</a></li> + <li><a href="/download.html" title="Download Carbs Linux">Download</a></li> + <li><a href="/blog" title="Blog Posts">Blog</a></li> + <li><a href="/install.html" title="Installation Instructions">Installation</a></li> + <li><a href="/docs.html" title="Documentation">Docs</a></li> + </ul> +</nav> +</div> +<div id="content"> +<p> +Carbs Linux is a source-based Linux® distribution that aims to be simple, +flexible and extensible while staying as pragmatic and practical as possible. +The system can consist of as much or as little as its user can intend to. +</p> + +<div id="outline-container-orgd3ebc46" class="outline-2"> +<h2 id="orgd3ebc46">Package Manager</h2> +<div class="outline-text-2" id="text-orgd3ebc46"> +<p> +Carbs Linux uses its own package manager <a href="https://github.com/CarbsLinux/cpt">Carbs Packaging Tools</a>, a POSIX shell +package manager forked from KISS with the tool-based approach of xbps. +</p> +</div> +</div> + + +<div id="outline-container-org1ed7ef0" class="outline-2"> +<h2 id="org1ed7ef0">Small base</h2> +<div class="outline-text-2" id="text-org1ed7ef0"> +<p> +By default, Carbs Linux comes with busybox for coreutils, bearssl for its crypto library, musl libc, and other basic utilities that are required for -building new software. The majority of the base packages are statically linked.</p> +building new software. The majority of the base packages are statically linked. +</p> +</div> +</div> -<h2>Multiple Init Support</h2> -<p>Carbs Linux has support for multiple init systems and service supervisors. In -the main repository are</p> +<div id="outline-container-orge0f142d" class="outline-2"> +<h2 id="orge0f142d">Multiple Init Support</h2> +<div class="outline-text-2" id="text-orge0f142d"> +<p> +Carbs Linux has support for multiple init systems and service supervisors. In +the main repository are +</p> -<ul> +<ul class="org-ul"> <li><code>sinit</code></li> <li><code>busybox-init</code> (SysVinit clone)</li> <li><code>runit-init</code></li> </ul> +<p> +for init systems, and +</p> -<p>for init systems, and</p> - -<ul> +<ul class="org-ul"> <li><code>sysmgr</code></li> <li><code>busybox-runit</code></li> <li><code>runit</code></li> </ul> - -<p>for service supervisors. The <a href="https://github.com/CarbsLinux/repository/tree/master/core/carbs-init">carbs-init</a> package is the collection of init +<p> +for service supervisors. The <a href="https://github.com/CarbsLinux/repository/tree/master/core/carbs-init">carbs-init</a> package is the collection of init scripts that ensure the interoperability of these init and service systems, and make it easier for the user to switch to their preferred combinations of system -supervision.</p> - -<p>Nothing holds you back, however, from ditching any of these and packaging some -other system supervision technique along with your own init scripts.</p> - -<h2>Links</h2> - -<ul> -<li>IRC - <code>#carbslinux</code> on freenode</li> -<li>Reddit - <a href="http://reddit.com/r/carbslinux">/r/carbslinux</a></li> -<li><a href="/mailing-lists.html">Mailing Lists</a></li> +supervision. +</p> + +<p> +Nothing holds you back, however, from ditching any of these and packaging some +other system supervision technique along with your own init scripts. +</p> +</div> +</div> + + +<div id="outline-container-org5534422" class="outline-2"> +<h2 id="org5534422">Links</h2> +<div class="outline-text-2" id="text-org5534422"> +<ul class="org-ul"> +<li>IRC - <code>#carbslinux</code> on freenode</li> +<li>Reddit - <a href="https://reddit.com/r/carbslinux">r/carbslinux</a></li> +<li><a href="mailing-lists.html">Mailing Lists</a></li> </ul> - - -<h2>News</h2> - -<p><a href="/news.xml">RSS Feed</a> | <a href="/news.html">See all news</a></p> - -<h2>Sep 16 2020</h2> - -<p>The libressl “revert” was reverted. System update will replace libressl +</div> +</div> + +<div id="outline-container-org99ea5f4" class="outline-2"> +<h2 id="org99ea5f4">News</h2> +<div class="outline-text-2" id="text-org99ea5f4"> +<p> +<a href="./news.xml">RSS Feed</a> | <a href="./news">See all news</a> +</p> +</div> + +<div id="outline-container-orgcc372e7" class="outline-3"> +<h3 id="orgcc372e7"><a href="../news/20200916.html">Sep 16, 2020</a></h3> +<div class="outline-text-3" id="text-orgcc372e7"> +<p> +The libressl "revert" was reverted. System update will replace libressl dependencies with bearssl. You may choose to keep or remove bearssl after the -update.</p> - -<h2>Sep 03 2020</h2> - -<p>The default TLS provider has been reverted to ‘libressl’. System update will +update. +</p> +</div> +</div> +<div id="outline-container-org5a36fc2" class="outline-3"> +<h3 id="org5a36fc2"><a href="../news/20200903.html">Sep 03, 2020</a></h3> +<div class="outline-text-3" id="text-org5a36fc2"> +<p> +The default TLS provider has been reverted to <code>libressl</code>. System update will replace bearssl dependencies with libressl. You may choose to keep or remove -bearssl after the update.</p> - -<h2>Jul 27 2020</h2> - -<p>Carbs Linux’s fork of the <code>kiss</code> package manager has been renamed to -<code>Carbs Packaging Tools</code> due to huge amount of changes. Your latest <code>kiss</code> -update will handle the bootstrapping. You will need to rename your <code>KISS-*</code> -variables to <code>CPT-*</code></p> - -<h2>Jun 17 2020</h2> - -<p>A new rootfs tarball including the changes to the core is released and can be -found on the downloads page.</p> - -<h2>May 26 2020</h2> - -<p>An initial version for binary package management is released. -It can be found on the <a href="https://github.com/CarbsLinux/kiss-bin">GitHub page</a>.</p> - <a href="/index.txt">View Page Source</a> - <div class="border"></div> - <p class=footer>Linux® is a registered trademark of Linus Torvalds</p> - <p class=footer>Copyright © 2019-2021 Cem Keylan</p> - </body> +bearssl after the update. +</p> +</div> +</div> +<div id="outline-container-org4a4807f" class="outline-3"> +<h3 id="org4a4807f"><a href="../news/20200727.html">Jul 27, 2020</a></h3> +<div class="outline-text-3" id="text-org4a4807f"> +<p> +Carbs Linux's fork of the <code>kiss</code> package manager has been renamed to <code>Carbs + Packaging Tools</code> due to huge amount of changes. Your latest <code>kiss</code> update will +handle the bootstrapping. You will need to rename your <code>KISS-*</code> variables to +<code>CPT-*</code>. +</p> +</div> +</div> +<div id="outline-container-org7f7d626" class="outline-3"> +<h3 id="org7f7d626"><a href="../news/20200617.html">Jun 17, 2020</a></h3> +<div class="outline-text-3" id="text-org7f7d626"> +<p> +A new rootfs tarball including the changes to the core is released and can be +found on the downloads page. +</p> +</div> +</div> +<div id="outline-container-org6162ade" class="outline-3"> +<h3 id="org6162ade"><a href="../news/20200526.html">May 26, 2020</a></h3> +<div class="outline-text-3" id="text-org6162ade"> +<p> +An initial version for binary package management is released. It can be found on +the <a href="https://github.com/CarbsLinux/kiss-bin">GitHub page</a>. +</p> +</div> +</div> +</div> +</div> +<div id="postamble" class="status"> +<footer> + <p>Linux® is a registered trademark of Linus Torvalds</p> + <p>Copyright © 2019-2021 Cem Keylan</p> +</footer> +</div> +</body> </html> diff --git a/docs/index.txt b/docs/index.txt index 9c3fa4d..50c04b2 100644 --- a/docs/index.txt +++ b/docs/index.txt @@ -1,97 +1,133 @@ -Carbs Linux is an in-development Linux® distribution with a suckless mindset. -The base system consists of only the necessary programs to create a Linux -distribution. +Carbs Linux is a source-based Linux(r) distribution that aims to be +simple, flexible and extensible while staying as pragmatic and practical +as possible. The system can consist of as much or as little as its user +can intend to. + Package Manager --------------------------------------------------------------------------------- +=============== + + Carbs Linux uses its own package manager [Carbs Packaging Tools], a + POSIX shell package manager forked from KISS with the tool-based + approach of xbps. + -Carbs Linux uses its own package manager [Carbs Packaging Tools], a POSIX shell -package manager forked from KISS with the tool-based approach of xbps. +[Carbs Packaging Tools] <https://github.com/CarbsLinux/cpt> Small base --------------------------------------------------------------------------------- +========== -By default, Carbs Linux comes with busybox for coreutils, bearssl for its -crypto library, musl libc, and other basic utilities that are required for -building new software. The majority of the base packages are statically linked. + By default, Carbs Linux comes with busybox for coreutils, bearssl for + its crypto library, musl libc, and other basic utilities that are + required for building new software. The majority of the base packages + are statically linked. Multiple Init Support --------------------------------------------------------------------------------- +===================== -Carbs Linux has support for multiple init systems and service supervisors. In -the main repository are + Carbs Linux has support for multiple init systems and service + supervisors. In the main repository are -- `sinit` -- `busybox-init` (SysVinit clone) -- `runit-init` + - `sinit' + - `busybox-init' (SysVinit clone) + - `runit-init' -for init systems, and + for init systems, and -- `sysmgr` -- `busybox-runit` -- `runit` + - `sysmgr' + - `busybox-runit' + - `runit' -for service supervisors. The [carbs-init] package is the collection of init -scripts that ensure the interoperability of these init and service systems, and -make it easier for the user to switch to their preferred combinations of system -supervision. + for service supervisors. The [carbs-init] package is the collection of + init scripts that ensure the interoperability of these init and + service systems, and make it easier for the user to switch to their + preferred combinations of system supervision. -Nothing holds you back, however, from ditching any of these and packaging some -other system supervision technique along with your own init scripts. + Nothing holds you back, however, from ditching any of these and + packaging some other system supervision technique along with your own + init scripts. -[carbs-init]: https://github.com/CarbsLinux/repository/tree/master/core/carbs-init -[Carbs Packaging Tools]: https://github.com/CarbsLinux/cpt +[carbs-init] +<https://github.com/CarbsLinux/repository/tree/master/core/carbs-init> + Links --------------------------------------------------------------------------------- +===== + + - IRC - `#carbslinux' on freenode + - Reddit - [r/carbslinux] + - [Mailing Lists] + -* IRC - `#carbslinux` on freenode -* Reddit - [/r/carbslinux] -* [Mailing Lists] +[r/carbslinux] <https://reddit.com/r/carbslinux> + +[Mailing Lists] <file:mailing-lists.org> -[/r/carbslinux]: http://reddit.com/r/carbslinux -[Mailing Lists]: /mailing-lists.html News --------------------------------------------------------------------------------- +==== + + [RSS Feed] | [See all news] + + +[RSS Feed] <file:./news.xml> + +[See all news] <file:./news> + +[Sep 16, 2020] +~~~~~~~~~~~~~~ + + The libressl "revert" was reverted. System update will replace + libressl dependencies with bearssl. You may choose to keep or remove + bearssl after the update. + + +[Sep 16, 2020] <file:../news/20200916.html> + + +[Sep 03, 2020] +~~~~~~~~~~~~~~ + + The default TLS provider has been reverted to `libressl'. System + update will replace bearssl dependencies with libressl. You may choose + to keep or remove bearssl after the update. + + +[Sep 03, 2020] <file:../news/20200903.html> + + +[Jul 27, 2020] +~~~~~~~~~~~~~~ + + Carbs Linux's fork of the `kiss' package manager has been renamed to + `Carbs Packaging Tools' due to huge amount of changes. Your latest + `kiss' update will handle the bootstrapping. You will need to rename + your `KISS-*' variables to `CPT-*'. + -[RSS Feed](/news.xml) | [See all news](/news.html) +[Jul 27, 2020] <file:../news/20200727.html> -Sep 16 2020 --------------------------------------------------------------------------------- -The libressl "revert" was reverted. System update will replace libressl -dependencies with bearssl. You may choose to keep or remove bearssl after the -update. +[Jun 17, 2020] +~~~~~~~~~~~~~~ -Sep 03 2020 --------------------------------------------------------------------------------- + A new rootfs tarball including the changes to the core is released and + can be found on the downloads page. -The default TLS provider has been reverted to 'libressl'. System update will -replace bearssl dependencies with libressl. You may choose to keep or remove -bearssl after the update. -Jul 27 2020 --------------------------------------------------------------------------------- +[Jun 17, 2020] <file:../news/20200617.html> -Carbs Linux's fork of the `kiss` package manager has been renamed to -`Carbs Packaging Tools` due to huge amount of changes. Your latest `kiss` -update will handle the bootstrapping. You will need to rename your `KISS-*` -variables to `CPT-*` -Jun 17 2020 --------------------------------------------------------------------------------- +[May 26, 2020] +~~~~~~~~~~~~~~ -A new rootfs tarball including the changes to the core is released and can be -found on the downloads page. + An initial version for binary package management is released. It can + be found on the [GitHub page]. -May 26 2020 --------------------------------------------------------------------------------- -An initial version for binary package management is released. -It can be found on the [GitHub page]. +[May 26, 2020] <file:../news/20200526.html> -[GitHub page]: https://github.com/CarbsLinux/kiss-bin +[GitHub page] <https://github.com/CarbsLinux/kiss-bin> diff --git a/docs/install.html b/docs/install.html new file mode 100644 index 0000000..8f6e2a0 --- /dev/null +++ b/docs/install.html @@ -0,0 +1,662 @@ +<!DOCTYPE html> +<html lang="en"> +<head> +<!-- 2021-02-02 --> +<meta charset="utf-8"> +<meta name="viewport" content="width=device-width, initial-scale=1"> +<title>Installation Guide</title> +<meta name="generator" content="Org mode"> +<meta name="author" content="Cem Keylan"> +<link rel="stylesheet" type="text/css" href="/style.css"> +</head> +<body> +<div id="preamble" class="status"> +<nav id="navbar"> + <a href="/" class=navbartitle>Carbs Linux</a> + + <label for="hamburger">☰</label> + <input type="checkbox" id="hamburger" /> + <ul id=navbarlist> + <li><a href="/" title="Home Page">Home</a></li> + <li><a href="//git.carbslinux.org" title="Git Repository">Git</a></li> + <li><a href="/download.html" title="Download Carbs Linux">Download</a></li> + <li><a href="/blog" title="Blog Posts">Blog</a></li> + <li><a href="/install.html" title="Installation Instructions">Installation</a></li> + <li><a href="/docs.html" title="Documentation">Docs</a></li> + </ul> +</nav> +</div> +<div id="content"> +<header> +<h1 class="title">Installation Guide</h1> +</header><p> +These are the step-by-step instructions for installing Carbs Linux. It can be +acquired as plain-text to be viewed offline with a pager from +<a href="https://carbslinux.org/install.txt">https://carbslinux.org/install.txt</a>. +</p> + +<div class="org-src-container"> +<pre class="src src-sh">curl -sL https://carbslinux.org/install.txt | less +</pre> +</div> + +<div id="text-table-of-contents"> +<ul> +<li><a href="#org3ef8e84">1. Preparing Environment</a> +<ul> +<li><a href="#orgff14f1e">1.1. Download</a></li> +<li><a href="#orgb03d704">1.2. Signature verification</a></li> +<li><a href="#org44c5069">1.3. Extracting the tarball</a></li> +<li><a href="#orgea6ba02">1.4. Obtain the chroot helper</a></li> +</ul> +</li> +<li><a href="#org32c470a">2. Chroot</a> +<ul> +<li><a href="#orgffe47f7">2.1. Setting up repositories</a> +<ul> +<li><a href="#org7913b8a">2.1.1. Obtaining from git</a></li> +<li><a href="#org69ce01c">2.1.2. Obtaining from rsync</a></li> +<li><a href="#orge7a96e2">2.1.3. Making the package manager use the repositories</a></li> +</ul> +</li> +<li><a href="#orge7115ca">2.2. Updating packages</a></li> +<li><a href="#org498cf81">2.3. Installing packages</a></li> +<li><a href="#orgc580a0d">2.4. Essential Software</a></li> +<li><a href="#org543d436">2.5. Obtaining the documentation</a></li> +</ul> +</li> +<li><a href="#orgf4a305b">3. System Configuration</a> +<ul> +<li><a href="#orgbb6f72c">3.1. Configuring hostname</a></li> +<li><a href="#org91ebad2">3.2. Hosts file</a></li> +</ul> +</li> +<li><a href="#orgab5cd50">4. Kernel</a> +<ul> +<li><a href="#orgbe83919">4.1. Obtaining the kernel sources</a></li> +<li><a href="#orge17a922">4.2. Kernel dependencies</a></li> +<li><a href="#org3d10772">4.3. Building the kernel</a></li> +</ul> +</li> +<li><a href="#org9ea370c">5. Making your system bootable</a> +<ul> +<li><a href="#org0972750">5.1. Bootloader</a> +<ul> +<li><a href="#org6851c50">5.1.1. GRUB BIOS installation</a></li> +<li><a href="#orgf4bbd79">5.1.2. GRUB UEFI installation</a></li> +</ul> +</li> +<li><a href="#org2e0c9fd">5.2. Init scripts</a></li> +<li><a href="#org3ca705c">5.3. Fstab</a></li> +</ul> +</li> +<li><a href="#org3847026">6. Post-installation</a> +<ul> +<li><a href="#orgdcd7be8">6.1. KISS repositories</a></li> +</ul> +</li> +</ul> +</div> +<div id="outline-container-org3ef8e84" class="outline-2"> +<h2 id="org3ef8e84"><span class="section-number-2">1</span> Preparing Environment</h2> +<div class="outline-text-2" id="text-1"> +<p> +To install Carbs Linux, you will need a Live Linux ISO. For that purpose, you +can obtain a Gentoo or Void Linux live image. You can follow their instructions +to boot and setup your network. +</p> + +<p> +You will need the following programs in order to install Carbs Linux: +</p> + +<ul class="org-ul"> +<li>tar</li> +<li>wget</li> +<li>xz</li> +<li>some form of base utilities (coreutils, sbase, busybox, etc.)</li> +</ul> + +<p> +Rest of these instructions will assume that you have set all of these up, and +will continue on that point. +</p> +</div> + +<div id="outline-container-orgff14f1e" class="outline-3"> +<h3 id="orgff14f1e"><span class="section-number-3">1.1</span> Download</h3> +<div class="outline-text-3" id="text-1-1"> +<p> +First, we need to download the rootfs tarball. You can do the following in order +to obtain the rootfs. If you are using an i686 machine, replace the <code>x86_64</code> +with <code>i686</code>. We are setting this in a URL variable so that we don't have to +write it every time. +</p> + +<div class="org-src-container"> +<pre class="src src-sh">wget $<span class="org-variable-name">URL</span>/carbs-rootfs.tar.xz.sha256 +sha256sum -c carbs-rootfs.tar.xz.sha256 +</pre> +</div> +</div> +</div> + +<div id="outline-container-orgb03d704" class="outline-3"> +<h3 id="orgb03d704"><span class="section-number-3">1.2</span> Signature verification</h3> +<div class="outline-text-3" id="text-1-2"> +<p> +It is highly recommended to verify the signature of the tarball. You will need +GPG for this. +</p> + +<div class="org-src-container"> +<pre class="src src-sh">wget $<span class="org-variable-name">URL</span>/carbs-rootfs.tar.xz.sig +gpg --recv-keys FF484BDFEFCEF8FF +gpg --verify carbs-rootfs.tar.xz.sig +</pre> +</div> +</div> +</div> + +<div id="outline-container-org44c5069" class="outline-3"> +<h3 id="org44c5069"><span class="section-number-3">1.3</span> Extracting the tarball</h3> +<div class="outline-text-3" id="text-1-3"> +<p> +You will need to extract the tarball to your desired location. For partitioning, +you can follow <a href="https://wiki.archlinux.org/index.php/Partitioning">this guide</a>. This will assume that you will be mounting your root +partition to <code>/mnt</code>. +</p> + +<div class="org-src-container"> +<pre class="src src-sh">mount /dev/sdx1 /mnt +tar xf carbs-rootfs.tar.xz -C /mnt +</pre> +</div> +</div> +</div> + +<div id="outline-container-orgea6ba02" class="outline-3"> +<h3 id="orgea6ba02"><span class="section-number-3">1.4</span> Obtain the chroot helper</h3> +<div class="outline-text-3" id="text-1-4"> +<p> +You can obtain the <code>cpt-chroot</code> script in order to do a simple chroot into your +new root filesystem. +</p> + +<div class="org-src-container"> +<pre class="src src-sh">wget https://dl.carbslinux.org/distfiles/cpt-chroot +chmod a+x cpt-chroot +</pre> +</div> +</div> +</div> +</div> + +<div id="outline-container-org32c470a" class="outline-2"> +<h2 id="org32c470a"><span class="section-number-2">2</span> Chroot</h2> +<div class="outline-text-2" id="text-2"> +<p> +Chroot into Carbs Linux! +</p> + +<div class="org-src-container"> +<pre class="src src-sh">./cpt-chroot /mnt +</pre> +</div> +</div> + +<div id="outline-container-orgffe47f7" class="outline-3"> +<h3 id="orgffe47f7"><span class="section-number-3">2.1</span> Setting up repositories</h3> +<div class="outline-text-3" id="text-2-1"> +<p> +Newest tarballs do not come with repositories, so you will need to manually +obtain them, and set your <code>CPT_PATH</code> environment variable. Carbs Linux +repositories can either be obtained by <code>git</code> or <code>rsync</code>. While rsync +repositories are overall faster and smaller, git offers the whole history of the +repository and a means to manipulate your repository as you like it. If you want +to obtain the git repository, you will need to install <code>git</code> itself. +</p> + +<p> +The following guide will assume that you put the repositories into <code>~/repos/</code> +directory, but you can put the repositories into any directory you want. So go +ahead and create that directory: +</p> + +<div class="org-src-container"> +<pre class="src src-sh">mkdir -p $<span class="org-variable-name">HOME</span>/repos +</pre> +</div> +</div> + +<div id="outline-container-org7913b8a" class="outline-4"> +<h4 id="org7913b8a"><span class="section-number-4">2.1.1</span> Obtaining from git</h4> +<div class="outline-text-4" id="text-2-1-1"> +<p> +Carbs Linux git repositories can be found both from the main server and GitHub +(mirror). Here are both their repository links. You can clone any of them. +</p> + +<ul class="org-ul"> +<li>git://git.carbslinux.org/repository</li> +<li><a href="https://github.com/carbslinux/repository">https://github.com/carbslinux/repository</a></li> +</ul> + +<div class="org-src-container"> +<pre class="src src-sh">git clone git://git.carbslinux.org/repository $<span class="org-variable-name">HOME</span>/repos/carbs +</pre> +</div> +</div> +</div> + +<div id="outline-container-org69ce01c" class="outline-4"> +<h4 id="org69ce01c"><span class="section-number-4">2.1.2</span> Obtaining from rsync</h4> +<div class="outline-text-4" id="text-2-1-2"> +<p> +Carbs Linux rsync repositories live in rsync://carbslinux.org/repo. In +order to obtain it, run the following: +</p> + +<div class="org-src-container"> +<pre class="src src-sh">rsync -avc rsync://carbslinux.org/repo $<span class="org-variable-name">HOME</span>/repos/carbs +</pre> +</div> +</div> +</div> + +<div id="outline-container-orge7a96e2" class="outline-4"> +<h4 id="orge7a96e2"><span class="section-number-4">2.1.3</span> Making the package manager use the repositories</h4> +<div class="outline-text-4" id="text-2-1-3"> +<p> +In your shell's configuration file, or in your <code>~/.profile</code> file, add the +following lines: +</p> + +<div class="org-src-container"> +<pre class="src src-sh"><span class="org-variable-name">CPT_PATH</span>=$<span class="org-variable-name">HOME</span>/repos/carbs/core +<span class="org-variable-name">CPT_PATH</span>=$<span class="org-variable-name">CPT_PATH</span>:$<span class="org-variable-name">HOME</span>/repos/carbs/extra +<span class="org-variable-name">CPT_PATH</span>=$<span class="org-variable-name">CPT_PATH</span>:$<span class="org-variable-name">HOME</span>/repos/carbs/xorg +<span class="org-variable-name">CPT_PATH</span>=$<span class="org-variable-name">CPT_PATH</span>:$<span class="org-variable-name">HOME</span>/repos/carbs/community +<span class="org-builtin">export</span> CPT_PATH +</pre> +</div> +</div> +</div> +</div> + +<div id="outline-container-orge7115ca" class="outline-3"> +<h3 id="orge7115ca"><span class="section-number-3">2.2</span> Updating packages</h3> +<div class="outline-text-3" id="text-2-2"> +<p> +It is good practice to make sure your system is up to date, especially before +building new packages. If there is an update for the package manager you will +need to update twice. +</p> + +<div class="org-src-container"> +<pre class="src src-sh">cpt-update && cpt-update +</pre> +</div> +</div> +</div> + +<div id="outline-container-org498cf81" class="outline-3"> +<h3 id="org498cf81"><span class="section-number-3">2.3</span> Installing packages</h3> +<div class="outline-text-3" id="text-2-3"> +<p> +Since you are operating on a really small base, you might need to build and +install new programs to extend the functionality of your system. In order to +build and install packages new packages in Carbs, you need to execute the +following. "Package" is not actually a package and is given as an example. +</p> + +<div class="org-src-container"> +<pre class="src src-sh">cpt-build package +cpt-install package +</pre> +</div> +</div> +</div> + +<div id="outline-container-orgc580a0d" class="outline-3"> +<h3 id="orgc580a0d"><span class="section-number-3">2.4</span> Essential Software</h3> +<div class="outline-text-3" id="text-2-4"> +<p> +Here is a list of software that you might want to have on your system. +</p> + +<p> +<b>BOOTLOADERS</b> +</p> + +<ul class="org-ul"> +<li>efibootmgr</li> +<li>grub</li> +</ul> + +<p> +<b>FILESYSTEMS</b> +</p> + +<ul class="org-ul"> +<li>e2fsprogs</li> +<li>dosfstools</li> +<li>ntfs-3g</li> +</ul> + +<p> +<b>NETWORKING</b> +</p> + +<ul class="org-ul"> +<li>dhcpcd</li> +<li>wpa<sub>supplicant</sub></li> +</ul> + +<p> +<b>TEXT EDITORS</b> +</p> + +<ul class="org-ul"> +<li>nano</li> +<li>vim</li> +<li>neatvi</li> +<li>emacs</li> +<li>emacs-nox (terminal-only version of emacs)</li> +</ul> + +<p> +<b>USER SHELLS</b> +</p> + +<ul class="org-ul"> +<li>bash</li> +<li>zsh</li> +<li>oksh</li> +<li>rc</li> +</ul> + +<p> +<b>POSIX BASE UTILITIES</b> +</p> + +<ul class="org-ul"> +<li>busybox</li> +<li>sbase</li> +<li>coreutils</li> +</ul> + +<p> +<b>DOCUMENTATION</b> +</p> + +<ul class="org-ul"> +<li>carbs-docs</li> +<li>man-pages</li> +<li>man-pages-posix</li> +</ul> +</div> +</div> + +<div id="outline-container-org543d436" class="outline-3"> +<h3 id="org543d436"><span class="section-number-3">2.5</span> Obtaining the documentation</h3> +<div class="outline-text-3" id="text-2-5"> +<p> +All the documentation for Carbs Linux can be found on a single info manual to be +viewed offline. You can obtain texinfo or the info (standalone) package in order +to view the documentation. +</p> + +<div class="org-src-container"> +<pre class="src src-sh"><span class="org-comment-delimiter"># </span><span class="org-comment">Install the documentation.</span> +cpt b carbs-docs && cpt i carbs-docs + +<span class="org-comment-delimiter"># </span><span class="org-comment">Install either texinfo or the info package. We will be installing standalone info</span> +<span class="org-comment-delimiter"># </span><span class="org-comment">as it doesn't need perl.</span> +cpt b info && cpt i info + +<span class="org-comment-delimiter"># </span><span class="org-comment">You can then run info and navigate through the documentation.</span> +info carbslinux +</pre> +</div> +</div> +</div> +</div> + +<div id="outline-container-orgf4a305b" class="outline-2"> +<h2 id="orgf4a305b"><span class="section-number-2">3</span> System Configuration</h2> +<div class="outline-text-2" id="text-3"> +<p> +After you have finished installing some extra packages, you can configure your +system to your liking. +</p> +</div> + +<div id="outline-container-orgbb6f72c" class="outline-3"> +<h3 id="orgbb6f72c"><span class="section-number-3">3.1</span> Configuring hostname</h3> +<div class="outline-text-3" id="text-3-1"> +<p> +You might want to add a hostname, especially in a networked environment. Your +hostname will default to 'carbslinux' unless you set this. +</p> + +<div class="org-src-container"> +<pre class="src src-sh"><span class="org-builtin">echo</span> your-hostname > /etc/hostname +</pre> +</div> +</div> +</div> + +<div id="outline-container-org91ebad2" class="outline-3"> +<h3 id="org91ebad2"><span class="section-number-3">3.2</span> Hosts file</h3> +<div class="outline-text-3" id="text-3-2"> +<p> +You can edit your /etc/hosts file, which is the static lookup table for host +names. By default, there are two entries for localhost which are OKAY. You can +replace the 'localhost' part of these entries to your hostname. +</p> + +<pre class="example" id="org6b852dd"> +127.0.0.1 localhost.localdomain localhost +::1 localhost.localdomain localhost ip6-localhost +</pre> +</div> +</div> +</div> + +<div id="outline-container-orgab5cd50" class="outline-2"> +<h2 id="orgab5cd50"><span class="section-number-2">4</span> Kernel</h2> +<div class="outline-text-2" id="text-4"> +<p> +Kernel isn't managed under the main repositories, even though you could package +one for your personal use. Here is an <a href="https://github.com/cemkeylan/kiss-repository/tree/master/personal/linux">example kernel package</a>, which you will +need to reconfigure for your specific setup if you want to make use of it. +</p> +</div> + +<div id="outline-container-orgbe83919" class="outline-3"> +<h3 id="orgbe83919"><span class="section-number-3">4.1</span> Obtaining the kernel sources</h3> +<div class="outline-text-3" id="text-4-1"> +<p> +You can visit the <a href="https://kernel.org">https://kernel.org</a> website to choose a kernel that you want +to install. Though only the latest stable and longterm (LTS) versions are +supported. +</p> + +<div class="org-src-container"> +<pre class="src src-sh"><span class="org-comment-delimiter"># </span><span class="org-comment">Download the kernel and extract it</span> +wget https://cdn.kernel.org/pub/linux/kernel/v5.x/linux-5.9.1.tar.xz +tar xf linux-5.9.1.tar.xz + +<span class="org-comment-delimiter"># </span><span class="org-comment">Change directory into the kernel sources</span> +<span class="org-builtin">cd</span> linux-5.9.1 +</pre> +</div> +</div> +</div> + +<div id="outline-container-orge17a922" class="outline-3"> +<h3 id="orge17a922"><span class="section-number-3">4.2</span> Kernel dependencies</h3> +<div class="outline-text-3" id="text-4-2"> +<p> +In order to compile the kernel you will need to install some dependencies. You +will need <code>libelf</code>, and <code>bison</code> to compile the kernel. If you want to configure +using the menu interface you will also need <code>ncurses</code>. +</p> + +<div class="org-src-container"> +<pre class="src src-sh"><span class="org-comment-delimiter"># </span><span class="org-comment">The package manager asks to install if you are building more than one package,</span> +<span class="org-comment-delimiter"># </span><span class="org-comment">so no need to run 'cpt i ...'</span> +cpt b libelf ncurses +</pre> +</div> + +<p> +In the vanilla kernel sources, you need perl to compile the kernel, but it can +be easily patched out. You will need to apply the following patch. Patch was +written by <a href="https://github.com/E5ten">E5ten</a>. You will need to obtain and apply the patch in the kernel +source directory. +</p> + +<div class="org-src-container"> +<pre class="src src-sh">wget https://dl.carbslinux.org/distfiles/kernel-no-perl.patch +patch -p1 < kernel-no-perl.patch +</pre> +</div> +</div> +</div> + +<div id="outline-container-org3d10772" class="outline-3"> +<h3 id="org3d10772"><span class="section-number-3">4.3</span> Building the kernel</h3> +<div class="outline-text-3" id="text-4-3"> +<p> +Next step is configuring and building the kernel. You can check Gentoo's +<a href="https://wiki.gentoo.org/wiki/Kernel/Configuration">kernel configuration guide</a> to learn more about the matter. Overall, Gentoo Wiki +is a good place to learn about configuration according to your hardware. The +following will assume a monolithic kernel. +</p> + +<div class="org-src-container"> +<pre class="src src-sh">make menuconfig +make +install -Dm755 $(make -s image_name) /boot/vmlinuz-linux +</pre> +</div> +</div> +</div> +</div> + +<div id="outline-container-org9ea370c" class="outline-2"> +<h2 id="org9ea370c"><span class="section-number-2">5</span> Making your system bootable</h2> +<div class="outline-text-2" id="text-5"> +<p> +In order to be able to boot your fresh system, wou will need an init-daemon, +init-scripts and a bootloader. The init daemon is already provided by busybox, +but you can optionally change it. +</p> +</div> + +<div id="outline-container-org0972750" class="outline-3"> +<h3 id="org0972750"><span class="section-number-3">5.1</span> Bootloader</h3> +<div class="outline-text-3" id="text-5-1"> +<p> +In the main repository, there is efibootmgr and grub to serve as bootloaders. +efibootmgr can be used as a standalone bootloader, or can be used to install +grub in a UEFI environment. efibootmgr is needed unless you are using a device +without UEFI support (or you really want to use BIOS for a reason). +</p> +</div> + +<div id="outline-container-org6851c50" class="outline-4"> +<h4 id="org6851c50"><span class="section-number-4">5.1.1</span> GRUB BIOS installation</h4> +<div class="outline-text-4" id="text-5-1-1"> +<div class="org-src-container"> +<pre class="src src-sh">cpt b grub && cpt i grub +grub-install --target=i386-pc /dev/sdX +grub-mkconfig -o /boot/grub/grub.cfg +</pre> +</div> +</div> +</div> + +<div id="outline-container-orgf4bbd79" class="outline-4"> +<h4 id="orgf4bbd79"><span class="section-number-4">5.1.2</span> GRUB UEFI installation</h4> +<div class="outline-text-4" id="text-5-1-2"> +<div class="org-src-container"> +<pre class="src src-sh">cpt b efibootmgr && cpt i efibootmgr +cpt b grub && cpt i grub + +grub-install --target=x86_64-efi <span class="org-sh-escaped-newline">\</span> + --efi-directory=esp <span class="org-sh-escaped-newline">\</span> + --bootloader-id=CarbsLinux + +grub-mkconfig -o /boot/grub/grub.cfg +</pre> +</div> +</div> +</div> +</div> + +<div id="outline-container-org2e0c9fd" class="outline-3"> +<h3 id="org2e0c9fd"><span class="section-number-3">5.2</span> Init scripts</h3> +<div class="outline-text-3" id="text-5-2"> +<p> +Only thing left to do is installing the init-scripts, and now you are almost +ready to boot your system! +</p> + +<div class="org-src-container"> +<pre class="src src-sh">cpt b carbs-init && cpt i carbs-init +</pre> +</div> +</div> +</div> + +<div id="outline-container-org3ca705c" class="outline-3"> +<h3 id="org3ca705c"><span class="section-number-3">5.3</span> Fstab</h3> +<div class="outline-text-3" id="text-5-3"> +<p> +You can now manually edit your fstab entry, or you can use the genfstab tool. +If you want to use the tool, exit the chroot and run the following: +</p> + +<div class="org-src-container"> +<pre class="src src-sh">wget https://github.com/cemkeylan/genfstab/raw/master/genfstab +chmod +x genfstab +./genfstab -U /mnt >> /mnt/etc/fstab +</pre> +</div> +</div> +</div> +</div> + +<div id="outline-container-org3847026" class="outline-2"> +<h2 id="org3847026"><span class="section-number-2">6</span> Post-installation</h2> +<div class="outline-text-2" id="text-6"> +<p> +The base installation is now complete, you can now fine tune your system +according to your needs. Rest of these instructions are completely optional. +You can check the rest of the documentation to learn more about the system. +</p> +</div> + +<div id="outline-container-orgdcd7be8" class="outline-3"> +<h3 id="orgdcd7be8"><span class="section-number-3">6.1</span> KISS repositories</h3> +<div class="outline-text-3" id="text-6-1"> +<p> +While not 100% compatible with cpt, you can use kiss repositories in your +system the same way you are using the distribution repositories. Here is an +example for the KISS Linux Community repository. +</p> +</div> +</div> +</div> +</div> +<div id="postamble" class="status"> +<footer> + <p>Linux® is a registered trademark of Linus Torvalds</p> + <p>Copyright © 2019-2021 Cem Keylan</p> +</footer> +</div> +</body> +</html> diff --git a/src/docs/install.txt b/docs/install.txt index 6f51fa8..ba1899c 100644 --- a/src/docs/install.txt +++ b/docs/install.txt @@ -1,13 +1,16 @@ - ________________________________ + ____________________ - CARBS LINUX INSTALLATION GUIDE + INSTALLATION GUIDE + ____________________ - Cem Keylan - ________________________________ +These are the step-by-step instructions for installing Carbs Linux. It +can be acquired as plain-text to be viewed offline with a pager from +<https://carbslinux.org/install.txt>. -Table of Contents -_________________ +,---- +| curl -sL https://carbslinux.org/install.txt | less +`---- 1. Preparing Environment .. 1. Download @@ -40,15 +43,6 @@ _________________ .. 1. KISS repositories -These are the step-by-step instructions for installing Carbs Linux. It -can be acquired as plain-text to be viewed offline with a pager from -<https://carbslinux.org/docs/install.txt>. - -,---- -| curl -sL https://carbslinux.org/docs/install.txt | less -`---- - - 1 Preparing Environment ======================= @@ -355,9 +349,9 @@ can be acquired as plain-text to be viewed offline with a pager from ~~~~~~~~~~~~~~~~~~~~~~~ In order to compile the kernel you will need to install some - dependencies. You will need `libelf' to compile the kernel. If you - want to configure using the menu interface you will also need - `ncurses'. + dependencies. You will need `libelf', and `bison' to compile the + kernel. If you want to configure using the menu interface you will + also need `ncurses'. ,---- | # The package manager asks to install if you are building more than one package, diff --git a/docs/mailing-lists.html b/docs/mailing-lists.html index 82772da..b157045 100644 --- a/docs/mailing-lists.html +++ b/docs/mailing-lists.html @@ -1,36 +1,48 @@ -<!DOCTYPE HTML> -<html lan=en> - <head> - <title>Mailing Lists | Carbs Linux</title> - <link rel="stylesheet" href="/style.css"> - <meta charset="utf-8"> - <meta name="Description" content="Carbs Linux - a simple linux distribution"> - <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no"> - </head> - <body> - <p class=header><strong>Carbs Linux - a simple linux distribution</strong></p> - <div class="header"> - <nav> - <a href='/'>index</a> - <a href="//git.carbslinux.org">git</a> - <a href='//dl.carbslinux.org'>downloads</a> - <a href='/blog'>blog</a> - <a href='/docs/install.html'>installation</a> - <a href='/docs'>user manual</a> - </nav> - </div><div class="border"></div> -<h1>Mailing Lists</h1> +<!DOCTYPE html> +<html lang="en"> +<head> +<!-- 2021-02-02 --> +<meta charset="utf-8"> +<meta name="viewport" content="width=device-width, initial-scale=1"> +<title>Mailing Lists</title> +<meta name="generator" content="Org mode"> +<meta name="author" content="Cem Keylan"> +<link rel="stylesheet" type="text/css" href="/style.css"> +</head> +<body> +<div id="preamble" class="status"> +<nav id="navbar"> + <a href="/" class=navbartitle>Carbs Linux</a> -<p>We have mailing lists set up at <a href="https://sr.ht">sourcehut</a>. You can subscribe to the mailing -list by sending an empty mail to</p> + <label for="hamburger">☰</label> + <input type="checkbox" id="hamburger" /> + <ul id=navbarlist> + <li><a href="/" title="Home Page">Home</a></li> + <li><a href="//git.carbslinux.org" title="Git Repository">Git</a></li> + <li><a href="/download.html" title="Download Carbs Linux">Download</a></li> + <li><a href="/blog" title="Blog Posts">Blog</a></li> + <li><a href="/install.html" title="Installation Instructions">Installation</a></li> + <li><a href="/docs.html" title="Documentation">Docs</a></li> + </ul> +</nav> +</div> +<div id="content"> +<header> +<h1 class="title">Mailing Lists</h1> +</header><p> +We have mailing lists set up at <a href="https://sr.ht">SourceHut</a>. You can subscribe to the mailing +list by sending an empty mail to <a href="mailto:~carbslinux/dev+subscribe@lists.sr.ht">~carbslinux/dev+subscribe@lists.sr.ht</a>. +</p> -<pre><code>~carbslinux/dev+subscribe@lists.sr.ht -</code></pre> - -<p>You can also see the <a href="https://lists.sr.ht/~carbslinux/dev">archives</a>.</p> - <a href="/mailing-lists.txt">View Page Source</a> - <div class="border"></div> - <p class=footer>Linux® is a registered trademark of Linus Torvalds</p> - <p class=footer>Copyright © 2019-2021 Cem Keylan</p> - </body> +<p> +You can also see the <a href="https://lists.sr.ht/~carbslinux/dev">archives</a>. +</p> +</div> +<div id="postamble" class="status"> +<footer> + <p>Linux® is a registered trademark of Linus Torvalds</p> + <p>Copyright © 2019-2021 Cem Keylan</p> +</footer> +</div> +</body> </html> diff --git a/docs/mailing-lists.txt b/docs/mailing-lists.txt index baa97a7..35773e9 100644 --- a/docs/mailing-lists.txt +++ b/docs/mailing-lists.txt @@ -1,12 +1,19 @@ -Mailing Lists -================================================================================ + _______________ -We have mailing lists set up at [sourcehut]. You can subscribe to the mailing -list by sending an empty mail to + MAILING LISTS + _______________ - ~carbslinux/dev+subscribe@lists.sr.ht + +We have mailing lists set up at [SourceHut]. You can subscribe to the +mailing list by sending an empty mail to +[~carbslinux/dev+subscribe@lists.sr.ht]. You can also see the [archives]. -[sourcehut]: https://sr.ht -[archives]: https://lists.sr.ht/~carbslinux/dev + +[SourceHut] <https://sr.ht> + +[~carbslinux/dev+subscribe@lists.sr.ht] +<mailto:~carbslinux/dev+subscribe@lists.sr.ht> + +[archives] <https://lists.sr.ht/~carbslinux/dev> diff --git a/docs/news.html b/docs/news.html deleted file mode 100644 index 6e047b0..0000000 --- a/docs/news.html +++ /dev/null @@ -1,248 +0,0 @@ -<!DOCTYPE HTML> -<html lan=en> - <head> - <title>Sep 16 2020 | Carbs Linux</title> - <link rel="stylesheet" href="/style.css"> - <meta charset="utf-8"> - <meta name="Description" content="Carbs Linux - a simple linux distribution"> - <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no"> - </head> - <body> - <p class=header><strong>Carbs Linux - a simple linux distribution</strong></p> - <div class="header"> - <nav> - <a href='/'>index</a> - <a href="//git.carbslinux.org">git</a> - <a href='//dl.carbslinux.org'>downloads</a> - <a href='/blog'>blog</a> - <a href='/docs/install.html'>installation</a> - <a href='/docs'>user manual</a> - </nav> - </div><div class="border"></div> -<h2>Sep 16 2020</h2> - -<p>The libressl “revert” was reverted. System update will replace libressl -dependencies with bearssl. You may choose to keep or remove bearssl after the -update.</p> - -<h2>Sep 03 2020</h2> - -<p>The default TLS provider has been reverted to ‘libressl’. System update will -replace bearssl dependencies with libressl. You may choose to keep or remove -bearssl after the update.</p> - -<h2>Jul 27 2020</h2> - -<p>Carbs Linux’s fork of the <code>kiss</code> package manager has been renamed to -<code>Carbs Packaging Tools</code> due to huge amount of changes. Your latest <code>kiss</code> -update will handle the bootstrapping. You will need to rename your <code>KISS-*</code> -variables to <code>CPT-*</code></p> - -<h2>Jun 17 2020</h2> - -<p>A new rootfs tarball including the changes to the core is released and can be -found on the downloads page.</p> - -<h2>May 26 2020</h2> - -<p>An initial version for binary package management is released. -It can be found on the <a href="https://github.com/CarbsLinux/kiss-bin">GitHub page</a>.</p> - -<h2>May 19 2020</h2> - -<p>A rootfs tarball targeting the i686 architecture has -been released. It can be found on the <a href="https://dl.carbslinux.org/releases/i686">downloads page</a></p> - -<h2>May 10 2020</h2> - -<p>A GCC 10.1.0 change causes a kernel panic for kernels built -with GCC 10.1. This issue can be resolved by applying this -<a href="https://git.kernel.org/pub/scm/linux/kernel/git/tip/tip.git/patch/?id=f670269a42bfdd2c83a1118cc3d1b475547eac22">patch</a> to your kernel sources.</p> - -<h2>Apr 27 2020</h2> - -<p>A new rootfs tarball has been released! You can -see it on <a href="https://dl.carbslinux.org/releases">https://dl.carbslinux.org/releases</a>!</p> - -<p><strong>EDIT:</strong> A new bug fix release has been made.</p> - -<h2>Apr 10 2020</h2> - -<p>IRC channel can now be accessed from <code>#carbslinux</code> at freenode!</p> - -<h2>Apr 06 2020</h2> - -<p>A new rootfs tarball has been released. See the -<a href="https://dl.carbslinux.org">downloads</a> page</p> - -<h2>Apr 05 2020</h2> - -<p>Carbs Linux repositories will be hosted only on Github. Commits will be -pushed there, and not the repository. You have until -May 4, 2020 Monday to switch your remotes to <a href="https://github.com/CarbsLinux/repository">https://github.com/CarbsLinux/repository</a>. -The git repository will continue to be served until then (without additional -commits).</p> - -<p>You can switch your remote by executing the following command on your -repository directory.</p> - -<pre><code>git remote set-url origin https://github.com/CarbsLinux/repository -</code></pre> - -<h2>Feb 18 2020</h2> - -<p>A new tarball is released. It can be found on <a href="https://dl.carbslinux.org">https://dl.carbslinux.org</a>.</p> - -<p><strong>edit:</strong> I have removed the tarball because of a bootstrapping issue. -I will be re-adding it later today.</p> - -<p><strong>edit 2:</strong> I have added a tarball (20200219) to reflect my recent -changes on Busybox.</p> - -<h2>Feb 14 2020</h2> - -<p><strong>IMPORTANT!</strong> Carbs-init update to be released on 17th of February -will require manual intervention. I am holding this update back so -people can see it before they update their system (even though the -update will show the same message as this). The rationale for the -update is explained below the intervention.</p> - -<pre><code># There is an explanation for each init -# You only need to follow the instructions -# for your own init-system - -## busybox-init -# If you did not edit your inittab simply -# move inittab.new to inittab --> mv /etc/inittab.new /etc/inittab - -# If you did edit your inittab you can use -# a simple sed command to remove the necessary lines --> sed -i '/getty/d;/runsvdir/d' /etc/inittab - - -## runit -# same as busybox-init, if you did not edit -# /etc/runit/2 move 2.new to 2 --> mv /etc/runit/2.new /etc/runit/2 - -# else --> vim /etc/runit/2 -# open your 2 file and remove the for loop containing -# getty commands. If you are using runit, it is recommended -# to comment out /etc/init/runit.boot - -## sinit/minit -# If you did not edit your {sinit-,}launch-services.boot -# you can simply remove it. --> rm -f /etc/init/launch-services.boot /etc/init/sinit-launch-services.boot - -# This should leave you without any issues, and you can safely reboot. -</code></pre> - -<p>Carbs-init update is to make sure init systems do not clash, and do -not have to use different files. This is a sensible update both for -the user user and for the maintainer side.</p> - -<p>To give an example, before this update busybox-init was managing getty -through <code>inittab</code>, runit was managing through <code>/etc/runit/2</code>, and -minit/sinit were launching from <code>/etc/init/launch-services.boot</code>. This -is a configuration nightmare for everyone, and since I am maintaining -and constantly testing those init providers, a huge nightmare for me. -This is a Quality of Life update.</p> - -<h2>Feb 13 2020</h2> - -<p>Runit is now released on the core repository! You can now replace -busybox-init with runit-init. You can also replace the busybox runit -utilities with the actual runit. This will reduce the dependency on -busybox greatly.</p> - -<h2>Jan 28 2020</h2> - -<p>Web Server is now on a Carbs Linux server. It is not complete yet, -but I will be adding a little more for the intended functionality. -Downtimes can be expected.</p> - -<p>UPDATE: ssl is now working.</p> - -<p>UPDATE2: downloads are back again.</p> - -<h2>Jan 22 2020</h2> - -<p>Expect downtime on Jan 24 2020 22:00 UTC as I will be migrating -this web server to my Carbs Linux server!</p> - -<h2>Jan 15 2020</h2> - -<p>sinit has been taken to <code>core</code>, and is now officially supported</p> - -<h2>Jan 13 2020</h2> - -<p><strong>Busybox update reqires manual intervention</strong></p> - -<p>The new busybox package conflicts with the pre-update busybox-init. That’s why -you should rebuild and install <code>busybox-init</code> before doing the update.</p> - -<pre><code># Do a kiss update first (but don't actually update it yet), or manually pull the git repository -$ kiss u # Cancel this operation after it asks for you to confirm the update - -# Install the busybox-init package -$ kiss b busybox-init && kiss i busybox-init - -# Continue your update as you normally would. -$ kiss u -</code></pre> - -<p>I have moved runit and logging utilities from the busybox-init package to the busybox -package, which is the cause of these conflicts.</p> - -<h2>Jan 10 2020</h2> - -<p>carbs-rootfs-20200110.tar.xz was <a href="//dl.carbslinux.org/releases">released</a></p> - -<h2>Jan 09 2020</h2> - -<p>Happy new year, everyone! I am back after some long silence. I was unable to commit for a -while, but I have pulled some new updates from the KISS repository, added some of my own. -This week I will be changing/adding some things.</p> - -<p>Important things are,</p> - -<ul> -<li>Carbs-init was updated to 0.3.</li> -<li>I will be adding an implementation of suckless.org’s <a href="//core.suckless.org/sinit">sinit</a> as <code>carbs-sinit</code></li> -<li>Carbs Repository was added to <a href="//repology.org/repository/carbs">repology.org</a></li> -<li>A new rootfs tarball will be coming up tomorrow.</li> -</ul> - - -<h2>Dec 18 2019</h2> - -<p>carbs-rootfs-20191218.tar.xz was <a href="//dl.carbslinux.org/releases">released</a></p> - -<h2>Dec 17 2019</h2> - -<p>Installation instruction are now complete. A review would be greatly appreciated!</p> - -<h2>Dec 15 2019</h2> - -<p>Carbs Linux Wiki is now available to be edited and updated by the users go -to the <a href="//carbslinux.org/wiki">wiki</a> to obtain more information.</p> - -<p><strong>February 2020 EDIT:</strong> Changed link for wiki</p> - -<h2>Dec 12 2019</h2> - -<p>Busybox and Busybox-init has been seperated into two different packages. -This is for adding standalone runit/runit-init to the repositories.</p> - -<h2>Dec 10 2019</h2> - -<p>First alpha release was made. See the <a href="//dl.carbslinux.org/releases">downloads page</a>.</p> - <a href="/news.txt">View Page Source</a> - <div class="border"></div> - <p class=footer>Linux® is a registered trademark of Linus Torvalds</p> - <p class=footer>Copyright © 2019-2021 Cem Keylan</p> - </body> -</html> diff --git a/docs/news.txt b/docs/news.txt deleted file mode 100644 index 67d1788..0000000 --- a/docs/news.txt +++ /dev/null @@ -1,259 +0,0 @@ -Sep 16 2020 --------------------------------------------------------------------------------- - -The libressl "revert" was reverted. System update will replace libressl -dependencies with bearssl. You may choose to keep or remove bearssl after the -update. - -Sep 03 2020 --------------------------------------------------------------------------------- - -The default TLS provider has been reverted to 'libressl'. System update will -replace bearssl dependencies with libressl. You may choose to keep or remove -bearssl after the update. - -Jul 27 2020 --------------------------------------------------------------------------------- - -Carbs Linux's fork of the `kiss` package manager has been renamed to -`Carbs Packaging Tools` due to huge amount of changes. Your latest `kiss` -update will handle the bootstrapping. You will need to rename your `KISS-*` -variables to `CPT-*` - -Jun 17 2020 --------------------------------------------------------------------------------- - -A new rootfs tarball including the changes to the core is released and can be -found on the downloads page. - -May 26 2020 --------------------------------------------------------------------------------- - -An initial version for binary package management is released. -It can be found on the [GitHub page]. - -[GitHub page]: https://github.com/CarbsLinux/kiss-bin - -May 19 2020 --------------------------------------------------------------------------------- - -A rootfs tarball targeting the i686 architecture has -been released. It can be found on the [downloads page] - -[downloads page]: https://dl.carbslinux.org/releases/i686 - -May 10 2020 --------------------------------------------------------------------------------- - -A GCC 10.1.0 change causes a kernel panic for kernels built -with GCC 10.1. This issue can be resolved by applying this -[patch] to your kernel sources. - -[patch]: https://git.kernel.org/pub/scm/linux/kernel/git/tip/tip.git/patch/?id=f670269a42bfdd2c83a1118cc3d1b475547eac22 - -Apr 27 2020 --------------------------------------------------------------------------------- - -A new rootfs tarball has been released! You can -see it on <https://dl.carbslinux.org/releases>! - -**EDIT:** A new bug fix release has been made. - -Apr 10 2020 --------------------------------------------------------------------------------- - -IRC channel can now be accessed from `#carbslinux` at freenode! - -Apr 06 2020 --------------------------------------------------------------------------------- - -A new rootfs tarball has been released. See the -[downloads](https://dl.carbslinux.org) page - -Apr 05 2020 --------------------------------------------------------------------------------- - -Carbs Linux repositories will be hosted only on Github. Commits will be -pushed there, and not the repository. You have until -May 4, 2020 Monday to switch your remotes to <https://github.com/CarbsLinux/repository>. -The git repository will continue to be served until then (without additional -commits). - -You can switch your remote by executing the following command on your -repository directory. - - git remote set-url origin https://github.com/CarbsLinux/repository - - -Feb 18 2020 --------------------------------------------------------------------------------- - -A new tarball is released. It can be found on <https://dl.carbslinux.org>. - -**edit:** I have removed the tarball because of a bootstrapping issue. -I will be re-adding it later today. - -**edit 2:** I have added a tarball (20200219) to reflect my recent -changes on Busybox. - - -Feb 14 2020 --------------------------------------------------------------------------------- - -**IMPORTANT!** Carbs-init update to be released on 17th of February -will require manual intervention. I am holding this update back so -people can see it before they update their system (even though the -update will show the same message as this). The rationale for the -update is explained below the intervention. - - # There is an explanation for each init - # You only need to follow the instructions - # for your own init-system - - ## busybox-init - # If you did not edit your inittab simply - # move inittab.new to inittab - -> mv /etc/inittab.new /etc/inittab - - # If you did edit your inittab you can use - # a simple sed command to remove the necessary lines - -> sed -i '/getty/d;/runsvdir/d' /etc/inittab - - - ## runit - # same as busybox-init, if you did not edit - # /etc/runit/2 move 2.new to 2 - -> mv /etc/runit/2.new /etc/runit/2 - - # else - -> vim /etc/runit/2 - # open your 2 file and remove the for loop containing - # getty commands. If you are using runit, it is recommended - # to comment out /etc/init/runit.boot - - ## sinit/minit - # If you did not edit your {sinit-,}launch-services.boot - # you can simply remove it. - -> rm -f /etc/init/launch-services.boot /etc/init/sinit-launch-services.boot - - # This should leave you without any issues, and you can safely reboot. - -Carbs-init update is to make sure init systems do not clash, and do -not have to use different files. This is a sensible update both for -the user user and for the maintainer side. - -To give an example, before this update busybox-init was managing getty -through `inittab`, runit was managing through `/etc/runit/2`, and -minit/sinit were launching from `/etc/init/launch-services.boot`. This -is a configuration nightmare for everyone, and since I am maintaining -and constantly testing those init providers, a huge nightmare for me. -This is a Quality of Life update. - - -Feb 13 2020 --------------------------------------------------------------------------------- - -Runit is now released on the core repository! You can now replace -busybox-init with runit-init. You can also replace the busybox runit -utilities with the actual runit. This will reduce the dependency on -busybox greatly. - -Jan 28 2020 --------------------------------------------------------------------------------- - -Web Server is now on a Carbs Linux server. It is not complete yet, -but I will be adding a little more for the intended functionality. -Downtimes can be expected. - -UPDATE: ssl is now working. - -UPDATE2: downloads are back again. - - -Jan 22 2020 --------------------------------------------------------------------------------- - -Expect downtime on Jan 24 2020 22:00 UTC as I will be migrating -this web server to my Carbs Linux server! - - -Jan 15 2020 --------------------------------------------------------------------------------- - -sinit has been taken to `core`, and is now officially supported - - -Jan 13 2020 --------------------------------------------------------------------------------- - -**Busybox update reqires manual intervention** - -The new busybox package conflicts with the pre-update busybox-init. That's why -you should rebuild and install `busybox-init` before doing the update. - - # Do a kiss update first (but don't actually update it yet), or manually pull the git repository - $ kiss u # Cancel this operation after it asks for you to confirm the update - - # Install the busybox-init package - $ kiss b busybox-init && kiss i busybox-init - - # Continue your update as you normally would. - $ kiss u - -I have moved runit and logging utilities from the busybox-init package to the busybox -package, which is the cause of these conflicts. - -Jan 10 2020 --------------------------------------------------------------------------------- - -carbs-rootfs-20200110.tar.xz was [released](//dl.carbslinux.org/releases) - - -Jan 09 2020 --------------------------------------------------------------------------------- - -Happy new year, everyone! I am back after some long silence. I was unable to commit for a -while, but I have pulled some new updates from the KISS repository, added some of my own. -This week I will be changing/adding some things. - -Important things are, - -* Carbs-init was updated to 0.3. -* I will be adding an implementation of suckless.org's [sinit](//core.suckless.org/sinit) as `carbs-sinit` -* Carbs Repository was added to [repology.org](//repology.org/repository/carbs) -* A new rootfs tarball will be coming up tomorrow. - - -Dec 18 2019 --------------------------------------------------------------------------------- - -carbs-rootfs-20191218.tar.xz was [released](//dl.carbslinux.org/releases) - - -Dec 17 2019 --------------------------------------------------------------------------------- - -Installation instruction are now complete. A review would be greatly appreciated! - - -Dec 15 2019 --------------------------------------------------------------------------------- - -Carbs Linux Wiki is now available to be edited and updated by the users go -to the [wiki](//carbslinux.org/wiki) to obtain more information. - -**February 2020 EDIT:** Changed link for wiki - - -Dec 12 2019 --------------------------------------------------------------------------------- - -Busybox and Busybox-init has been seperated into two different packages. -This is for adding standalone runit/runit-init to the repositories. - - -Dec 10 2019 --------------------------------------------------------------------------------- - -First alpha release was made. See the [downloads page](//dl.carbslinux.org/releases). - diff --git a/docs/news.xml b/docs/news.xml index 0db7bba..b27bdf9 100644 --- a/docs/news.xml +++ b/docs/news.xml @@ -1,360 +1,278 @@ -<?xml version="1.0" encoding="UTF-8"?> +<?xml version="1.0" encoding="utf-8"?> <rss version="2.0" - xmlns:atom="http://www.w3.org/2005/Atom" - xmlns:dc="http://purl.org/dc/elements/1.1/" - xmlns:sy="http://purl.org/rss/1.0/modules/syndication/" -> - <channel> - <title>Carbs Linux</title> - <description>a simple linux distribution</description> - <link>https://carbslinux.org</link> - <atom:link href="https://carbslinux.org/news.xml" rel="self" type="application/rss+xml" /> - <lastBuildDate>Thu Jan 07 2021 11:00</lastBuildDate> -<item> -<title>Sep 16 2020</title> -<pubDate>Wed, 16 Sep 2020</pubDate> -<dc:creator>Cem Keylan</dc:creator> -<link>https://carbslinux.org/index.html</link> -<description><h2>Sep 16 2020</h2> - -<p>The libressl &ldquo;revert&rdquo; was reverted. System update will replace libressl -dependencies with bearssl. You may choose to keep or remove bearssl after the -update.</p></description> -</item> -<item> -<title>Sep 03 2020</title> -<pubDate>Thu, 03 Sep 2020</pubDate> -<dc:creator>Cem Keylan</dc:creator> -<link>https://carbslinux.org/index.html</link> -<description><h2>Sep 03 2020</h2> - -<p>The default TLS provider has been reverted to &lsquo;libressl&rsquo;. System update will -replace bearssl dependencies with libressl. You may choose to keep or remove -bearssl after the update.</p></description> -</item> -<item> -<title>Jul 27 2020</title> -<pubDate>Mon, 27 Jul 2020</pubDate> -<dc:creator>Cem Keylan</dc:creator> -<link>https://carbslinux.org/index.html</link> -<description><h2>Jul 27 2020</h2> - -<p>Carbs Linux&rsquo;s fork of the <code>kiss</code> package manager has been renamed to -<code>Carbs Packaging Tools</code> due to huge amount of changes. Your latest <code>kiss</code> -update will handle the bootstrapping. You will need to rename your <code>KISS-*</code> -variables to <code>CPT-*</code></p></description> -</item> -<item> -<title>Jun 17 2020</title> -<pubDate>Wed, 17 Jun 2020</pubDate> -<dc:creator>Cem Keylan</dc:creator> -<link>https://carbslinux.org/index.html</link> -<description><h2>Jun 17 2020</h2> - -<p>A new rootfs tarball including the changes to the core is released and can be -found on the downloads page.</p></description> -</item> -<item> -<title>May 26 2020</title> -<pubDate>Tue, 26 May 2020</pubDate> -<dc:creator>Cem Keylan</dc:creator> -<link>https://carbslinux.org/index.html</link> -<description><h2>May 26 2020</h2> - -<p>An initial version for binary package management is released. -It can be found on the <a href="https://github.com/CarbsLinux/kiss-bin">GitHub page</a>.</p></description> -</item> -<item> -<title>May 19 2020</title> -<pubDate>Tue, 19 May 2020</pubDate> -<dc:creator>Cem Keylan</dc:creator> -<link>https://carbslinux.org/index.html</link> -<description><h2>May 19 2020</h2> - -<p>A rootfs tarball targeting the i686 architecture has -been released. It can be found on the <a href="https://dl.carbslinux.org/releases/i686">downloads page</a></p></description> -</item> -<item> -<title>May 10 2020</title> -<pubDate>Sun, 10 May 2020</pubDate> -<dc:creator>Cem Keylan</dc:creator> -<link>https://carbslinux.org/index.html</link> -<description><h2>May 10 2020</h2> - -<p>A GCC 10.1.0 change causes a kernel panic for kernels built -with GCC 10.1. This issue can be resolved by applying this -<a href="https://git.kernel.org/pub/scm/linux/kernel/git/tip/tip.git/patch/?id=f670269a42bfdd2c83a1118cc3d1b475547eac22">patch</a> to your kernel sources.</p></description> -</item> -<item> -<title>Apr 27 2020</title> -<pubDate>Mon, 27 Apr 2020</pubDate> -<dc:creator>Cem Keylan</dc:creator> -<link>https://carbslinux.org/index.html</link> -<description><h2>Apr 27 2020</h2> - -<p>A new rootfs tarball has been released! You can -see it on <a href="https://dl.carbslinux.org/releases">https://dl.carbslinux.org/releases</a>!</p> - -<p><strong>EDIT:</strong> A new bug fix release has been made.</p></description> -</item> -<item> -<title>Apr 10 2020</title> -<pubDate>Fri, 10 Apr 2020</pubDate> -<dc:creator>Cem Keylan</dc:creator> -<link>https://carbslinux.org/index.html</link> -<description><h2>Apr 10 2020</h2> - -<p>IRC channel can now be accessed from <code>#carbslinux</code> at freenode!</p></description> -</item> -<item> -<title>Apr 06 2020</title> -<pubDate>Mon, 06 Apr 2020</pubDate> -<dc:creator>Cem Keylan</dc:creator> -<link>https://carbslinux.org/index.html</link> -<description><h2>Apr 06 2020</h2> - -<p>A new rootfs tarball has been released. See the -<a href="https://dl.carbslinux.org">downloads</a> page</p></description> -</item> -<item> -<title>Apr 05 2020</title> -<pubDate>Sun, 05 Apr 2020</pubDate> -<dc:creator>Cem Keylan</dc:creator> -<link>https://carbslinux.org/index.html</link> -<description><h2>Apr 05 2020</h2> - -<p>Carbs Linux repositories will be hosted only on Github. Commits will be -pushed there, and not the repository. You have until -May 4, 2020 Monday to switch your remotes to <a href="https://github.com/CarbsLinux/repository">https://github.com/CarbsLinux/repository</a>. -The git repository will continue to be served until then (without additional -commits).</p> - -<p>You can switch your remote by executing the following command on your -repository directory.</p> - -<pre><code>git remote set-url origin https://github.com/CarbsLinux/repository -</code></pre></description> -</item> -<item> -<title>Feb 18 2020</title> -<pubDate>Tue, 18 Feb 2020</pubDate> -<dc:creator>Cem Keylan</dc:creator> -<link>https://carbslinux.org/index.html</link> -<description><h2>Feb 18 2020</h2> - -<p>A new tarball is released. It can be found on <a href="https://dl.carbslinux.org">https://dl.carbslinux.org</a>.</p> - -<p><strong>edit:</strong> I have removed the tarball because of a bootstrapping issue. -I will be re-adding it later today.</p> - -<p><strong>edit 2:</strong> I have added a tarball (20200219) to reflect my recent -changes on Busybox.</p></description> -</item> -<item> -<title>Feb 14 2020</title> -<pubDate>Fri, 14 Feb 2020</pubDate> -<dc:creator>Cem Keylan</dc:creator> -<link>https://carbslinux.org/index.html</link> -<description><h2>Feb 14 2020</h2> - -<p><strong>IMPORTANT!</strong> Carbs-init update to be released on 17th of February -will require manual intervention. I am holding this update back so -people can see it before they update their system (even though the -update will show the same message as this). The rationale for the -update is explained below the intervention.</p> - -<pre><code># There is an explanation for each init -# You only need to follow the instructions -# for your own init-system - -## busybox-init -# If you did not edit your inittab simply -# move inittab.new to inittab --&gt; mv /etc/inittab.new /etc/inittab - -# If you did edit your inittab you can use -# a simple sed command to remove the necessary lines --&gt; sed -i '/getty/d;/runsvdir/d' /etc/inittab - - -## runit -# same as busybox-init, if you did not edit -# /etc/runit/2 move 2.new to 2 --&gt; mv /etc/runit/2.new /etc/runit/2 - -# else --&gt; vim /etc/runit/2 -# open your 2 file and remove the for loop containing -# getty commands. If you are using runit, it is recommended -# to comment out /etc/init/runit.boot - -## sinit/minit -# If you did not edit your {sinit-,}launch-services.boot -# you can simply remove it. --&gt; rm -f /etc/init/launch-services.boot /etc/init/sinit-launch-services.boot - -# This should leave you without any issues, and you can safely reboot. -</code></pre> - -<p>Carbs-init update is to make sure init systems do not clash, and do -not have to use different files. This is a sensible update both for -the user user and for the maintainer side.</p> - -<p>To give an example, before this update busybox-init was managing getty -through <code>inittab</code>, runit was managing through <code>/etc/runit/2</code>, and -minit/sinit were launching from <code>/etc/init/launch-services.boot</code>. This -is a configuration nightmare for everyone, and since I am maintaining -and constantly testing those init providers, a huge nightmare for me. -This is a Quality of Life update.</p></description> -</item> -<item> -<title>Feb 13 2020</title> -<pubDate>Thu, 13 Feb 2020</pubDate> -<dc:creator>Cem Keylan</dc:creator> -<link>https://carbslinux.org/index.html</link> -<description><h2>Feb 13 2020</h2> - -<p>Runit is now released on the core repository! You can now replace -busybox-init with runit-init. You can also replace the busybox runit -utilities with the actual runit. This will reduce the dependency on -busybox greatly.</p></description> -</item> -<item> -<title>Jan 28 2020</title> -<pubDate>Tue, 28 Jan 2020</pubDate> -<dc:creator>Cem Keylan</dc:creator> -<link>https://carbslinux.org/index.html</link> -<description><h2>Jan 28 2020</h2> - -<p>Web Server is now on a Carbs Linux server. It is not complete yet, -but I will be adding a little more for the intended functionality. -Downtimes can be expected.</p> - -<p>UPDATE: ssl is now working.</p> - -<p>UPDATE2: downloads are back again.</p></description> -</item> -<item> -<title>Jan 22 2020</title> -<pubDate>Wed, 22 Jan 2020</pubDate> -<dc:creator>Cem Keylan</dc:creator> -<link>https://carbslinux.org/index.html</link> -<description><h2>Jan 22 2020</h2> - -<p>Expect downtime on Jan 24 2020 22:00 UTC as I will be migrating -this web server to my Carbs Linux server!</p></description> -</item> -<item> -<title>Jan 15 2020</title> -<pubDate>Wed, 15 Jan 2020</pubDate> -<dc:creator>Cem Keylan</dc:creator> -<link>https://carbslinux.org/index.html</link> -<description><h2>Jan 15 2020</h2> - -<p>sinit has been taken to <code>core</code>, and is now officially supported</p></description> -</item> -<item> -<title>Jan 13 2020</title> -<pubDate>Mon, 13 Jan 2020</pubDate> -<dc:creator>Cem Keylan</dc:creator> -<link>https://carbslinux.org/index.html</link> -<description><h2>Jan 13 2020</h2> - -<p><strong>Busybox update reqires manual intervention</strong></p> - -<p>The new busybox package conflicts with the pre-update busybox-init. That&rsquo;s why -you should rebuild and install <code>busybox-init</code> before doing the update.</p> - -<pre><code># Do a kiss update first (but don't actually update it yet), or manually pull the git repository -$ kiss u # Cancel this operation after it asks for you to confirm the update - -# Install the busybox-init package -$ kiss b busybox-init &amp;&amp; kiss i busybox-init - -# Continue your update as you normally would. -$ kiss u -</code></pre> - -<p>I have moved runit and logging utilities from the busybox-init package to the busybox -package, which is the cause of these conflicts.</p></description> -</item> -<item> -<title>Jan 10 2020</title> -<pubDate>Fri, 10 Jan 2020</pubDate> -<dc:creator>Cem Keylan</dc:creator> -<link>https://carbslinux.org/index.html</link> -<description><h2>Jan 10 2020</h2> - -<p>carbs-rootfs-20200110.tar.xz was <a href="//dl.carbslinux.org/releases">released</a></p></description> -</item> -<item> -<title>Jan 09 2020</title> -<pubDate>Thu, 09 Jan 2020</pubDate> -<dc:creator>Cem Keylan</dc:creator> -<link>https://carbslinux.org/index.html</link> -<description><h2>Jan 09 2020</h2> - -<p>Happy new year, everyone! I am back after some long silence. I was unable to commit for a -while, but I have pulled some new updates from the KISS repository, added some of my own. -This week I will be changing/adding some things.</p> - -<p>Important things are,</p> - -<ul> -<li>Carbs-init was updated to 0.3.</li> -<li>I will be adding an implementation of suckless.org&rsquo;s <a href="//core.suckless.org/sinit">sinit</a> as <code>carbs-sinit</code></li> -<li>Carbs Repository was added to <a href="//repology.org/repository/carbs">repology.org</a></li> -<li>A new rootfs tarball will be coming up tomorrow.</li> -</ul></description> -</item> -<item> -<title>Dec 18 2019</title> -<pubDate>Wed, 18 Dec 2019</pubDate> -<dc:creator>Cem Keylan</dc:creator> -<link>https://carbslinux.org/index.html</link> -<description><h2>Dec 18 2019</h2> - -<p>carbs-rootfs-20191218.tar.xz was <a href="//dl.carbslinux.org/releases">released</a></p></description> -</item> -<item> -<title>Dec 17 2019</title> -<pubDate>Tue, 17 Dec 2019</pubDate> -<dc:creator>Cem Keylan</dc:creator> -<link>https://carbslinux.org/index.html</link> -<description><h2>Dec 17 2019</h2> - -<p>Installation instruction are now complete. A review would be greatly appreciated!</p></description> -</item> -<item> -<title>Dec 15 2019</title> -<pubDate>Sun, 15 Dec 2019</pubDate> -<dc:creator>Cem Keylan</dc:creator> -<link>https://carbslinux.org/index.html</link> -<description><h2>Dec 15 2019</h2> - -<p>Carbs Linux Wiki is now available to be edited and updated by the users go -to the <a href="//carbslinux.org/wiki">wiki</a> to obtain more information.</p> - -<p><strong>February 2020 EDIT:</strong> Changed link for wiki</p></description> -</item> -<item> -<title>Dec 12 2019</title> -<pubDate>Thu, 12 Dec 2019</pubDate> -<dc:creator>Cem Keylan</dc:creator> -<link>https://carbslinux.org/index.html</link> -<description><h2>Dec 12 2019</h2> - -<p>Busybox and Busybox-init has been seperated into two different packages. -This is for adding standalone runit/runit-init to the repositories.</p></description> -</item> -<item> -<title>Dec 10 2019</title> -<pubDate>Tue, 10 Dec 2019</pubDate> -<dc:creator>Cem Keylan</dc:creator> -<link>https://carbslinux.org/index.html</link> -<description><h2>Dec 10 2019</h2> - -<p>First alpha release was made. See the <a href="//dl.carbslinux.org/releases">downloads page</a>.</p></description> -</item> - </channel> + xmlns:content="http://purl.org/rss/1.0/modules/content/" + xmlns:wfw="http://wellformedweb.org/CommentAPI/" + xmlns:dc="http://purl.org/dc/elements/1.1/" + xmlns:atom="http://www.w3.org/2005/Atom" + xmlns:sy="http://purl.org/rss/1.0/modules/syndication/" + xmlns:slash="http://purl.org/rss/1.0/modules/slash/" + xmlns:georss="http://www.georss.org/georss" + xmlns:geo="http://www.w3.org/2003/01/geo/wgs84_pos#" + xmlns:media="http://search.yahoo.com/mrss/"><channel> + <title>Carbs Linux news</title> + <atom:link href="https://carbslinux.org/news/news.xml" rel="self" type="application/rss+xml" /> + <link>https://carbslinux.org/news</link> + <description><![CDATA[a simple Linux distribution]]></description> + <language>en</language> + <pubDate>Tue, 02 Feb 2021 03:33:00 +0300</pubDate> + <lastBuildDate>Tue, 02 Feb 2021 03:33:00 +0300</lastBuildDate> + <generator>Emacs 27.1 Org-mode 9.4.4</generator> + <webMaster>root@carbslinux.org (Cem Keylan)</webMaster> + <image> + <url>https://orgmode.org/img/org-mode-unicorn-logo.png</url> + <title>Carbs Linux news</title> + <link>https://carbslinux.org/news</link> + </image> + + + <item> + <title></title> + <link>https://carbslinux.org/news/20200916.html</link> + <author>root@carbslinux.org (Cem Keylan)</author> + <guid isPermaLink="false">https://carbslinux.org/news/20200916.html</guid> + <pubDate>Wed, 16 Sep 2020 00:00:00 +0300</pubDate> + + <description><![CDATA[<p> + The libressl "revert" was reverted. System update will replace libressl + dependencies with bearssl. You may choose to keep or remove bearssl after the + update. + </p> + ]]></description> + </item> + <item> + <title></title> + <link>https://carbslinux.org/news/20200903.html</link> + <author>root@carbslinux.org (Cem Keylan)</author> + <guid isPermaLink="false">https://carbslinux.org/news/20200903.html</guid> + <pubDate>Thu, 03 Sep 2020 00:00:00 +0300</pubDate> + + <description><![CDATA[<p> + The default TLS provider has been reverted to <code>libressl</code>. System update will + replace bearssl dependencies with libressl. You may choose to keep or remove + bearssl after the update. + </p> + ]]></description> + </item> + <item> + <title></title> + <link>https://carbslinux.org/news/20200727.html</link> + <author>root@carbslinux.org (Cem Keylan)</author> + <guid isPermaLink="false">https://carbslinux.org/news/20200727.html</guid> + <pubDate>Mon, 27 Jul 2020 00:00:00 +0300</pubDate> + + <description><![CDATA[<p> + Carbs Linux's fork of the <code>kiss</code> package manager has been renamed to <code>Carbs + Packaging Tools</code> due to huge amount of changes. Your latest <code>kiss</code> update will + handle the bootstrapping. You will need to rename your <code>KISS-*</code> variables to + <code>CPT-*</code>. + </p> + ]]></description> + </item> + <item> + <title></title> + <link>https://carbslinux.org/news/20200617.html</link> + <author>root@carbslinux.org (Cem Keylan)</author> + <guid isPermaLink="false">https://carbslinux.org/news/20200617.html</guid> + <pubDate>Wed, 17 Jun 2020 00:00:00 +0300</pubDate> + + <description><![CDATA[<p> + A new rootfs tarball including the changes to the core is released and can be + found on the downloads page. + </p> + ]]></description> + </item> + <item> + <title></title> + <link>https://carbslinux.org/news/20200526.html</link> + <author>root@carbslinux.org (Cem Keylan)</author> + <guid isPermaLink="false">https://carbslinux.org/news/20200526.html</guid> + <pubDate>Tue, 26 May 2020 00:00:00 +0300</pubDate> + + <description><![CDATA[<p> + An initial version for binary package management is released. It can be found on + the <a href="https://github.com/CarbsLinux/kiss-bin">GitHub page</a>. + </p> + ]]></description> + </item> + <item> + <title></title> + <link>https://carbslinux.org/news/20200519.html</link> + <author>root@carbslinux.org (Cem Keylan)</author> + <guid isPermaLink="false">https://carbslinux.org/news/20200519.html</guid> + <pubDate>Tue, 19 May 2020 00:00:00 +0300</pubDate> + + <description><![CDATA[<p> + A rootfs tarball targeting the i686 architecture has been released. It can be + found on the downloads page. + </p> + ]]></description> + </item> + <item> + <title></title> + <link>https://carbslinux.org/news/20200510.html</link> + <author>root@carbslinux.org (Cem Keylan)</author> + <guid isPermaLink="false">https://carbslinux.org/news/20200510.html</guid> + <pubDate>Sun, 10 May 2020 00:00:00 +0300</pubDate> + + <description><![CDATA[<p> + A GCC 10.1.0 change causes a kernel panic for kernels built with GCC 10.1. This + issue can be resolved by applying this <a href="https://git.kernel.org/pub/scm/linux/kernel/git/tip/tip.git/patch/?id=f670269a42bfdd2c83a1118cc3d1b475547eac22">patch</a> to your kernel sources. + </p> + + <p> + <b><b>EDIT:</b></b> The patch is no longer necessary. + </p> + ]]></description> + </item> + <item> + <title></title> + <link>https://carbslinux.org/news/20200427.html</link> + <author>root@carbslinux.org (Cem Keylan)</author> + <guid isPermaLink="false">https://carbslinux.org/news/20200427.html</guid> + <pubDate>Mon, 27 Apr 2020 00:00:00 +0300</pubDate> + + <description><![CDATA[<p> + A new rootfs tarball has been released! You can see it on + <a href="https://dl.carbslinux.org/releases">https://dl.carbslinux.org/releases</a>! + </p> + + <p> + <b><b>EDIT:</b></b> A new bug fix release has been made. + </p> + ]]></description> + </item> + <item> + <title></title> + <link>https://carbslinux.org/news/20200410.html</link> + <author>root@carbslinux.org (Cem Keylan)</author> + <guid isPermaLink="false">https://carbslinux.org/news/20200410.html</guid> + <pubDate>Fri, 10 Apr 2020 00:00:00 +0300</pubDate> + + <description><![CDATA[<p> + IRC channel can now be accessed from <code>#carbslinux</code> at freenode! + </p> + ]]></description> + </item> + <item> + <title></title> + <link>https://carbslinux.org/news/20200406.html</link> + <author>root@carbslinux.org (Cem Keylan)</author> + <guid isPermaLink="false">https://carbslinux.org/news/20200406.html</guid> + <pubDate>Mon, 06 Apr 2020 00:00:00 +0300</pubDate> + + <description><![CDATA[<p> + A new rootfs tarball has been released. See the downloads page. + </p> + ]]></description> + </item> + <item> + <title></title> + <link>https://carbslinux.org/news/20200405.html</link> + <author>root@carbslinux.org (Cem Keylan)</author> + <guid isPermaLink="false">https://carbslinux.org/news/20200405.html</guid> + <pubDate>Sun, 05 Apr 2020 00:00:00 +0300</pubDate> + + <description><![CDATA[<p> + Carbs Linux repositories will be hosted only on Github. Commits will be pushed + there, and not the repository. You have until May 4, 2020 Monday to switch your + remotes to <a href="https://github.com/CarbsLinux/repository">https://github.com/CarbsLinux/repository</a>. The git repository will + continue to be served until then (without additional commits). + </p> + + <p> + You can switch your remote by executing the following command on your repository + directory. + </p> + + <div class="org-src-container"> + <pre class="src src-sh">git remote set-url origin https://github.com/CarbsLinux/repository + </pre> + </div> + ]]></description> + </item> + <item> + <title></title> + <link>https://carbslinux.org/news/20200218.html</link> + <author>root@carbslinux.org (Cem Keylan)</author> + <guid isPermaLink="false">https://carbslinux.org/news/20200218.html</guid> + <pubDate>Tue, 18 Feb 2020 00:00:00 +0300</pubDate> + + <description><![CDATA[<p> + A new tarball is released. It can be found on <a href="https://dl.carbslinux.org">https://dl.carbslinux.org</a>. + </p> + + <p> + <b><b>edit:</b></b> I have removed the tarball because of a bootstrapping issue. I will be + re-adding it later today. + </p> + + <p> + <b><b>edit 2:</b></b> I have added a tarball (20200219) to reflect my recent changes on + Busybox. + </p> + ]]></description> + </item> + <item> + <title></title> + <link>https://carbslinux.org/news/20200214.html</link> + <author>root@carbslinux.org (Cem Keylan)</author> + <guid isPermaLink="false">https://carbslinux.org/news/20200214.html</guid> + <pubDate>Fri, 14 Feb 2020 00:00:00 +0300</pubDate> + + <description><![CDATA[<p> + <b><b>IMPORTANT!</b></b> Carbs-init update to be released on 17th of February + will require manual intervention. I am holding this update back so + people can see it before they update their system (even though the + update will show the same message as this). The rationale for the + update is explained below the intervention. + </p> + + <div class="org-src-container"> + <pre class="src src-sh"><span class="org-comment-delimiter"># </span><span class="org-comment">There is an explanation for each init You only need to follow the instructions</span> + <span class="org-comment-delimiter"># </span><span class="org-comment">for your own init-system</span> + + <span class="org-comment-delimiter">## </span><span class="org-comment">busybox-init</span> + <span class="org-comment-delimiter"># </span><span class="org-comment">If you did not edit your inittab simply move inittab.new to inittab</span> + mv /etc/inittab.new /etc/inittab + + <span class="org-comment-delimiter"># </span><span class="org-comment">If you did edit your inittab you can use a simple sed command to remove the</span> + <span class="org-comment-delimiter"># </span><span class="org-comment">necessary lines</span> + sed -i <span class="org-string">'/getty/d;/runsvdir/d'</span> /etc/inittab + + + <span class="org-comment-delimiter">## </span><span class="org-comment">runit</span> + <span class="org-comment-delimiter"># </span><span class="org-comment">same as busybox-init, if you did not edit /etc/runit/2 move 2.new to 2</span> + mv /etc/runit/2.new /etc/runit/2 + + <span class="org-comment-delimiter"># </span><span class="org-comment">else</span> + vim /etc/runit/2 + <span class="org-comment-delimiter"># </span><span class="org-comment">open your 2 file and remove the for loop containing getty commands. If you are</span> + <span class="org-comment-delimiter"># </span><span class="org-comment">using runit, it is recommended to comment out /etc/init/runit.boot</span> + + <span class="org-comment-delimiter">## </span><span class="org-comment">sinit/minit</span> + <span class="org-comment-delimiter"># </span><span class="org-comment">If you did not edit your {sinit-,}launch-services.boot you can simply remove</span> + <span class="org-comment-delimiter"># </span><span class="org-comment">it.</span> + rm -f /etc/init/launch-services.boot /etc/init/sinit-launch-services.boot + + <span class="org-comment-delimiter"># </span><span class="org-comment">This should leave you without any issues, and you can safely reboot.</span> + </pre> + </div> + + <p> + Carbs-init update is to make sure init systems do not clash, and do + not have to use different files. This is a sensible update both for + the user user and for the maintainer side. + </p> + + <p> + To give an example, before this update busybox-init was managing getty + through <code>inittab</code>, runit was managing through <code>/etc/runit/2</code>, and + minit/sinit were launching from <code>/etc/init/launch-services.boot</code>. This + is a configuration nightmare for everyone, and since I am maintaining + and constantly testing those init providers, a huge nightmare for me. + This is a Quality of Life update. + </p> + ]]></description> + </item> +</channel> </rss> diff --git a/docs/news/20191210.html b/docs/news/20191210.html new file mode 100644 index 0000000..e94cba1 --- /dev/null +++ b/docs/news/20191210.html @@ -0,0 +1,42 @@ +<!DOCTYPE html> +<html lang="en"> +<head> +<!-- 2021-02-02 --> +<meta charset="utf-8"> +<meta name="viewport" content="width=device-width, initial-scale=1"> +<title>Dec 10, 2019</title> +<meta name="generator" content="Org mode"> +<link rel="stylesheet" type="text/css" href="/style.css"> +</head> +<body> +<div id="preamble" class="status"> +<nav id="navbar"> + <a href="/" class=navbartitle>Carbs Linux</a> + + <label for="hamburger">☰</label> + <input type="checkbox" id="hamburger" /> + <ul id=navbarlist> + <li><a href="/" title="Home Page">Home</a></li> + <li><a href="//git.carbslinux.org" title="Git Repository">Git</a></li> + <li><a href="/download.html" title="Download Carbs Linux">Download</a></li> + <li><a href="/blog" title="Blog Posts">Blog</a></li> + <li><a href="/install.html" title="Installation Instructions">Installation</a></li> + <li><a href="/docs.html" title="Documentation">Docs</a></li> + </ul> +</nav> +</div> +<div id="content"> +<header> +<h1 class="title">Dec 10, 2019</h1> +</header><p> +First alpha release was made. See the <a href="https://dl.carbslinux.org/releases">downloads page</a>. +</p> +</div> +<div id="postamble" class="status"> +<footer> + <p>Linux® is a registered trademark of Linus Torvalds</p> + <p>Copyright © 2019-2021 Cem Keylan</p> +</footer> +</div> +</body> +</html> diff --git a/docs/news/20191210.txt b/docs/news/20191210.txt new file mode 100644 index 0000000..379c42b --- /dev/null +++ b/docs/news/20191210.txt @@ -0,0 +1,13 @@ + ______________ + + DEC 10, 2019 + ______________ + + + <2019-12-10 Tue> + + +First alpha release was made. See the [downloads page]. + + +[downloads page] <https://dl.carbslinux.org/releases> diff --git a/docs/news/20191212.html b/docs/news/20191212.html new file mode 100644 index 0000000..81ec884 --- /dev/null +++ b/docs/news/20191212.html @@ -0,0 +1,43 @@ +<!DOCTYPE html> +<html lang="en"> +<head> +<!-- 2021-02-02 --> +<meta charset="utf-8"> +<meta name="viewport" content="width=device-width, initial-scale=1"> +<title>Dec 12, 2019</title> +<meta name="generator" content="Org mode"> +<link rel="stylesheet" type="text/css" href="/style.css"> +</head> +<body> +<div id="preamble" class="status"> +<nav id="navbar"> + <a href="/" class=navbartitle>Carbs Linux</a> + + <label for="hamburger">☰</label> + <input type="checkbox" id="hamburger" /> + <ul id=navbarlist> + <li><a href="/" title="Home Page">Home</a></li> + <li><a href="//git.carbslinux.org" title="Git Repository">Git</a></li> + <li><a href="/download.html" title="Download Carbs Linux">Download</a></li> + <li><a href="/blog" title="Blog Posts">Blog</a></li> + <li><a href="/install.html" title="Installation Instructions">Installation</a></li> + <li><a href="/docs.html" title="Documentation">Docs</a></li> + </ul> +</nav> +</div> +<div id="content"> +<header> +<h1 class="title">Dec 12, 2019</h1> +</header><p> +Busybox and Busybox-init has been seperated into two different packages. +This is for adding standalone runit/runit-init to the repositories. +</p> +</div> +<div id="postamble" class="status"> +<footer> + <p>Linux® is a registered trademark of Linus Torvalds</p> + <p>Copyright © 2019-2021 Cem Keylan</p> +</footer> +</div> +</body> +</html> diff --git a/docs/news/20191212.txt b/docs/news/20191212.txt new file mode 100644 index 0000000..c07ad48 --- /dev/null +++ b/docs/news/20191212.txt @@ -0,0 +1,11 @@ + ______________ + + DEC 12, 2019 + ______________ + + + <2019-12-12 Thu> + + +Busybox and Busybox-init has been seperated into two different packages. +This is for adding standalone runit/runit-init to the repositories. diff --git a/docs/news/20191217.html b/docs/news/20191217.html new file mode 100644 index 0000000..a194962 --- /dev/null +++ b/docs/news/20191217.html @@ -0,0 +1,42 @@ +<!DOCTYPE html> +<html lang="en"> +<head> +<!-- 2021-02-02 --> +<meta charset="utf-8"> +<meta name="viewport" content="width=device-width, initial-scale=1"> +<title>Dec 17, 2019</title> +<meta name="generator" content="Org mode"> +<link rel="stylesheet" type="text/css" href="/style.css"> +</head> +<body> +<div id="preamble" class="status"> +<nav id="navbar"> + <a href="/" class=navbartitle>Carbs Linux</a> + + <label for="hamburger">☰</label> + <input type="checkbox" id="hamburger" /> + <ul id=navbarlist> + <li><a href="/" title="Home Page">Home</a></li> + <li><a href="//git.carbslinux.org" title="Git Repository">Git</a></li> + <li><a href="/download.html" title="Download Carbs Linux">Download</a></li> + <li><a href="/blog" title="Blog Posts">Blog</a></li> + <li><a href="/install.html" title="Installation Instructions">Installation</a></li> + <li><a href="/docs.html" title="Documentation">Docs</a></li> + </ul> +</nav> +</div> +<div id="content"> +<header> +<h1 class="title">Dec 17, 2019</h1> +</header><p> +Installation instruction are now complete. A review would be greatly appreciated! +</p> +</div> +<div id="postamble" class="status"> +<footer> + <p>Linux® is a registered trademark of Linus Torvalds</p> + <p>Copyright © 2019-2021 Cem Keylan</p> +</footer> +</div> +</body> +</html> diff --git a/docs/news/20191217.txt b/docs/news/20191217.txt new file mode 100644 index 0000000..f12e258 --- /dev/null +++ b/docs/news/20191217.txt @@ -0,0 +1,11 @@ + ______________ + + DEC 17, 2019 + ______________ + + + <2019-12-17 Tue> + + +Installation instruction are now complete. A review would be greatly +appreciated! diff --git a/docs/news/20191218.html b/docs/news/20191218.html new file mode 100644 index 0000000..ca11ce1 --- /dev/null +++ b/docs/news/20191218.html @@ -0,0 +1,42 @@ +<!DOCTYPE html> +<html lang="en"> +<head> +<!-- 2021-02-02 --> +<meta charset="utf-8"> +<meta name="viewport" content="width=device-width, initial-scale=1"> +<title>Dec 18, 2019</title> +<meta name="generator" content="Org mode"> +<link rel="stylesheet" type="text/css" href="/style.css"> +</head> +<body> +<div id="preamble" class="status"> +<nav id="navbar"> + <a href="/" class=navbartitle>Carbs Linux</a> + + <label for="hamburger">☰</label> + <input type="checkbox" id="hamburger" /> + <ul id=navbarlist> + <li><a href="/" title="Home Page">Home</a></li> + <li><a href="//git.carbslinux.org" title="Git Repository">Git</a></li> + <li><a href="/download.html" title="Download Carbs Linux">Download</a></li> + <li><a href="/blog" title="Blog Posts">Blog</a></li> + <li><a href="/install.html" title="Installation Instructions">Installation</a></li> + <li><a href="/docs.html" title="Documentation">Docs</a></li> + </ul> +</nav> +</div> +<div id="content"> +<header> +<h1 class="title">Dec 18, 2019</h1> +</header><p> +carbs-rootfs-20191218.tar.xz was released. +</p> +</div> +<div id="postamble" class="status"> +<footer> + <p>Linux® is a registered trademark of Linus Torvalds</p> + <p>Copyright © 2019-2021 Cem Keylan</p> +</footer> +</div> +</body> +</html> diff --git a/docs/news/20191218.txt b/docs/news/20191218.txt new file mode 100644 index 0000000..b82fbc8 --- /dev/null +++ b/docs/news/20191218.txt @@ -0,0 +1,10 @@ + ______________ + + DEC 18, 2019 + ______________ + + + <2019-12-18 Wed> + + +carbs-rootfs-20191218.tar.xz was released. diff --git a/docs/news/20200109.html b/docs/news/20200109.html new file mode 100644 index 0000000..dc23cf6 --- /dev/null +++ b/docs/news/20200109.html @@ -0,0 +1,55 @@ +<!DOCTYPE html> +<html lang="en"> +<head> +<!-- 2021-02-02 --> +<meta charset="utf-8"> +<meta name="viewport" content="width=device-width, initial-scale=1"> +<title>Jan 09, 2020</title> +<meta name="generator" content="Org mode"> +<link rel="stylesheet" type="text/css" href="/style.css"> +</head> +<body> +<div id="preamble" class="status"> +<nav id="navbar"> + <a href="/" class=navbartitle>Carbs Linux</a> + + <label for="hamburger">☰</label> + <input type="checkbox" id="hamburger" /> + <ul id=navbarlist> + <li><a href="/" title="Home Page">Home</a></li> + <li><a href="//git.carbslinux.org" title="Git Repository">Git</a></li> + <li><a href="/download.html" title="Download Carbs Linux">Download</a></li> + <li><a href="/blog" title="Blog Posts">Blog</a></li> + <li><a href="/install.html" title="Installation Instructions">Installation</a></li> + <li><a href="/docs.html" title="Documentation">Docs</a></li> + </ul> +</nav> +</div> +<div id="content"> +<header> +<h1 class="title">Jan 09, 2020</h1> +</header><p> +Happy new year, everyone! I am back after some long silence. I was unable to commit for a +while, but I have pulled some new updates from the KISS repository, added some of my own. +This week I will be changing/adding some things. +</p> + +<p> +Important things are, +</p> + +<ul class="org-ul"> +<li>Carbs-init was updated to 0.3.</li> +<li>I will be adding an implementation of suckless.org's <a href="https://core.suckless.org/sinit">sinit</a> as <code>carbs-sinit</code></li> +<li>Carbs Repository was added to <a href="https://repology.org/repository/carbs">repology.org</a></li> +<li>A new rootfs tarball will be coming up tomorrow.</li> +</ul> +</div> +<div id="postamble" class="status"> +<footer> + <p>Linux® is a registered trademark of Linus Torvalds</p> + <p>Copyright © 2019-2021 Cem Keylan</p> +</footer> +</div> +</body> +</html> diff --git a/docs/news/20200109.txt b/docs/news/20200109.txt new file mode 100644 index 0000000..cdd37b4 --- /dev/null +++ b/docs/news/20200109.txt @@ -0,0 +1,26 @@ + ______________ + + JAN 09, 2020 + ______________ + + + <2020-01-09 Thu> + + +Happy new year, everyone! I am back after some long silence. I was +unable to commit for a while, but I have pulled some new updates from +the KISS repository, added some of my own. This week I will be +changing/adding some things. + +Important things are, + +- Carbs-init was updated to 0.3. +- I will be adding an implementation of suckless.org's [sinit] as + `carbs-sinit' +- Carbs Repository was added to [repology.org] +- A new rootfs tarball will be coming up tomorrow. + + +[sinit] <https://core.suckless.org/sinit> + +[repology.org] <https://repology.org/repository/carbs> diff --git a/docs/news/20200110.html b/docs/news/20200110.html new file mode 100644 index 0000000..60cf02c --- /dev/null +++ b/docs/news/20200110.html @@ -0,0 +1,42 @@ +<!DOCTYPE html> +<html lang="en"> +<head> +<!-- 2021-02-02 --> +<meta charset="utf-8"> +<meta name="viewport" content="width=device-width, initial-scale=1"> +<title>Jan 10, 2020</title> +<meta name="generator" content="Org mode"> +<link rel="stylesheet" type="text/css" href="/style.css"> +</head> +<body> +<div id="preamble" class="status"> +<nav id="navbar"> + <a href="/" class=navbartitle>Carbs Linux</a> + + <label for="hamburger">☰</label> + <input type="checkbox" id="hamburger" /> + <ul id=navbarlist> + <li><a href="/" title="Home Page">Home</a></li> + <li><a href="//git.carbslinux.org" title="Git Repository">Git</a></li> + <li><a href="/download.html" title="Download Carbs Linux">Download</a></li> + <li><a href="/blog" title="Blog Posts">Blog</a></li> + <li><a href="/install.html" title="Installation Instructions">Installation</a></li> + <li><a href="/docs.html" title="Documentation">Docs</a></li> + </ul> +</nav> +</div> +<div id="content"> +<header> +<h1 class="title">Jan 10, 2020</h1> +</header><p> +carbs-rootfs-20200110.tar.xz was released. +</p> +</div> +<div id="postamble" class="status"> +<footer> + <p>Linux® is a registered trademark of Linus Torvalds</p> + <p>Copyright © 2019-2021 Cem Keylan</p> +</footer> +</div> +</body> +</html> diff --git a/docs/news/20200110.txt b/docs/news/20200110.txt new file mode 100644 index 0000000..4963520 --- /dev/null +++ b/docs/news/20200110.txt @@ -0,0 +1,10 @@ + ______________ + + JAN 10, 2020 + ______________ + + + <2020-01-10 Fri> + + +carbs-rootfs-20200110.tar.xz was released. diff --git a/docs/news/20200113.html b/docs/news/20200113.html new file mode 100644 index 0000000..99d8fd5 --- /dev/null +++ b/docs/news/20200113.html @@ -0,0 +1,66 @@ +<!DOCTYPE html> +<html lang="en"> +<head> +<!-- 2021-02-02 --> +<meta charset="utf-8"> +<meta name="viewport" content="width=device-width, initial-scale=1"> +<title>Jan 13, 2020</title> +<meta name="generator" content="Org mode"> +<link rel="stylesheet" type="text/css" href="/style.css"> +</head> +<body> +<div id="preamble" class="status"> +<nav id="navbar"> + <a href="/" class=navbartitle>Carbs Linux</a> + + <label for="hamburger">☰</label> + <input type="checkbox" id="hamburger" /> + <ul id=navbarlist> + <li><a href="/" title="Home Page">Home</a></li> + <li><a href="//git.carbslinux.org" title="Git Repository">Git</a></li> + <li><a href="/download.html" title="Download Carbs Linux">Download</a></li> + <li><a href="/blog" title="Blog Posts">Blog</a></li> + <li><a href="/install.html" title="Installation Instructions">Installation</a></li> + <li><a href="/docs.html" title="Documentation">Docs</a></li> + </ul> +</nav> +</div> +<div id="content"> +<header> +<h1 class="title">Jan 13, 2020</h1> +</header><p> +<b><b>Busybox update reqires manual intervention</b></b> +</p> + +<p> +The new busybox package conflicts with the pre-update busybox-init. That's why +you should rebuild and install `busybox-init` before doing the update. +</p> + +<div class="org-src-container"> +<pre class="src src-sh"><span class="org-comment-delimiter"># </span><span class="org-comment">Do a kiss update first (but don't actually update it yet), or manually pull</span> +<span class="org-comment-delimiter"># </span><span class="org-comment">the git repository</span> +kiss u <span class="org-comment-delimiter"># </span><span class="org-comment">Cancel this operation after it asks for you to confirm the update</span> + +<span class="org-comment-delimiter"># </span><span class="org-comment">Install the busybox-init package</span> +kiss b busybox-init && kiss i busybox-init + +<span class="org-comment-delimiter"># </span><span class="org-comment">Continue your update as you normally would.</span> +kiss u + +</pre> +</div> + +<p> +I have moved runit and logging utilities from the busybox-init package to the busybox +package, which is the cause of these conflicts. +</p> +</div> +<div id="postamble" class="status"> +<footer> + <p>Linux® is a registered trademark of Linus Torvalds</p> + <p>Copyright © 2019-2021 Cem Keylan</p> +</footer> +</div> +</body> +</html> diff --git a/docs/news/20200113.txt b/docs/news/20200113.txt new file mode 100644 index 0000000..a5a44a8 --- /dev/null +++ b/docs/news/20200113.txt @@ -0,0 +1,30 @@ + ______________ + + JAN 13, 2020 + ______________ + + + <2020-01-13 Mon> + + +**Busybox update reqires manual intervention** + +The new busybox package conflicts with the pre-update +busybox-init. That's why you should rebuild and install `busybox-init` +before doing the update. + +,---- +| # Do a kiss update first (but don't actually update it yet), or manually pull +| # the git repository +| kiss u # Cancel this operation after it asks for you to confirm the update +| +| # Install the busybox-init package +| kiss b busybox-init && kiss i busybox-init +| +| # Continue your update as you normally would. +| kiss u +| +`---- + +I have moved runit and logging utilities from the busybox-init package +to the busybox package, which is the cause of these conflicts. diff --git a/docs/news/20200115.html b/docs/news/20200115.html new file mode 100644 index 0000000..8204bcf --- /dev/null +++ b/docs/news/20200115.html @@ -0,0 +1,42 @@ +<!DOCTYPE html> +<html lang="en"> +<head> +<!-- 2021-02-02 --> +<meta charset="utf-8"> +<meta name="viewport" content="width=device-width, initial-scale=1"> +<title>Jan 15, 2020</title> +<meta name="generator" content="Org mode"> +<link rel="stylesheet" type="text/css" href="/style.css"> +</head> +<body> +<div id="preamble" class="status"> +<nav id="navbar"> + <a href="/" class=navbartitle>Carbs Linux</a> + + <label for="hamburger">☰</label> + <input type="checkbox" id="hamburger" /> + <ul id=navbarlist> + <li><a href="/" title="Home Page">Home</a></li> + <li><a href="//git.carbslinux.org" title="Git Repository">Git</a></li> + <li><a href="/download.html" title="Download Carbs Linux">Download</a></li> + <li><a href="/blog" title="Blog Posts">Blog</a></li> + <li><a href="/install.html" title="Installation Instructions">Installation</a></li> + <li><a href="/docs.html" title="Documentation">Docs</a></li> + </ul> +</nav> +</div> +<div id="content"> +<header> +<h1 class="title">Jan 15, 2020</h1> +</header><p> +sinit has been taken to <code>core</code>, and is now officially supported +</p> +</div> +<div id="postamble" class="status"> +<footer> + <p>Linux® is a registered trademark of Linus Torvalds</p> + <p>Copyright © 2019-2021 Cem Keylan</p> +</footer> +</div> +</body> +</html> diff --git a/docs/news/20200115.txt b/docs/news/20200115.txt new file mode 100644 index 0000000..9c2ec17 --- /dev/null +++ b/docs/news/20200115.txt @@ -0,0 +1,10 @@ + ______________ + + JAN 15, 2020 + ______________ + + + <2020-01-15 Wed> + + +sinit has been taken to `core', and is now officially supported diff --git a/docs/news/20200122.html b/docs/news/20200122.html new file mode 100644 index 0000000..7bbd859 --- /dev/null +++ b/docs/news/20200122.html @@ -0,0 +1,43 @@ +<!DOCTYPE html> +<html lang="en"> +<head> +<!-- 2021-02-02 --> +<meta charset="utf-8"> +<meta name="viewport" content="width=device-width, initial-scale=1"> +<title>Jan 22, 2020</title> +<meta name="generator" content="Org mode"> +<link rel="stylesheet" type="text/css" href="/style.css"> +</head> +<body> +<div id="preamble" class="status"> +<nav id="navbar"> + <a href="/" class=navbartitle>Carbs Linux</a> + + <label for="hamburger">☰</label> + <input type="checkbox" id="hamburger" /> + <ul id=navbarlist> + <li><a href="/" title="Home Page">Home</a></li> + <li><a href="//git.carbslinux.org" title="Git Repository">Git</a></li> + <li><a href="/download.html" title="Download Carbs Linux">Download</a></li> + <li><a href="/blog" title="Blog Posts">Blog</a></li> + <li><a href="/install.html" title="Installation Instructions">Installation</a></li> + <li><a href="/docs.html" title="Documentation">Docs</a></li> + </ul> +</nav> +</div> +<div id="content"> +<header> +<h1 class="title">Jan 22, 2020</h1> +</header><p> +Expect downtime on Jan 24 2020 22:00 UTC as I will be migrating this web server +to my Carbs Linux server! +</p> +</div> +<div id="postamble" class="status"> +<footer> + <p>Linux® is a registered trademark of Linus Torvalds</p> + <p>Copyright © 2019-2021 Cem Keylan</p> +</footer> +</div> +</body> +</html> diff --git a/docs/news/20200122.txt b/docs/news/20200122.txt new file mode 100644 index 0000000..f7930d0 --- /dev/null +++ b/docs/news/20200122.txt @@ -0,0 +1,11 @@ + ______________ + + JAN 22, 2020 + ______________ + + + <2020-01-22 Wed> + + +Expect downtime on Jan 24 2020 22:00 UTC as I will be migrating this web +server to my Carbs Linux server! diff --git a/docs/news/20200128.html b/docs/news/20200128.html new file mode 100644 index 0000000..6b96518 --- /dev/null +++ b/docs/news/20200128.html @@ -0,0 +1,51 @@ +<!DOCTYPE html> +<html lang="en"> +<head> +<!-- 2021-02-02 --> +<meta charset="utf-8"> +<meta name="viewport" content="width=device-width, initial-scale=1"> +<title>Jan 28, 2020</title> +<meta name="generator" content="Org mode"> +<link rel="stylesheet" type="text/css" href="/style.css"> +</head> +<body> +<div id="preamble" class="status"> +<nav id="navbar"> + <a href="/" class=navbartitle>Carbs Linux</a> + + <label for="hamburger">☰</label> + <input type="checkbox" id="hamburger" /> + <ul id=navbarlist> + <li><a href="/" title="Home Page">Home</a></li> + <li><a href="//git.carbslinux.org" title="Git Repository">Git</a></li> + <li><a href="/download.html" title="Download Carbs Linux">Download</a></li> + <li><a href="/blog" title="Blog Posts">Blog</a></li> + <li><a href="/install.html" title="Installation Instructions">Installation</a></li> + <li><a href="/docs.html" title="Documentation">Docs</a></li> + </ul> +</nav> +</div> +<div id="content"> +<header> +<h1 class="title">Jan 28, 2020</h1> +</header><p> +Web Server is now on a Carbs Linux server. It is not complete yet, but I will be +adding a little more for the intended functionality. Downtimes can be expected. +</p> + +<p> +UPDATE: ssl is now working. +</p> + +<p> +UPDATE2: downloads are back again. +</p> +</div> +<div id="postamble" class="status"> +<footer> + <p>Linux® is a registered trademark of Linus Torvalds</p> + <p>Copyright © 2019-2021 Cem Keylan</p> +</footer> +</div> +</body> +</html> diff --git a/docs/news/20200128.txt b/docs/news/20200128.txt new file mode 100644 index 0000000..f504343 --- /dev/null +++ b/docs/news/20200128.txt @@ -0,0 +1,16 @@ + ______________ + + JAN 28, 2020 + ______________ + + + <2020-01-28 Tue> + + +Web Server is now on a Carbs Linux server. It is not complete yet, but I +will be adding a little more for the intended functionality. Downtimes +can be expected. + +UPDATE: ssl is now working. + +UPDATE2: downloads are back again. diff --git a/docs/news/20200213.html b/docs/news/20200213.html new file mode 100644 index 0000000..b53011f --- /dev/null +++ b/docs/news/20200213.html @@ -0,0 +1,44 @@ +<!DOCTYPE html> +<html lang="en"> +<head> +<!-- 2021-02-02 --> +<meta charset="utf-8"> +<meta name="viewport" content="width=device-width, initial-scale=1"> +<title>Feb 13, 2020</title> +<meta name="generator" content="Org mode"> +<link rel="stylesheet" type="text/css" href="/style.css"> +</head> +<body> +<div id="preamble" class="status"> +<nav id="navbar"> + <a href="/" class=navbartitle>Carbs Linux</a> + + <label for="hamburger">☰</label> + <input type="checkbox" id="hamburger" /> + <ul id=navbarlist> + <li><a href="/" title="Home Page">Home</a></li> + <li><a href="//git.carbslinux.org" title="Git Repository">Git</a></li> + <li><a href="/download.html" title="Download Carbs Linux">Download</a></li> + <li><a href="/blog" title="Blog Posts">Blog</a></li> + <li><a href="/install.html" title="Installation Instructions">Installation</a></li> + <li><a href="/docs.html" title="Documentation">Docs</a></li> + </ul> +</nav> +</div> +<div id="content"> +<header> +<h1 class="title">Feb 13, 2020</h1> +</header><p> +Runit is now released on the core repository! You can now replace busybox-init +with runit-init. You can also replace the busybox runit utilities with the +actual runit. This will reduce the dependency on busybox greatly. +</p> +</div> +<div id="postamble" class="status"> +<footer> + <p>Linux® is a registered trademark of Linus Torvalds</p> + <p>Copyright © 2019-2021 Cem Keylan</p> +</footer> +</div> +</body> +</html> diff --git a/index/20200213.news b/docs/news/20200213.txt index e901f36..6422bc7 100644 --- a/index/20200213.news +++ b/docs/news/20200213.txt @@ -1,5 +1,11 @@ -Feb 13 2020 --------------------------------------------------------------------------------- + ______________ + + FEB 13, 2020 + ______________ + + + <2020-02-13 Thu> + Runit is now released on the core repository! You can now replace busybox-init with runit-init. You can also replace the busybox runit diff --git a/docs/news/20200214.html b/docs/news/20200214.html new file mode 100644 index 0000000..53d60b3 --- /dev/null +++ b/docs/news/20200214.html @@ -0,0 +1,92 @@ +<!DOCTYPE html> +<html lang="en"> +<head> +<!-- 2021-02-02 --> +<meta charset="utf-8"> +<meta name="viewport" content="width=device-width, initial-scale=1"> +<title>Feb 14, 2020</title> +<meta name="generator" content="Org mode"> +<link rel="stylesheet" type="text/css" href="/style.css"> +</head> +<body> +<div id="preamble" class="status"> +<nav id="navbar"> + <a href="/" class=navbartitle>Carbs Linux</a> + + <label for="hamburger">☰</label> + <input type="checkbox" id="hamburger" /> + <ul id=navbarlist> + <li><a href="/" title="Home Page">Home</a></li> + <li><a href="//git.carbslinux.org" title="Git Repository">Git</a></li> + <li><a href="/download.html" title="Download Carbs Linux">Download</a></li> + <li><a href="/blog" title="Blog Posts">Blog</a></li> + <li><a href="/install.html" title="Installation Instructions">Installation</a></li> + <li><a href="/docs.html" title="Documentation">Docs</a></li> + </ul> +</nav> +</div> +<div id="content"> +<header> +<h1 class="title">Feb 14, 2020</h1> +</header><p> +<b><b>IMPORTANT!</b></b> Carbs-init update to be released on 17th of February +will require manual intervention. I am holding this update back so +people can see it before they update their system (even though the +update will show the same message as this). The rationale for the +update is explained below the intervention. +</p> + +<div class="org-src-container"> +<pre class="src src-sh"><span class="org-comment-delimiter"># </span><span class="org-comment">There is an explanation for each init You only need to follow the instructions</span> +<span class="org-comment-delimiter"># </span><span class="org-comment">for your own init-system</span> + +<span class="org-comment-delimiter">## </span><span class="org-comment">busybox-init</span> +<span class="org-comment-delimiter"># </span><span class="org-comment">If you did not edit your inittab simply move inittab.new to inittab</span> +mv /etc/inittab.new /etc/inittab + +<span class="org-comment-delimiter"># </span><span class="org-comment">If you did edit your inittab you can use a simple sed command to remove the</span> +<span class="org-comment-delimiter"># </span><span class="org-comment">necessary lines</span> +sed -i <span class="org-string">'/getty/d;/runsvdir/d'</span> /etc/inittab + + +<span class="org-comment-delimiter">## </span><span class="org-comment">runit</span> +<span class="org-comment-delimiter"># </span><span class="org-comment">same as busybox-init, if you did not edit /etc/runit/2 move 2.new to 2</span> +mv /etc/runit/2.new /etc/runit/2 + +<span class="org-comment-delimiter"># </span><span class="org-comment">else</span> +vim /etc/runit/2 +<span class="org-comment-delimiter"># </span><span class="org-comment">open your 2 file and remove the for loop containing getty commands. If you are</span> +<span class="org-comment-delimiter"># </span><span class="org-comment">using runit, it is recommended to comment out /etc/init/runit.boot</span> + +<span class="org-comment-delimiter">## </span><span class="org-comment">sinit/minit</span> +<span class="org-comment-delimiter"># </span><span class="org-comment">If you did not edit your {sinit-,}launch-services.boot you can simply remove</span> +<span class="org-comment-delimiter"># </span><span class="org-comment">it.</span> +rm -f /etc/init/launch-services.boot /etc/init/sinit-launch-services.boot + +<span class="org-comment-delimiter"># </span><span class="org-comment">This should leave you without any issues, and you can safely reboot.</span> +</pre> +</div> + +<p> +Carbs-init update is to make sure init systems do not clash, and do +not have to use different files. This is a sensible update both for +the user user and for the maintainer side. +</p> + +<p> +To give an example, before this update busybox-init was managing getty +through <code>inittab</code>, runit was managing through <code>/etc/runit/2</code>, and +minit/sinit were launching from <code>/etc/init/launch-services.boot</code>. This +is a configuration nightmare for everyone, and since I am maintaining +and constantly testing those init providers, a huge nightmare for me. +This is a Quality of Life update. +</p> +</div> +<div id="postamble" class="status"> +<footer> + <p>Linux® is a registered trademark of Linus Torvalds</p> + <p>Copyright © 2019-2021 Cem Keylan</p> +</footer> +</div> +</body> +</html> diff --git a/docs/news/20200214.txt b/docs/news/20200214.txt new file mode 100644 index 0000000..e585cff --- /dev/null +++ b/docs/news/20200214.txt @@ -0,0 +1,55 @@ + ______________ + + FEB 14, 2020 + ______________ + + + <2020-02-14 Fri> + + +**IMPORTANT!** Carbs-init update to be released on 17th of February will +require manual intervention. I am holding this update back so people can +see it before they update their system (even though the update will show +the same message as this). The rationale for the update is explained +below the intervention. + +,---- +| # There is an explanation for each init You only need to follow the instructions +| # for your own init-system +| +| ## busybox-init +| # If you did not edit your inittab simply move inittab.new to inittab +| mv /etc/inittab.new /etc/inittab +| +| # If you did edit your inittab you can use a simple sed command to remove the +| # necessary lines +| sed -i '/getty/d;/runsvdir/d' /etc/inittab +| +| +| ## runit +| # same as busybox-init, if you did not edit /etc/runit/2 move 2.new to 2 +| mv /etc/runit/2.new /etc/runit/2 +| +| # else +| vim /etc/runit/2 +| # open your 2 file and remove the for loop containing getty commands. If you are +| # using runit, it is recommended to comment out /etc/init/runit.boot +| +| ## sinit/minit +| # If you did not edit your {sinit-,}launch-services.boot you can simply remove +| # it. +| rm -f /etc/init/launch-services.boot /etc/init/sinit-launch-services.boot +| +| # This should leave you without any issues, and you can safely reboot. +`---- + +Carbs-init update is to make sure init systems do not clash, and do not +have to use different files. This is a sensible update both for the user +user and for the maintainer side. + +To give an example, before this update busybox-init was managing getty +through `inittab', runit was managing through `/etc/runit/2', and +minit/sinit were launching from `/etc/init/launch-services.boot'. This +is a configuration nightmare for everyone, and since I am maintaining +and constantly testing those init providers, a huge nightmare for me. +This is a Quality of Life update. diff --git a/docs/news/20200218.html b/docs/news/20200218.html new file mode 100644 index 0000000..5943bc5 --- /dev/null +++ b/docs/news/20200218.html @@ -0,0 +1,52 @@ +<!DOCTYPE html> +<html lang="en"> +<head> +<!-- 2021-02-02 --> +<meta charset="utf-8"> +<meta name="viewport" content="width=device-width, initial-scale=1"> +<title>Feb 18, 2020</title> +<meta name="generator" content="Org mode"> +<link rel="stylesheet" type="text/css" href="/style.css"> +</head> +<body> +<div id="preamble" class="status"> +<nav id="navbar"> + <a href="/" class=navbartitle>Carbs Linux</a> + + <label for="hamburger">☰</label> + <input type="checkbox" id="hamburger" /> + <ul id=navbarlist> + <li><a href="/" title="Home Page">Home</a></li> + <li><a href="//git.carbslinux.org" title="Git Repository">Git</a></li> + <li><a href="/download.html" title="Download Carbs Linux">Download</a></li> + <li><a href="/blog" title="Blog Posts">Blog</a></li> + <li><a href="/install.html" title="Installation Instructions">Installation</a></li> + <li><a href="/docs.html" title="Documentation">Docs</a></li> + </ul> +</nav> +</div> +<div id="content"> +<header> +<h1 class="title">Feb 18, 2020</h1> +</header><p> +A new tarball is released. It can be found on <a href="https://dl.carbslinux.org">https://dl.carbslinux.org</a>. +</p> + +<p> +<b><b>edit:</b></b> I have removed the tarball because of a bootstrapping issue. I will be +re-adding it later today. +</p> + +<p> +<b><b>edit 2:</b></b> I have added a tarball (20200219) to reflect my recent changes on +Busybox. +</p> +</div> +<div id="postamble" class="status"> +<footer> + <p>Linux® is a registered trademark of Linus Torvalds</p> + <p>Copyright © 2019-2021 Cem Keylan</p> +</footer> +</div> +</body> +</html> diff --git a/docs/news/20200218.txt b/docs/news/20200218.txt new file mode 100644 index 0000000..d954d7d --- /dev/null +++ b/docs/news/20200218.txt @@ -0,0 +1,17 @@ + ______________ + + FEB 18, 2020 + ______________ + + + <2020-02-18 Tue> + + +A new tarball is released. It can be found on +<https://dl.carbslinux.org>. + +**edit:** I have removed the tarball because of a bootstrapping issue. I +will be re-adding it later today. + +**edit 2:** I have added a tarball (20200219) to reflect my recent +changes on Busybox. diff --git a/docs/news/20200405.html b/docs/news/20200405.html new file mode 100644 index 0000000..adf0656 --- /dev/null +++ b/docs/news/20200405.html @@ -0,0 +1,55 @@ +<!DOCTYPE html> +<html lang="en"> +<head> +<!-- 2021-02-02 --> +<meta charset="utf-8"> +<meta name="viewport" content="width=device-width, initial-scale=1"> +<title>Apr 05, 2020</title> +<meta name="generator" content="Org mode"> +<link rel="stylesheet" type="text/css" href="/style.css"> +</head> +<body> +<div id="preamble" class="status"> +<nav id="navbar"> + <a href="/" class=navbartitle>Carbs Linux</a> + + <label for="hamburger">☰</label> + <input type="checkbox" id="hamburger" /> + <ul id=navbarlist> + <li><a href="/" title="Home Page">Home</a></li> + <li><a href="//git.carbslinux.org" title="Git Repository">Git</a></li> + <li><a href="/download.html" title="Download Carbs Linux">Download</a></li> + <li><a href="/blog" title="Blog Posts">Blog</a></li> + <li><a href="/install.html" title="Installation Instructions">Installation</a></li> + <li><a href="/docs.html" title="Documentation">Docs</a></li> + </ul> +</nav> +</div> +<div id="content"> +<header> +<h1 class="title">Apr 05, 2020</h1> +</header><p> +Carbs Linux repositories will be hosted only on Github. Commits will be pushed +there, and not the repository. You have until May 4, 2020 Monday to switch your +remotes to <a href="https://github.com/CarbsLinux/repository">https://github.com/CarbsLinux/repository</a>. The git repository will +continue to be served until then (without additional commits). +</p> + +<p> +You can switch your remote by executing the following command on your repository +directory. +</p> + +<div class="org-src-container"> +<pre class="src src-sh">git remote set-url origin https://github.com/CarbsLinux/repository +</pre> +</div> +</div> +<div id="postamble" class="status"> +<footer> + <p>Linux® is a registered trademark of Linus Torvalds</p> + <p>Copyright © 2019-2021 Cem Keylan</p> +</footer> +</div> +</body> +</html> diff --git a/docs/news/20200405.txt b/docs/news/20200405.txt new file mode 100644 index 0000000..e46d328 --- /dev/null +++ b/docs/news/20200405.txt @@ -0,0 +1,21 @@ + ______________ + + APR 05, 2020 + ______________ + + + <2020-04-05 Sun> + + +Carbs Linux repositories will be hosted only on Github. Commits will be +pushed there, and not the repository. You have until May 4, 2020 Monday +to switch your remotes to +<https://github.com/CarbsLinux/repository>. The git repository will +continue to be served until then (without additional commits). + +You can switch your remote by executing the following command on your +repository directory. + +,---- +| git remote set-url origin https://github.com/CarbsLinux/repository +`---- diff --git a/docs/news/20200406.html b/docs/news/20200406.html new file mode 100644 index 0000000..be02f6d --- /dev/null +++ b/docs/news/20200406.html @@ -0,0 +1,42 @@ +<!DOCTYPE html> +<html lang="en"> +<head> +<!-- 2021-02-02 --> +<meta charset="utf-8"> +<meta name="viewport" content="width=device-width, initial-scale=1"> +<title>Apr 06, 2020</title> +<meta name="generator" content="Org mode"> +<link rel="stylesheet" type="text/css" href="/style.css"> +</head> +<body> +<div id="preamble" class="status"> +<nav id="navbar"> + <a href="/" class=navbartitle>Carbs Linux</a> + + <label for="hamburger">☰</label> + <input type="checkbox" id="hamburger" /> + <ul id=navbarlist> + <li><a href="/" title="Home Page">Home</a></li> + <li><a href="//git.carbslinux.org" title="Git Repository">Git</a></li> + <li><a href="/download.html" title="Download Carbs Linux">Download</a></li> + <li><a href="/blog" title="Blog Posts">Blog</a></li> + <li><a href="/install.html" title="Installation Instructions">Installation</a></li> + <li><a href="/docs.html" title="Documentation">Docs</a></li> + </ul> +</nav> +</div> +<div id="content"> +<header> +<h1 class="title">Apr 06, 2020</h1> +</header><p> +A new rootfs tarball has been released. See the downloads page. +</p> +</div> +<div id="postamble" class="status"> +<footer> + <p>Linux® is a registered trademark of Linus Torvalds</p> + <p>Copyright © 2019-2021 Cem Keylan</p> +</footer> +</div> +</body> +</html> diff --git a/docs/news/20200406.txt b/docs/news/20200406.txt new file mode 100644 index 0000000..7cca6f7 --- /dev/null +++ b/docs/news/20200406.txt @@ -0,0 +1,10 @@ + ______________ + + APR 06, 2020 + ______________ + + + <2020-04-06 Mon> + + +A new rootfs tarball has been released. See the downloads page. diff --git a/docs/news/20200410.html b/docs/news/20200410.html new file mode 100644 index 0000000..303a64c --- /dev/null +++ b/docs/news/20200410.html @@ -0,0 +1,42 @@ +<!DOCTYPE html> +<html lang="en"> +<head> +<!-- 2021-02-02 --> +<meta charset="utf-8"> +<meta name="viewport" content="width=device-width, initial-scale=1"> +<title>Apr 10, 2020</title> +<meta name="generator" content="Org mode"> +<link rel="stylesheet" type="text/css" href="/style.css"> +</head> +<body> +<div id="preamble" class="status"> +<nav id="navbar"> + <a href="/" class=navbartitle>Carbs Linux</a> + + <label for="hamburger">☰</label> + <input type="checkbox" id="hamburger" /> + <ul id=navbarlist> + <li><a href="/" title="Home Page">Home</a></li> + <li><a href="//git.carbslinux.org" title="Git Repository">Git</a></li> + <li><a href="/download.html" title="Download Carbs Linux">Download</a></li> + <li><a href="/blog" title="Blog Posts">Blog</a></li> + <li><a href="/install.html" title="Installation Instructions">Installation</a></li> + <li><a href="/docs.html" title="Documentation">Docs</a></li> + </ul> +</nav> +</div> +<div id="content"> +<header> +<h1 class="title">Apr 10, 2020</h1> +</header><p> +IRC channel can now be accessed from <code>#carbslinux</code> at freenode! +</p> +</div> +<div id="postamble" class="status"> +<footer> + <p>Linux® is a registered trademark of Linus Torvalds</p> + <p>Copyright © 2019-2021 Cem Keylan</p> +</footer> +</div> +</body> +</html> diff --git a/docs/news/20200410.txt b/docs/news/20200410.txt new file mode 100644 index 0000000..0c1befc --- /dev/null +++ b/docs/news/20200410.txt @@ -0,0 +1,10 @@ + ______________ + + APR 10, 2020 + ______________ + + + <2020-04-10 Fri> + + +IRC channel can now be accessed from `#carbslinux' at freenode! diff --git a/docs/news/20200427.html b/docs/news/20200427.html new file mode 100644 index 0000000..d9e7289 --- /dev/null +++ b/docs/news/20200427.html @@ -0,0 +1,47 @@ +<!DOCTYPE html> +<html lang="en"> +<head> +<!-- 2021-02-02 --> +<meta charset="utf-8"> +<meta name="viewport" content="width=device-width, initial-scale=1"> +<title>Apr 27, 2020</title> +<meta name="generator" content="Org mode"> +<link rel="stylesheet" type="text/css" href="/style.css"> +</head> +<body> +<div id="preamble" class="status"> +<nav id="navbar"> + <a href="/" class=navbartitle>Carbs Linux</a> + + <label for="hamburger">☰</label> + <input type="checkbox" id="hamburger" /> + <ul id=navbarlist> + <li><a href="/" title="Home Page">Home</a></li> + <li><a href="//git.carbslinux.org" title="Git Repository">Git</a></li> + <li><a href="/download.html" title="Download Carbs Linux">Download</a></li> + <li><a href="/blog" title="Blog Posts">Blog</a></li> + <li><a href="/install.html" title="Installation Instructions">Installation</a></li> + <li><a href="/docs.html" title="Documentation">Docs</a></li> + </ul> +</nav> +</div> +<div id="content"> +<header> +<h1 class="title">Apr 27, 2020</h1> +</header><p> +A new rootfs tarball has been released! You can see it on +<a href="https://dl.carbslinux.org/releases">https://dl.carbslinux.org/releases</a>! +</p> + +<p> +<b><b>EDIT:</b></b> A new bug fix release has been made. +</p> +</div> +<div id="postamble" class="status"> +<footer> + <p>Linux® is a registered trademark of Linus Torvalds</p> + <p>Copyright © 2019-2021 Cem Keylan</p> +</footer> +</div> +</body> +</html> diff --git a/docs/news/20200427.txt b/docs/news/20200427.txt new file mode 100644 index 0000000..6f7815f --- /dev/null +++ b/docs/news/20200427.txt @@ -0,0 +1,13 @@ + ______________ + + APR 27, 2020 + ______________ + + + <2020-04-27 Mon> + + +A new rootfs tarball has been released! You can see it on +<https://dl.carbslinux.org/releases>! + +**EDIT:** A new bug fix release has been made. diff --git a/docs/news/20200510.html b/docs/news/20200510.html new file mode 100644 index 0000000..67cb339 --- /dev/null +++ b/docs/news/20200510.html @@ -0,0 +1,47 @@ +<!DOCTYPE html> +<html lang="en"> +<head> +<!-- 2021-02-02 --> +<meta charset="utf-8"> +<meta name="viewport" content="width=device-width, initial-scale=1"> +<title>May 10, 2020</title> +<meta name="generator" content="Org mode"> +<link rel="stylesheet" type="text/css" href="/style.css"> +</head> +<body> +<div id="preamble" class="status"> +<nav id="navbar"> + <a href="/" class=navbartitle>Carbs Linux</a> + + <label for="hamburger">☰</label> + <input type="checkbox" id="hamburger" /> + <ul id=navbarlist> + <li><a href="/" title="Home Page">Home</a></li> + <li><a href="//git.carbslinux.org" title="Git Repository">Git</a></li> + <li><a href="/download.html" title="Download Carbs Linux">Download</a></li> + <li><a href="/blog" title="Blog Posts">Blog</a></li> + <li><a href="/install.html" title="Installation Instructions">Installation</a></li> + <li><a href="/docs.html" title="Documentation">Docs</a></li> + </ul> +</nav> +</div> +<div id="content"> +<header> +<h1 class="title">May 10, 2020</h1> +</header><p> +A GCC 10.1.0 change causes a kernel panic for kernels built with GCC 10.1. This +issue can be resolved by applying this <a href="https://git.kernel.org/pub/scm/linux/kernel/git/tip/tip.git/patch/?id=f670269a42bfdd2c83a1118cc3d1b475547eac22">patch</a> to your kernel sources. +</p> + +<p> +<b><b>EDIT:</b></b> The patch is no longer necessary. +</p> +</div> +<div id="postamble" class="status"> +<footer> + <p>Linux® is a registered trademark of Linus Torvalds</p> + <p>Copyright © 2019-2021 Cem Keylan</p> +</footer> +</div> +</body> +</html> diff --git a/docs/news/20200510.txt b/docs/news/20200510.txt new file mode 100644 index 0000000..394585e --- /dev/null +++ b/docs/news/20200510.txt @@ -0,0 +1,18 @@ + ______________ + + MAY 10, 2020 + ______________ + + + <2020-05-10 Sun> + + +A GCC 10.1.0 change causes a kernel panic for kernels built with GCC +10.1. This issue can be resolved by applying this [patch] to your kernel +sources. + +**EDIT:** The patch is no longer necessary. + + +[patch] +<https://git.kernel.org/pub/scm/linux/kernel/git/tip/tip.git/patch/?id=f670269a42bfdd2c83a1118cc3d1b475547eac22> diff --git a/docs/news/20200519.html b/docs/news/20200519.html new file mode 100644 index 0000000..ccb5df3 --- /dev/null +++ b/docs/news/20200519.html @@ -0,0 +1,43 @@ +<!DOCTYPE html> +<html lang="en"> +<head> +<!-- 2021-02-02 --> +<meta charset="utf-8"> +<meta name="viewport" content="width=device-width, initial-scale=1"> +<title>May 19, 2020</title> +<meta name="generator" content="Org mode"> +<link rel="stylesheet" type="text/css" href="/style.css"> +</head> +<body> +<div id="preamble" class="status"> +<nav id="navbar"> + <a href="/" class=navbartitle>Carbs Linux</a> + + <label for="hamburger">☰</label> + <input type="checkbox" id="hamburger" /> + <ul id=navbarlist> + <li><a href="/" title="Home Page">Home</a></li> + <li><a href="//git.carbslinux.org" title="Git Repository">Git</a></li> + <li><a href="/download.html" title="Download Carbs Linux">Download</a></li> + <li><a href="/blog" title="Blog Posts">Blog</a></li> + <li><a href="/install.html" title="Installation Instructions">Installation</a></li> + <li><a href="/docs.html" title="Documentation">Docs</a></li> + </ul> +</nav> +</div> +<div id="content"> +<header> +<h1 class="title">May 19, 2020</h1> +</header><p> +A rootfs tarball targeting the i686 architecture has been released. It can be +found on the downloads page. +</p> +</div> +<div id="postamble" class="status"> +<footer> + <p>Linux® is a registered trademark of Linus Torvalds</p> + <p>Copyright © 2019-2021 Cem Keylan</p> +</footer> +</div> +</body> +</html> diff --git a/docs/news/20200519.txt b/docs/news/20200519.txt new file mode 100644 index 0000000..2f3ef90 --- /dev/null +++ b/docs/news/20200519.txt @@ -0,0 +1,11 @@ + ______________ + + MAY 19, 2020 + ______________ + + + <2020-05-19 Tue> + + +A rootfs tarball targeting the i686 architecture has been released. It +can be found on the downloads page. diff --git a/docs/news/20200526.html b/docs/news/20200526.html new file mode 100644 index 0000000..5438904 --- /dev/null +++ b/docs/news/20200526.html @@ -0,0 +1,43 @@ +<!DOCTYPE html> +<html lang="en"> +<head> +<!-- 2021-02-02 --> +<meta charset="utf-8"> +<meta name="viewport" content="width=device-width, initial-scale=1"> +<title>May 26, 2020</title> +<meta name="generator" content="Org mode"> +<link rel="stylesheet" type="text/css" href="/style.css"> +</head> +<body> +<div id="preamble" class="status"> +<nav id="navbar"> + <a href="/" class=navbartitle>Carbs Linux</a> + + <label for="hamburger">☰</label> + <input type="checkbox" id="hamburger" /> + <ul id=navbarlist> + <li><a href="/" title="Home Page">Home</a></li> + <li><a href="//git.carbslinux.org" title="Git Repository">Git</a></li> + <li><a href="/download.html" title="Download Carbs Linux">Download</a></li> + <li><a href="/blog" title="Blog Posts">Blog</a></li> + <li><a href="/install.html" title="Installation Instructions">Installation</a></li> + <li><a href="/docs.html" title="Documentation">Docs</a></li> + </ul> +</nav> +</div> +<div id="content"> +<header> +<h1 class="title">May 26, 2020</h1> +</header><p> +An initial version for binary package management is released. It can be found on +the <a href="https://github.com/CarbsLinux/kiss-bin">GitHub page</a>. +</p> +</div> +<div id="postamble" class="status"> +<footer> + <p>Linux® is a registered trademark of Linus Torvalds</p> + <p>Copyright © 2019-2021 Cem Keylan</p> +</footer> +</div> +</body> +</html> diff --git a/docs/news/20200526.txt b/docs/news/20200526.txt new file mode 100644 index 0000000..7ad092b --- /dev/null +++ b/docs/news/20200526.txt @@ -0,0 +1,14 @@ + ______________ + + MAY 26, 2020 + ______________ + + + <2020-05-26 Tue> + + +An initial version for binary package management is released. It can be +found on the [GitHub page]. + + +[GitHub page] <https://github.com/CarbsLinux/kiss-bin> diff --git a/docs/news/20200617.html b/docs/news/20200617.html new file mode 100644 index 0000000..ed8b62d --- /dev/null +++ b/docs/news/20200617.html @@ -0,0 +1,43 @@ +<!DOCTYPE html> +<html lang="en"> +<head> +<!-- 2021-02-02 --> +<meta charset="utf-8"> +<meta name="viewport" content="width=device-width, initial-scale=1"> +<title>Jun 17, 2020</title> +<meta name="generator" content="Org mode"> +<link rel="stylesheet" type="text/css" href="/style.css"> +</head> +<body> +<div id="preamble" class="status"> +<nav id="navbar"> + <a href="/" class=navbartitle>Carbs Linux</a> + + <label for="hamburger">☰</label> + <input type="checkbox" id="hamburger" /> + <ul id=navbarlist> + <li><a href="/" title="Home Page">Home</a></li> + <li><a href="//git.carbslinux.org" title="Git Repository">Git</a></li> + <li><a href="/download.html" title="Download Carbs Linux">Download</a></li> + <li><a href="/blog" title="Blog Posts">Blog</a></li> + <li><a href="/install.html" title="Installation Instructions">Installation</a></li> + <li><a href="/docs.html" title="Documentation">Docs</a></li> + </ul> +</nav> +</div> +<div id="content"> +<header> +<h1 class="title">Jun 17, 2020</h1> +</header><p> +A new rootfs tarball including the changes to the core is released and can be +found on the downloads page. +</p> +</div> +<div id="postamble" class="status"> +<footer> + <p>Linux® is a registered trademark of Linus Torvalds</p> + <p>Copyright © 2019-2021 Cem Keylan</p> +</footer> +</div> +</body> +</html> diff --git a/docs/news/20200617.txt b/docs/news/20200617.txt new file mode 100644 index 0000000..2515111 --- /dev/null +++ b/docs/news/20200617.txt @@ -0,0 +1,11 @@ + ______________ + + JUN 17, 2020 + ______________ + + + <2020-06-17 Wed> + + +A new rootfs tarball including the changes to the core is released and +can be found on the downloads page. diff --git a/docs/news/20200727.html b/docs/news/20200727.html new file mode 100644 index 0000000..0c36e31 --- /dev/null +++ b/docs/news/20200727.html @@ -0,0 +1,45 @@ +<!DOCTYPE html> +<html lang="en"> +<head> +<!-- 2021-02-02 --> +<meta charset="utf-8"> +<meta name="viewport" content="width=device-width, initial-scale=1"> +<title>Jul 27, 2020</title> +<meta name="generator" content="Org mode"> +<link rel="stylesheet" type="text/css" href="/style.css"> +</head> +<body> +<div id="preamble" class="status"> +<nav id="navbar"> + <a href="/" class=navbartitle>Carbs Linux</a> + + <label for="hamburger">☰</label> + <input type="checkbox" id="hamburger" /> + <ul id=navbarlist> + <li><a href="/" title="Home Page">Home</a></li> + <li><a href="//git.carbslinux.org" title="Git Repository">Git</a></li> + <li><a href="/download.html" title="Download Carbs Linux">Download</a></li> + <li><a href="/blog" title="Blog Posts">Blog</a></li> + <li><a href="/install.html" title="Installation Instructions">Installation</a></li> + <li><a href="/docs.html" title="Documentation">Docs</a></li> + </ul> +</nav> +</div> +<div id="content"> +<header> +<h1 class="title">Jul 27, 2020</h1> +</header><p> +Carbs Linux's fork of the <code>kiss</code> package manager has been renamed to <code>Carbs +Packaging Tools</code> due to huge amount of changes. Your latest <code>kiss</code> update will +handle the bootstrapping. You will need to rename your <code>KISS-*</code> variables to +<code>CPT-*</code>. +</p> +</div> +<div id="postamble" class="status"> +<footer> + <p>Linux® is a registered trademark of Linus Torvalds</p> + <p>Copyright © 2019-2021 Cem Keylan</p> +</footer> +</div> +</body> +</html> diff --git a/docs/news/20200727.txt b/docs/news/20200727.txt new file mode 100644 index 0000000..eaf0544 --- /dev/null +++ b/docs/news/20200727.txt @@ -0,0 +1,13 @@ + ______________ + + JUL 27, 2020 + ______________ + + + <2020-07-27 Mon> + + +Carbs Linux's fork of the `kiss' package manager has been renamed to +`Carbs Packaging Tools' due to huge amount of changes. Your latest +`kiss' update will handle the bootstrapping. You will need to rename +your `KISS-*' variables to `CPT-*'. diff --git a/docs/news/20200903.html b/docs/news/20200903.html new file mode 100644 index 0000000..b7835a7 --- /dev/null +++ b/docs/news/20200903.html @@ -0,0 +1,44 @@ +<!DOCTYPE html> +<html lang="en"> +<head> +<!-- 2021-02-02 --> +<meta charset="utf-8"> +<meta name="viewport" content="width=device-width, initial-scale=1"> +<title>Sep 03, 2020</title> +<meta name="generator" content="Org mode"> +<link rel="stylesheet" type="text/css" href="/style.css"> +</head> +<body> +<div id="preamble" class="status"> +<nav id="navbar"> + <a href="/" class=navbartitle>Carbs Linux</a> + + <label for="hamburger">☰</label> + <input type="checkbox" id="hamburger" /> + <ul id=navbarlist> + <li><a href="/" title="Home Page">Home</a></li> + <li><a href="//git.carbslinux.org" title="Git Repository">Git</a></li> + <li><a href="/download.html" title="Download Carbs Linux">Download</a></li> + <li><a href="/blog" title="Blog Posts">Blog</a></li> + <li><a href="/install.html" title="Installation Instructions">Installation</a></li> + <li><a href="/docs.html" title="Documentation">Docs</a></li> + </ul> +</nav> +</div> +<div id="content"> +<header> +<h1 class="title">Sep 03, 2020</h1> +</header><p> +The default TLS provider has been reverted to <code>libressl</code>. System update will +replace bearssl dependencies with libressl. You may choose to keep or remove +bearssl after the update. +</p> +</div> +<div id="postamble" class="status"> +<footer> + <p>Linux® is a registered trademark of Linus Torvalds</p> + <p>Copyright © 2019-2021 Cem Keylan</p> +</footer> +</div> +</body> +</html> diff --git a/docs/news/20200903.txt b/docs/news/20200903.txt new file mode 100644 index 0000000..816c61c --- /dev/null +++ b/docs/news/20200903.txt @@ -0,0 +1,12 @@ + ______________ + + SEP 03, 2020 + ______________ + + + <2020-09-03 Thu> + + +The default TLS provider has been reverted to `libressl'. System update +will replace bearssl dependencies with libressl. You may choose to keep +or remove bearssl after the update. diff --git a/docs/news/20200916.html b/docs/news/20200916.html new file mode 100644 index 0000000..fd784a5 --- /dev/null +++ b/docs/news/20200916.html @@ -0,0 +1,44 @@ +<!DOCTYPE html> +<html lang="en"> +<head> +<!-- 2021-02-02 --> +<meta charset="utf-8"> +<meta name="viewport" content="width=device-width, initial-scale=1"> +<title>Sep 16, 2020</title> +<meta name="generator" content="Org mode"> +<link rel="stylesheet" type="text/css" href="/style.css"> +</head> +<body> +<div id="preamble" class="status"> +<nav id="navbar"> + <a href="/" class=navbartitle>Carbs Linux</a> + + <label for="hamburger">☰</label> + <input type="checkbox" id="hamburger" /> + <ul id=navbarlist> + <li><a href="/" title="Home Page">Home</a></li> + <li><a href="//git.carbslinux.org" title="Git Repository">Git</a></li> + <li><a href="/download.html" title="Download Carbs Linux">Download</a></li> + <li><a href="/blog" title="Blog Posts">Blog</a></li> + <li><a href="/install.html" title="Installation Instructions">Installation</a></li> + <li><a href="/docs.html" title="Documentation">Docs</a></li> + </ul> +</nav> +</div> +<div id="content"> +<header> +<h1 class="title">Sep 16, 2020</h1> +</header><p> +The libressl "revert" was reverted. System update will replace libressl +dependencies with bearssl. You may choose to keep or remove bearssl after the +update. +</p> +</div> +<div id="postamble" class="status"> +<footer> + <p>Linux® is a registered trademark of Linus Torvalds</p> + <p>Copyright © 2019-2021 Cem Keylan</p> +</footer> +</div> +</body> +</html> diff --git a/docs/news/20200916.txt b/docs/news/20200916.txt new file mode 100644 index 0000000..b0a7925 --- /dev/null +++ b/docs/news/20200916.txt @@ -0,0 +1,12 @@ + ______________ + + SEP 16, 2020 + ______________ + + + <2020-09-16 Wed> + + +The libressl "revert" was reverted. System update will replace libressl +dependencies with bearssl. You may choose to keep or remove bearssl +after the update. diff --git a/docs/news/index.html b/docs/news/index.html new file mode 100644 index 0000000..aa27f39 --- /dev/null +++ b/docs/news/index.html @@ -0,0 +1,237 @@ +<!DOCTYPE html> +<html lang="en"> +<head> +<!-- 2021-02-02 --> +<meta charset="utf-8"> +<meta name="viewport" content="width=device-width, initial-scale=1"> +<title>News Index</title> +<meta name="generator" content="Org mode"> +<link rel="stylesheet" type="text/css" href="/style.css"> +</head> +<body> +<div id="preamble" class="status"> +<nav id="navbar"> + <a href="/" class=navbartitle>Carbs Linux</a> + + <label for="hamburger">☰</label> + <input type="checkbox" id="hamburger" /> + <ul id=navbarlist> + <li><a href="/" title="Home Page">Home</a></li> + <li><a href="//git.carbslinux.org" title="Git Repository">Git</a></li> + <li><a href="/download.html" title="Download Carbs Linux">Download</a></li> + <li><a href="/blog" title="Blog Posts">Blog</a></li> + <li><a href="/install.html" title="Installation Instructions">Installation</a></li> + <li><a href="/docs.html" title="Documentation">Docs</a></li> + </ul> +</nav> +</div> +<div id="content"> +<header> +<h1 class="title">News Index</h1> +</header> +<div id="outline-container-org3c9305c" class="outline-2"> +<h2 id="org3c9305c"><a href="20200916.html">Sep 16, 2020</a></h2> +<div class="outline-text-2" id="text-org3c9305c"> +<p> +The libressl "revert" was reverted. System update will replace libressl +dependencies with bearssl. You may choose to keep or remove bearssl after the +update. +</p> +</div> +</div> +<div id="outline-container-orgad2f743" class="outline-2"> +<h2 id="orgad2f743"><a href="20200903.html">Sep 03, 2020</a></h2> +<div class="outline-text-2" id="text-orgad2f743"> +<p> +The default TLS provider has been reverted to <code>libressl</code>. System update will +replace bearssl dependencies with libressl. You may choose to keep or remove +bearssl after the update. +</p> +</div> +</div> +<div id="outline-container-orgbf4a227" class="outline-2"> +<h2 id="orgbf4a227"><a href="20200727.html">Jul 27, 2020</a></h2> +<div class="outline-text-2" id="text-orgbf4a227"> +<p> +Carbs Linux's fork of the <code>kiss</code> package manager has been renamed to <code>Carbs + Packaging Tools</code> due to huge amount of changes. Your latest <code>kiss</code> update will +handle the bootstrapping. You will need to rename your <code>KISS-*</code> variables to +<code>CPT-*</code>. +</p> +</div> +</div> +<div id="outline-container-org96916e3" class="outline-2"> +<h2 id="org96916e3"><a href="20200617.html">Jun 17, 2020</a></h2> +<div class="outline-text-2" id="text-org96916e3"> +<p> +A new rootfs tarball including the changes to the core is released and can be +found on the downloads page. +</p> +</div> +</div> +<div id="outline-container-org8d83def" class="outline-2"> +<h2 id="org8d83def"><a href="20200526.html">May 26, 2020</a></h2> +<div class="outline-text-2" id="text-org8d83def"> +<p> +An initial version for binary package management is released. It can be found on +the <a href="https://github.com/CarbsLinux/kiss-bin">GitHub page</a>. +</p> +</div> +</div> +<div id="outline-container-org860ded3" class="outline-2"> +<h2 id="org860ded3"><a href="20200519.html">May 19, 2020</a></h2> +<div class="outline-text-2" id="text-org860ded3"> +<p> +A rootfs tarball targeting the i686 architecture has been released. It can be +found on the downloads page. +</p> +</div> +</div> +<div id="outline-container-org912039c" class="outline-2"> +<h2 id="org912039c"><a href="20200510.html">May 10, 2020</a></h2> +<div class="outline-text-2" id="text-org912039c"> +<p> +A GCC 10.1.0 change causes a kernel panic for kernels built with GCC 10.1. This +issue can be resolved by applying this <a href="https://git.kernel.org/pub/scm/linux/kernel/git/tip/tip.git/patch/?id=f670269a42bfdd2c83a1118cc3d1b475547eac22">patch</a> to your kernel sources. +</p> + +<p> +<b><b>EDIT:</b></b> The patch is no longer necessary. +</p> +</div> +</div> +<div id="outline-container-org908d8bd" class="outline-2"> +<h2 id="org908d8bd"><a href="20200427.html">Apr 27, 2020</a></h2> +<div class="outline-text-2" id="text-org908d8bd"> +<p> +A new rootfs tarball has been released! You can see it on +<a href="https://dl.carbslinux.org/releases">https://dl.carbslinux.org/releases</a>! +</p> + +<p> +<b><b>EDIT:</b></b> A new bug fix release has been made. +</p> +</div> +</div> +<div id="outline-container-org7b5abe2" class="outline-2"> +<h2 id="org7b5abe2"><a href="20200410.html">Apr 10, 2020</a></h2> +<div class="outline-text-2" id="text-org7b5abe2"> +<p> +IRC channel can now be accessed from <code>#carbslinux</code> at freenode! +</p> +</div> +</div> +<div id="outline-container-org12491b8" class="outline-2"> +<h2 id="org12491b8"><a href="20200406.html">Apr 06, 2020</a></h2> +<div class="outline-text-2" id="text-org12491b8"> +<p> +A new rootfs tarball has been released. See the downloads page. +</p> +</div> +</div> +<div id="outline-container-orge4410d2" class="outline-2"> +<h2 id="orge4410d2"><a href="20200405.html">Apr 05, 2020</a></h2> +<div class="outline-text-2" id="text-orge4410d2"> +<p> +Carbs Linux repositories will be hosted only on Github. Commits will be pushed +there, and not the repository. You have until May 4, 2020 Monday to switch your +remotes to <a href="https://github.com/CarbsLinux/repository">https://github.com/CarbsLinux/repository</a>. The git repository will +continue to be served until then (without additional commits). +</p> + +<p> +You can switch your remote by executing the following command on your repository +directory. +</p> + +<div class="org-src-container"> +<pre class="src src-sh">git remote set-url origin https://github.com/CarbsLinux/repository +</pre> +</div> +</div> +</div> +<div id="outline-container-orgc0fb865" class="outline-2"> +<h2 id="orgc0fb865"><a href="20200218.html">Feb 18, 2020</a></h2> +<div class="outline-text-2" id="text-orgc0fb865"> +<p> +A new tarball is released. It can be found on <a href="https://dl.carbslinux.org">https://dl.carbslinux.org</a>. +</p> + +<p> +<b><b>edit:</b></b> I have removed the tarball because of a bootstrapping issue. I will be +re-adding it later today. +</p> + +<p> +<b><b>edit 2:</b></b> I have added a tarball (20200219) to reflect my recent changes on +Busybox. +</p> +</div> +</div> +<div id="outline-container-org84ca12e" class="outline-2"> +<h2 id="org84ca12e"><a href="20200214.html">Feb 14, 2020</a></h2> +<div class="outline-text-2" id="text-org84ca12e"> +<p> +<b><b>IMPORTANT!</b></b> Carbs-init update to be released on 17th of February +will require manual intervention. I am holding this update back so +people can see it before they update their system (even though the +update will show the same message as this). The rationale for the +update is explained below the intervention. +</p> + +<div class="org-src-container"> +<pre class="src src-sh"><span class="org-comment-delimiter"># </span><span class="org-comment">There is an explanation for each init You only need to follow the instructions</span> +<span class="org-comment-delimiter"># </span><span class="org-comment">for your own init-system</span> + +<span class="org-comment-delimiter">## </span><span class="org-comment">busybox-init</span> +<span class="org-comment-delimiter"># </span><span class="org-comment">If you did not edit your inittab simply move inittab.new to inittab</span> +mv /etc/inittab.new /etc/inittab + +<span class="org-comment-delimiter"># </span><span class="org-comment">If you did edit your inittab you can use a simple sed command to remove the</span> +<span class="org-comment-delimiter"># </span><span class="org-comment">necessary lines</span> +sed -i <span class="org-string">'/getty/d;/runsvdir/d'</span> /etc/inittab + + +<span class="org-comment-delimiter">## </span><span class="org-comment">runit</span> +<span class="org-comment-delimiter"># </span><span class="org-comment">same as busybox-init, if you did not edit /etc/runit/2 move 2.new to 2</span> +mv /etc/runit/2.new /etc/runit/2 + +<span class="org-comment-delimiter"># </span><span class="org-comment">else</span> +vim /etc/runit/2 +<span class="org-comment-delimiter"># </span><span class="org-comment">open your 2 file and remove the for loop containing getty commands. If you are</span> +<span class="org-comment-delimiter"># </span><span class="org-comment">using runit, it is recommended to comment out /etc/init/runit.boot</span> + +<span class="org-comment-delimiter">## </span><span class="org-comment">sinit/minit</span> +<span class="org-comment-delimiter"># </span><span class="org-comment">If you did not edit your {sinit-,}launch-services.boot you can simply remove</span> +<span class="org-comment-delimiter"># </span><span class="org-comment">it.</span> +rm -f /etc/init/launch-services.boot /etc/init/sinit-launch-services.boot + +<span class="org-comment-delimiter"># </span><span class="org-comment">This should leave you without any issues, and you can safely reboot.</span> +</pre> +</div> + +<p> +Carbs-init update is to make sure init systems do not clash, and do +not have to use different files. This is a sensible update both for +the user user and for the maintainer side. +</p> + +<p> +To give an example, before this update busybox-init was managing getty +through <code>inittab</code>, runit was managing through <code>/etc/runit/2</code>, and +minit/sinit were launching from <code>/etc/init/launch-services.boot</code>. This +is a configuration nightmare for everyone, and since I am maintaining +and constantly testing those init providers, a huge nightmare for me. +This is a Quality of Life update. +</p> +</div> +</div> +</div> +<div id="postamble" class="status"> +<footer> + <p>Linux® is a registered trademark of Linus Torvalds</p> + <p>Copyright © 2019-2021 Cem Keylan</p> +</footer> +</div> +</body> +</html> diff --git a/docs/news/index.txt b/docs/news/index.txt new file mode 100644 index 0000000..3f1a3b9 --- /dev/null +++ b/docs/news/index.txt @@ -0,0 +1,209 @@ + ____________ + + NEWS INDEX + ____________ + + + + + +[Sep 16, 2020] +============== + + The libressl "revert" was reverted. System update will replace + libressl dependencies with bearssl. You may choose to keep or remove + bearssl after the update. + + +[Sep 16, 2020] <file:20200916.html> + + +[Sep 03, 2020] +============== + + The default TLS provider has been reverted to `libressl'. System + update will replace bearssl dependencies with libressl. You may choose + to keep or remove bearssl after the update. + + +[Sep 03, 2020] <file:20200903.html> + + +[Jul 27, 2020] +============== + + Carbs Linux's fork of the `kiss' package manager has been renamed to + `Carbs Packaging Tools' due to huge amount of changes. Your latest + `kiss' update will handle the bootstrapping. You will need to rename + your `KISS-*' variables to `CPT-*'. + + +[Jul 27, 2020] <file:20200727.html> + + +[Jun 17, 2020] +============== + + A new rootfs tarball including the changes to the core is released and + can be found on the downloads page. + + +[Jun 17, 2020] <file:20200617.html> + + +[May 26, 2020] +============== + + An initial version for binary package management is released. It can + be found on the [GitHub page]. + + +[May 26, 2020] <file:20200526.html> + +[GitHub page] <https://github.com/CarbsLinux/kiss-bin> + + +[May 19, 2020] +============== + + A rootfs tarball targeting the i686 architecture has been released. It + can be found on the downloads page. + + +[May 19, 2020] <file:20200519.html> + + +[May 10, 2020] +============== + + A GCC 10.1.0 change causes a kernel panic for kernels built with GCC + 10.1. This issue can be resolved by applying this [patch] to your + kernel sources. + + **EDIT:** The patch is no longer necessary. + + +[May 10, 2020] <file:20200510.html> + +[patch] +<https://git.kernel.org/pub/scm/linux/kernel/git/tip/tip.git/patch/?id=f670269a42bfdd2c83a1118cc3d1b475547eac22> + + +[Apr 27, 2020] +============== + + A new rootfs tarball has been released! You can see it on + <https://dl.carbslinux.org/releases>! + + **EDIT:** A new bug fix release has been made. + + +[Apr 27, 2020] <file:20200427.html> + + +[Apr 10, 2020] +============== + + IRC channel can now be accessed from `#carbslinux' at freenode! + + +[Apr 10, 2020] <file:20200410.html> + + +[Apr 06, 2020] +============== + + A new rootfs tarball has been released. See the downloads page. + + +[Apr 06, 2020] <file:20200406.html> + + +[Apr 05, 2020] +============== + + Carbs Linux repositories will be hosted only on Github. Commits will + be pushed there, and not the repository. You have until May 4, 2020 + Monday to switch your remotes to + <https://github.com/CarbsLinux/repository>. The git repository will + continue to be served until then (without additional commits). + + You can switch your remote by executing the following command on your + repository directory. + + ,---- + | git remote set-url origin https://github.com/CarbsLinux/repository + `---- + + +[Apr 05, 2020] <file:20200405.html> + + +[Feb 18, 2020] +============== + + A new tarball is released. It can be found on + <https://dl.carbslinux.org>. + + **edit:** I have removed the tarball because of a bootstrapping + issue. I will be re-adding it later today. + + **edit 2:** I have added a tarball (20200219) to reflect my recent + changes on Busybox. + + +[Feb 18, 2020] <file:20200218.html> + + +[Feb 14, 2020] +============== + + **IMPORTANT!** Carbs-init update to be released on 17th of February + will require manual intervention. I am holding this update back so + people can see it before they update their system (even though the + update will show the same message as this). The rationale for the + update is explained below the intervention. + + ,---- + | # There is an explanation for each init You only need to follow the instructions + | # for your own init-system + | + | ## busybox-init + | # If you did not edit your inittab simply move inittab.new to inittab + | mv /etc/inittab.new /etc/inittab + | + | # If you did edit your inittab you can use a simple sed command to remove the + | # necessary lines + | sed -i '/getty/d;/runsvdir/d' /etc/inittab + | + | + | ## runit + | # same as busybox-init, if you did not edit /etc/runit/2 move 2.new to 2 + | mv /etc/runit/2.new /etc/runit/2 + | + | # else + | vim /etc/runit/2 + | # open your 2 file and remove the for loop containing getty commands. If you are + | # using runit, it is recommended to comment out /etc/init/runit.boot + | + | ## sinit/minit + | # If you did not edit your {sinit-,}launch-services.boot you can simply remove + | # it. + | rm -f /etc/init/launch-services.boot /etc/init/sinit-launch-services.boot + | + | # This should leave you without any issues, and you can safely reboot. + `---- + + Carbs-init update is to make sure init systems do not clash, and do + not have to use different files. This is a sensible update both for + the user user and for the maintainer side. + + To give an example, before this update busybox-init was managing getty + through `inittab', runit was managing through `/etc/runit/2', and + minit/sinit were launching from `/etc/init/launch-services.boot'. This + is a configuration nightmare for everyone, and since I am maintaining + and constantly testing those init providers, a huge nightmare for me. + This is a Quality of Life update. + + +[Feb 14, 2020] <file:20200214.html> diff --git a/docs/people.html b/docs/people.html index cb72ab5..669a923 100644 --- a/docs/people.html +++ b/docs/people.html @@ -1,33 +1,46 @@ -<!DOCTYPE HTML> -<html lan=en> - <head> - <title>People | Carbs Linux</title> - <link rel="stylesheet" href="/style.css"> - <meta charset="utf-8"> - <meta name="Description" content="Carbs Linux - a simple linux distribution"> - <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no"> - </head> - <body> - <p class=header><strong>Carbs Linux - a simple linux distribution</strong></p> - <div class="header"> - <nav> - <a href='/'>index</a> - <a href="//git.carbslinux.org">git</a> - <a href='//dl.carbslinux.org'>downloads</a> - <a href='/blog'>blog</a> - <a href='/docs/install.html'>installation</a> - <a href='/docs'>user manual</a> - </nav> - </div><div class="border"></div> -<h1>People</h1> +<!DOCTYPE html> +<html lang="en"> +<head> +<!-- 2021-02-02 --> +<meta charset="utf-8"> +<meta name="viewport" content="width=device-width, initial-scale=1"> +<title>‎</title> +<meta name="generator" content="Org mode"> +<meta name="author" content="Cem Keylan"> +<link rel="stylesheet" type="text/css" href="/style.css"> +</head> +<body> +<div id="preamble" class="status"> +<nav id="navbar"> + <a href="/" class=navbartitle>Carbs Linux</a> -<ul> -<li>Cem Keylan - Founder <a href="mailto:cem@ckyln.com">cem@ckyln.com</a></li> + <label for="hamburger">☰</label> + <input type="checkbox" id="hamburger" /> + <ul id=navbarlist> + <li><a href="/" title="Home Page">Home</a></li> + <li><a href="//git.carbslinux.org" title="Git Repository">Git</a></li> + <li><a href="/download.html" title="Download Carbs Linux">Download</a></li> + <li><a href="/blog" title="Blog Posts">Blog</a></li> + <li><a href="/install.html" title="Installation Instructions">Installation</a></li> + <li><a href="/docs.html" title="Documentation">Docs</a></li> + </ul> +</nav> +</div> +<div id="content"> +<div id="outline-container-orgbd0bbd2" class="outline-2"> +<h2 id="orgbd0bbd2">People</h2> +<div class="outline-text-2" id="text-orgbd0bbd2"> +<ul class="org-ul"> +<li>Cem Keylan - Founder <a href="mailto:cem@carbslinux.org">cem@carbslinux.org</a></li> </ul> - - <a href="/people.txt">View Page Source</a> - <div class="border"></div> - <p class=footer>Linux® is a registered trademark of Linus Torvalds</p> - <p class=footer>Copyright © 2019-2021 Cem Keylan</p> - </body> +</div> +</div> +</div> +<div id="postamble" class="status"> +<footer> + <p>Linux® is a registered trademark of Linus Torvalds</p> + <p>Copyright © 2019-2021 Cem Keylan</p> +</footer> +</div> +</body> </html> diff --git a/docs/people.txt b/docs/people.txt index 4d7c7af..9d17718 100644 --- a/docs/people.txt +++ b/docs/people.txt @@ -1,3 +1,7 @@ People ====== -* Cem Keylan - Founder [cem@ckyln.com](mailto:cem@ckyln.com) + + - Cem Keylan - Founder [cem@carbslinux.org] + + +[cem@carbslinux.org] <mailto:cem@carbslinux.org> diff --git a/docs/rss.xml b/docs/rss.xml index e1f5cf2..76b18f0 100644 --- a/docs/rss.xml +++ b/docs/rss.xml @@ -1,497 +1,655 @@ -<?xml version="1.0" encoding="UTF-8"?> +<?xml version="1.0" encoding="utf-8"?> <rss version="2.0" - xmlns:atom="http://www.w3.org/2005/Atom" - xmlns:dc="http://purl.org/dc/elements/1.1/" - xmlns:sy="http://purl.org/rss/1.0/modules/syndication/" -> - <channel> - <title>Carbs Linux</title> - <description>a simple linux distribution</description> - <link>https://carbslinux.org</link> - <atom:link href="https://carbslinux.org/rss.xml" rel="self" type="application/rss+xml" /> - <lastBuildDate>Thu Jan 07 2021 11:00</lastBuildDate> -<item> -<title>First Year of Carbs Linux</title> -<pubDate>Thu, 10 Dec 2020</pubDate> -<dc:creator>Cem Keylan</dc:creator> -<link>https://carbslinux.org/blog/20201210.html</link> -<description><h1>First Year of Carbs Linux</h1> - -<p>December 10, 2020 marks the first year after the initial release of Carbs -Linux. When I forked the KISS Linux repository on the 9th of December, I was -fairly new to package management. Carbs Linux used to be almost identical to -KISS Linux. A lot has changed since then:</p> - -<ul> -<li>[2020 Jan 13] Replaced default init system to <code>sinit</code></li> -<li>[2020 Jan 15] Packaged <code>WebKit2GTK</code></li> -<li>[2020 May 17] Added <code>bearssl</code> on the testing repository</li> -<li>[2020 May 28] Added <code>rsync</code> repository support to kiss</li> -<li>[2020 Jun 03] Replaced <code>bison</code> with <code>byacc</code></li> -<li>[2020 Jun 11] Replaced <code>libressl</code> with <code>bearssl</code></li> -<li>[2020 Jun 24] Replaced <code>kiss</code> with <code>cpt</code></li> -</ul> - - -<p>I have really enjoyed maintaining and developing this distribution, and I want -to thank everyone who was involved in some way or another. While I have slowed -down in development due to college workload, I am still actively maintaining all -the packages on the repository. I do have some ideas that I am thinking of -implementing during the semester break. Hope to see you all in January.</p></description> + xmlns:content="http://purl.org/rss/1.0/modules/content/" + xmlns:wfw="http://wellformedweb.org/CommentAPI/" + xmlns:dc="http://purl.org/dc/elements/1.1/" + xmlns:atom="http://www.w3.org/2005/Atom" + xmlns:sy="http://purl.org/rss/1.0/modules/syndication/" + xmlns:slash="http://purl.org/rss/1.0/modules/slash/" + xmlns:georss="http://www.georss.org/georss" + xmlns:geo="http://www.w3.org/2003/01/geo/wgs84_pos#" + xmlns:media="http://search.yahoo.com/mrss/"><channel> + <title>Carbs Linux blog</title> + <atom:link href="https://carbslinux.org/blog/rss.xml" rel="self" type="application/rss+xml" /> + <link>https://carbslinux.org/blog</link> + <description><![CDATA[a simple Linux distribution]]></description> + <language>en</language> + <pubDate>Tue, 02 Feb 2021 03:33:03 +0300</pubDate> + <lastBuildDate>Tue, 02 Feb 2021 03:33:03 +0300</lastBuildDate> + <generator>Emacs 27.1 Org-mode 9.4.4</generator> + <webMaster>root@carbslinux.org (Cem Keylan)</webMaster> + <image> + <url>https://orgmode.org/img/org-mode-unicorn-logo.png</url> + <title>Carbs Linux blog</title> + <link>https://carbslinux.org/blog</link> + </image> + + + <item> + <title>First Year of Carbs Linux</title> + <link>https://carbslinux.org/blog/20201210.html</link> + <author>root@carbslinux.org (Cem Keylan)</author> + <guid isPermaLink="false">https://carbslinux.org/blog/20201210.html</guid> + <pubDate>Thu, 10 Dec 2020 00:00:00 +0300</pubDate> + + <description><![CDATA[<p> + December 10, 2020 marks the first year after the initial release of Carbs Linux. + When I forked the KISS Linux repository on the 9th of December, I was fairly new + to package management. Carbs Linux used to be almost identical to KISS Linux. A + lot has changed since then: + </p> + + <p> + [2020 Jan 13] Replaced default init system to <code>sinit</code> + [2020 Jan 15] Packaged <code>WebKit2GTK</code> + [2020 May 17] Added <code>bearssl</code> on the testing repository + [2020 May 28] Added <code>rsync</code> repository support to kiss + [2020 Jun 03] Replaced <code>bison</code> with <code>byacc</code> + [2020 Jun 11] Replaced <code>libressl</code> with <code>bearssl</code> + [2020 Jun 24] Replaced <code>kiss</code> with <code>cpt</code> + </p> + + <p> + I have really enjoyed maintaining and developing this distribution, and I want + to thank everyone who was involved in some way or another. While I have slowed + down in development due to college workload, I am still actively maintaining all + the packages on the repository. I do have some ideas that I am thinking of + implementing during the semester break. Hope to see you all in January. + </p> + ]]></description> + </item> + <item> + <title>August 2020 News Post</title> + <link>https://carbslinux.org/blog/20200803.html</link> + <author>root@carbslinux.org (Cem Keylan)</author> + <guid isPermaLink="false">https://carbslinux.org/blog/20200803.html</guid> + <pubDate>Mon, 03 Aug 2020 00:00:00 +0300</pubDate> + + <description><![CDATA[<p> + We are having some stalls during this summer, as I am currently working on + university-related stuff. Nonetheless, there are some important changes that I + want to share in this month's post. + </p> + + <div id="text-table-of-contents"> + <ul> + <li><a href="#org299451d">Carbs Packaging Tools</a></li> + <li><a href="#org40c97d9">Docs</a></li> + <li><a href="#orgab113c8">Re-opening the Carbs Linux server</a></li> + </ul> + </div> + + <div id="outline-container-org299451d" class="outline-3"> + <h3 id="org299451d">Carbs Packaging Tools</h3> + <div class="outline-text-3" id="text-org299451d"> + <p> + This month I have reworked <code>kiss</code> into a new package manager, now renamed as + <code>cpt</code>. Updating <code>kiss</code> will now bootstrap the new package manager, so you don't + have to manually edit your system. If you don't like the idea of this, you can + look up the <code>post-install</code> script on <code>core/kiss</code> and apply the changes manually. + </p> + + <p> + You will also need to rename your <code>KISS_*</code> variables to <code>CPT_*</code>. So, <code>KISS_PATH</code> + becomes <code>CPT_PATH</code>. + </p> + + <p> + The rework changes the previous commands on the package manager into standalone + tools, and move the package manager functions to a library. This makes it easier + for a user to import functions and variables from the package manager, and + extend the package manager with their own intended way. Previously this required + ugly hacks and workarounds to use the package manager functions. I will be + making use of these changes to re-implement binary package management functions + as well. + </p> + + <p> + If you want to use the library on your script you can simply do this: + </p> + + <div class="org-src-container"> + <pre class="src src-sh"><span class="org-comment-delimiter">#</span><span class="org-comment">!/bin/</span><span class="org-keyword">sh</span> + . cpt-lib + (...) + </pre> + </div> + + <p> + There are obviously some clean-up and simplifications needed in this new + tool-based package management method. + </p> + </div> + </div> + + <div id="outline-container-org40c97d9" class="outline-3"> + <h3 id="org40c97d9">Docs</h3> + <div class="outline-text-3" id="text-org40c97d9"> + <p> + I have added documentation for the distribution, and finally updated the guide + for installation. It is now <i>almost</i> complete. These docs can be installed to + your system for online viewing. I will also add a documentation crawler similar + to how werc works (but as an offline viewer). You can find <code>carbs-docs</code> from + the repository. Currently, the documentation lacks but I will be adding new + stuff. These will solely be distribution specific documentation and will not be + a wiki-like source. If anyone would like to contribute to a wiki-like + documentation source, I would happily re-open the distribution wiki. You can + find the source on <a href="https://github.com/CarbsLinux/docs">https://github.com/CarbsLinux/docs</a>. + </p> + </div> + </div> + + <div id="outline-container-orgab113c8" class="outline-3"> + <h3 id="orgab113c8">Re-opening the Carbs Linux server</h3> + <div class="outline-text-3" id="text-orgab113c8"> + <p> + Back in May, I had shutdown the Carbs Linux server due to financial issues, but + I am slowly reverting to the self-hosted model. Back then, the git repositories + were mirrored to GitHub, and the management was overall much more flexible. The + server used to run Carbs Linux as well (that was fun and horrifying at the same + time). Now, I will be relaunching the git server which will be the upstream + source before August 5. You can switch your remote, but GitHub will stay as a + remote nonetheless. + </p> + + <p> + <b>EDIT:</b> The git-server is up! + </p> + </div> + </div> + ]]></description> </item> <item> -<title>August 2020 News Post</title> -<pubDate>Mon, 03 Aug 2020</pubDate> -<dc:creator>Cem Keylan</dc:creator> -<link>https://carbslinux.org/blog/20200803.html</link> -<description><h1>August 2020 News Post</h1> - -<p>We are having some stalls during this summer, as I am currently working on -university-related stuff. Nonetheless, there are some important changes that I -want to share in this month&rsquo;s post.</p> - -<h2>INDEX</h2> - -<ul> -<li><a href="#carbs-packaging-tools">Carbs Packaging Tools</a></li> -<li><a href="#docs">Docs</a></li> -<li><a href="#re-opening-the-carbs-linux-server">Re-opening the Carbs Linux server</a></li> -</ul> - - -<h2>Carbs Packaging Tools</h2> - -<p>This month I have reworked <code>kiss</code> into a new package manager, now renamed as -<code>cpt</code>. Updating <code>kiss</code> will now bootstrap the new package manager, so you don&rsquo;t -have to manually edit your system. If you don&rsquo;t like the idea of this, you can -look up the <code>post-install</code> script on <code>core/kiss</code> and apply the changes manually.</p> - -<p>You will also need to rename your KISS<em>* variables to CPT</em>*. So, KISS_PATH -becomes CPT_PATH.</p> - -<p>The rework changes the previous commands on the package manager into standalone -tools, and move the package manager functions to a library. This makes it easier -for a user to import functions and variables from the package manager, and -extend the package manager with their own intended way. Previously this required -ugly hacks and workarounds to use the package manager functions. I will be -making use of these changes to re-implement binary package management functions -as well.</p> - -<p>If you want to use the library on your script you can simply do this:</p> - -<pre><code>+--------------------------------------------------------------------------+ -| | -| #!/bin/sh | -| . cpt-lib | -| (...) | -| | -+--------------------------------------------------------------------------+ -</code></pre> - -<p>There are obviously some clean-up and simplifications needed in this new -tool-based package management method.</p> - -<h2>Docs</h2> - -<p>I have added documentation for the distribution, and finally updated the guide -for installation. It is now <em>almost</em> complete. These docs can be installed to -your system for online viewing. I will also add a documentation crawler similar -to how werc<a href="http://werc.cat-v.org">^1</a> works (but as an offline viewer). You can find <code>carbs-docs</code> from -the repository. Currently, the documentation lacks but I will be adding new -stuff. These will solely be distribution specific documentation and will not be -a wiki-like source. If anyone would like to contribute to a wiki-like -documentation source, I would happily re-open the distribution wiki. You can -find the source on https://github.com/CarbsLinux/docs</p> - -<h2>Re-opening the Carbs Linux server</h2> - -<p>Back in May, I had shutdown the Carbs Linux server due to financial issues, but -I am slowly reverting to the self-hosted model. Back then, the git repositories -were mirrored to GitHub, and the management was overall much more flexible. The -server used to run Carbs Linux as well (that was fun and horrifying at the same -time). Now, I will be relaunching the git server which will be the upstream -source before August 5. You can switch your remote, but GitHub will stay as a -remote nonetheless.</p> - -<p>EDIT: The git-server is up!</p></description> + <title>June Newspost</title> + <link>https://carbslinux.org/blog/20200617.html</link> + <author>root@carbslinux.org (Cem Keylan)</author> + <guid isPermaLink="false">https://carbslinux.org/blog/20200617.html</guid> + <pubDate>Wed, 17 Jun 2020 00:00:00 +0300</pubDate> + + <description><![CDATA[<p> + This will be an active month for Carbs as major changes to the base and the + package manager will be coming up. + </p> + + <div id="outline-container-orga59e7f7" class="outline-3"> + <h3 id="orga59e7f7">Statically linking the base</h3> + <div class="outline-text-3" id="text-orga59e7f7"> + <p> + For the past couple of weeks I have been trying to simplify the base and + statically link the core (mostly binaries rather than libraries). I usually see + some people extremely opposed to static linking as I also see the opposite on + people. + </p> + + <p> + I believe that binaries on the core should always be linked statically. This + ensures that an SONAME bump to <code>libObscure.so</code> will not break the core + functionality of your system, forcing you to use external resources to recover + from such an issue. As long as you can compile, use core utilities, edit text, + and access the web, you can solve any given issue on your system. + </p> + + <p> + However, I don't think that removing shared libraries is sensible either. Not + every piece of software out there is good quality enough to be statically + linked. + </p> + </div> + </div> + + <div id="outline-container-orgc95a1ff" class="outline-3"> + <h3 id="orgc95a1ff">Major changes on the core repository</h3> + <div class="outline-text-3" id="text-orgc95a1ff"> + <p> + There have been drastic changes to the core repository and the base rootfs this + month (with more on the way). Right now changes are as follows. + </p> + </div> + + <div id="outline-container-orge61ce8f" class="outline-4"> + <h4 id="orge61ce8f">Removed from Core</h4> + <div class="outline-text-4" id="text-orge61ce8f"> + <p> + <code>git</code> + <code>libressl</code> + <code>grub</code> + <code>bison</code> + <code>dhcpcd</code> + <code>ubase</code> + </p> + </div> + </div> + + <div id="outline-container-orge4e0922" class="outline-4"> + <h4 id="orge4e0922">Added to Core</h4> + <div class="outline-text-4" id="text-orge4e0922"> + <p> + <code>bearssl</code>, as a <code>libressl</code> replacement + <code>byacc</code>, as a <code>bison</code> replacement + </p> + </div> + </div> + + <div id="outline-container-org59875c0" class="outline-4"> + <h4 id="org59875c0">Statically linked</h4> + <div class="outline-text-4" id="text-org59875c0"> + <p> + <code>kiss</code> + <code>neatvi</code> + <code>mandoc</code> + <code>byacc</code> + <code>m4</code> + <code>e2fsprogs</code> + <code>make</code> + <code>pkgconf</code> + <code>sbase</code> + <code>libnl</code> + <code>wpa_supplicant</code> + <code>bearssl</code> + </p> + </div> + </div> + </div> + + <div id="outline-container-org0e61066" class="outline-3"> + <h3 id="org0e61066">Making the wiki available offline</h3> + <div class="outline-text-3" id="text-org0e61066"> + <p> + Soon, all documentation regarding Carbs Linux will be avaialable to be installed + from the core repository in a <code>carbs-docs</code> package along with its own document + crawler. Currently, the documentation regarding the installation process is a + little outdated which will also receive some important updates. + </p> + </div> + </div> + + <div id="outline-container-org591578d" class="outline-3"> + <h3 id="org591578d">ISO image for Carbs</h3> + <div class="outline-text-3" id="text-org591578d"> + <p> + I am thinking of releasing an ISO image in order to provide a standardized + environment for installation along with installation helper tools in the spirit + of <code>arch-install-scripts</code>. Let's see how that's going to play out. + </p> + </div> + </div> + ]]></description> </item> <item> -<title>June Newspost</title> -<pubDate>Wed, 17 Jun 2020</pubDate> -<dc:creator>Cem Keylan</dc:creator> -<link>https://carbslinux.org/blog/20200617.html</link> -<description><h1>June Newspost</h1> - -<p>This will be an active month for Carbs as major changes to the base and the -package manager will be coming up.</p> - -<h2>Statically linking the base</h2> - -<p>For the past couple of weeks I have been trying to simplify the base and -statically link the core (mostly binaries rather than libraries). I usually see -some people extremely opposed to static linking as I also see the opposite on -people.</p> - -<p>I believe that binaries on the core should always be linked statically. This -ensures that an SONAME bump to <code>libObscure.so</code> will not break the core -functionality of your system, forcing you to use external resources to recover -from such an issue. As long as you can compile, use core utilities, edit text, -and access the web, you can solve any given issue on your system.</p> - -<p>However, I don&rsquo;t think that removing shared libraries is sensible either. Not -every piece of software out there is good quality enough to be statically -linked.</p> - -<h2>Major changes on the core repository</h2> - -<p>There have been drastic changes to the core repository and the base rootfs this -month (with more on the way). Right now changes are as follows.</p> - -<h3>Removed from Core</h3> - -<ul> -<li><code>git</code></li> -<li><code>libressl</code></li> -<li><code>grub</code></li> -<li><code>bison</code></li> -<li><code>dhcpcd</code></li> -<li><code>ubase</code></li> -</ul> - - -<h3>Added to Core</h3> - -<ul> -<li><code>bearssl</code>, as a <code>libressl</code> replacement</li> -<li><code>byacc</code>, as a <code>bison</code> replacement</li> -</ul> - - -<h3>Statically linked</h3> - -<ul> -<li><code>kiss</code></li> -<li><code>neatvi</code></li> -<li><code>mandoc</code></li> -<li><code>byacc</code></li> -<li><code>m4</code></li> -<li><code>e2fsprogs</code></li> -<li><code>make</code></li> -<li><code>pkgconf</code></li> -<li><code>sbase</code></li> -<li><code>libnl</code></li> -<li><code>wpa_supplicant</code></li> -<li><code>bearssl</code></li> -</ul> - - -<h2>Making the wiki available offline</h2> - -<p>Soon, all documentation regarding Carbs Linux will be avaialable to be installed -from the core repository in a <code>carbs-docs</code> package along with its own document -crawler. Currently, the documentation regarding the installation process is a -little outdated which will also receive some important updates.</p> - -<h2>ISO image for Carbs</h2> - -<p>I am thinking of releasing an ISO image in order to provide a standardized -environment for installation along with installation helper tools in the spirit -of <code>arch-install-scripts</code>. Let&rsquo;s see how that&rsquo;s going to play out.</p></description> + <title>kiss 2.0.0 and Overall Changes</title> + <link>https://carbslinux.org/blog/20200528.html</link> + <author>root@carbslinux.org (Cem Keylan)</author> + <guid isPermaLink="false">https://carbslinux.org/blog/20200528.html</guid> + <pubDate>Thu, 28 May 2020 00:00:00 +0300</pubDate> + + <description><![CDATA[<p> + Carbs Linux kiss version 2.0.0 has been released which introduces rsync + repositories. + </p> + + <p> + Git is no longer a mandatory dependency for the package manager, every git + source on the core repository has been replaced with https sources (sbase, + sinit), and rootfs tarballs will no longer ship with git. Repositories in the + upcoming tarball will be rsync repositories. + </p> + + <p> + Git is now on the <code>extra</code> repository and is still (optionally) used in the + package manager. + </p> + + <p> + The idea behind this change is size reductions and increased speed with rsync. + As I said on the previous post, git repositories get larger and larger over the + time span. Currently my personal copy of the git repository is around 77MB and I + have forked KISS Linux (as a shallow copy) around December. Obviously, I have + commits that I ommitted. I tend to create commits I dislike, which I change with + <code>git reset --soft HEAD^</code>, which doesn't actually remove the commits, etc. A user + will have a repository much smaller than mine. + </p> + + <p> + This is a precaution with the added bonuses of speed and dropping a mandatory + dependency. + </p> + + <p> + You can see the rest of the changelog <a href="https://github.com/CarbsLinux/kiss/blob/master/CHANGELOG.md">here</a>. + </p> + + <div id="outline-container-org70a8589" class="outline-3"> + <h3 id="org70a8589">Binary Repositories</h3> + <div class="outline-text-3" id="text-org70a8589"> + <p> + A few days ago, I have also published <a href="https://github.com/CarbsLinux/kiss-bin">kiss-bin</a>, a first version for managing + binary repositories. Currently, there are some caveats that I'll be fixing along + the way. I decided not to include this in the package manager natively as + managing the source based and binary based packages together adds levels of + complexity that we do not want. Instead, this is an extension for kiss which + sources the package manager as a library. I hope to see it being adopted by + others interested on the matter as well. + </p> + </div> + </div> + ]]></description> </item> <item> -<title>kiss 2.0.0 and overall changes</title> -<pubDate>Thu, 28 May 2020</pubDate> -<dc:creator>Cem Keylan</dc:creator> -<link>https://carbslinux.org/blog/20200528.html</link> -<description><h1>kiss 2.0.0 and overall changes</h1> - -<p>Carbs Linux kiss version 2.0.0 has been released which introduces -rsync repositories.</p> - -<p>Git is no longer a mandatory dependency for the package manager, -every git source on the core repository has been replaced with -https sources (sbase, sinit), and rootfs tarballs will no longer -ship with git. Repositories in the upcoming tarball will be rsync -repositories.</p> - -<p>Git is now on the <code>extra</code> repository and is still (optionally) -used in the package manager.</p> - -<p>The idea behind this change is size reductions and increased -speed with rsync. As I said on the previous post, git repositories -get larger and larger over the time span. Currently my personal -copy of the git repository is around 77MB and I have forked KISS -Linux (as a shallow copy) around December. Obviously, I have commits -that I ommitted. I tend to create commits I dislike, which I change -with &lsquo;git reset &ndash;soft HEAD^&rsquo;, which doesn&rsquo;t actually remove the -commits, etc. A user will have a repository much smaller than mine.</p> - -<p>This is a precaution with the added bonuses of speed and dropping a -mandatory dependency.</p> - -<p>You can see the rest of the changelog <a href="https://github.com/CarbsLinux/kiss/blob/master/CHANGELOG.md">here</a>.</p> - -<h2>Binary Repositories</h2> - -<p>A few days ago, I have also published <a href="https://github.com/CarbsLinux/kiss-bin">kiss-bin</a>, a first version -for managing binary repositories. Currently, there are some caveats -that I&rsquo;ll be fixing along the way. I decided not to include this -in the package manager natively as managing the source based and -binary based packages together adds levels of complexity that we -do not want. Instead, this is an extension for kiss which sources -the package manager as a library. I hope to see it being adopted -by others interested on the matter as well.</p> - -<p>That&rsquo;s about it.</p> - -<p>Cheers, -Cem</p></description> + <title>The Relation of Carbs and KISS</title> + <link>https://carbslinux.org/blog/20200508.html</link> + <author>root@carbslinux.org (Cem Keylan)</author> + <guid isPermaLink="false">https://carbslinux.org/blog/20200508.html</guid> + <pubDate>Fri, 08 May 2020 00:00:00 +0300</pubDate> + + <description><![CDATA[<p> + Since I have forked KISS, I have received many questions that can be summarized + as "Why?". I have realized that I never truly answered this question. That's the + reason I am writing this post, to give some background on Carbs, and some + differences between KISS Linux and Carbs Linux for anyone who may be wondering. + Perhaps I could make this a "FAQ" page later on. + </p> + + <div id="outline-container-org6c3d819" class="outline-3"> + <h3 id="org6c3d819">History</h3> + <div class="outline-text-3" id="text-org6c3d819"> + <p> + I had the idea of creating my own Linux distribution since the May of 2019. Back + then, I had my own <a href="https://linuxfromscratch.org">Linux from Scratch</a> build, and I wanted to slim it down my + own way and replace the software (with musl,sbase,etc.). The name Carbs Linux + was in my mind since then. I wanted to write my own package manager, but I + wasn't satisfied with anything I had built. + </p> + + <p> + I had written some incomplete package managers (all named <code>fat</code>) and I quickly + threw them into the trash can, where they honestly belonged. I would want to + share them with you for laughs, but my hard-drive got wiped and I have a problem + of not doing an "initial commit" until a program I write is in a usable state. + </p> + + <p> + I have obtained the 'carbslinux.org' domain name in September 2019, but then + life got on the way, and I stopped for a long time. + </p> + + <p> + One day on Reddit, I saw Dylan's post on <a href="https://reddit.com/r/unixporn">r/unixporn</a> about KISS, and I really + thought that it was interesting. Here is my <a href="https://www.reddit.com/r/unixporn/comments/ducd34/sowm_kiss_d/f7lua7x">comment</a> to Dylan on that post. I + checked out the package manager and the repository. The packaging system was + extremely clean and well-thought. I decided to give it a go and fork KISS. + </p> + </div> + </div> + + <div id="outline-container-orgc4ee986" class="outline-3"> + <h3 id="orgc4ee986">Differences between KISS and Carbs</h3> + <div class="outline-text-3" id="text-orgc4ee986"> + <p> + Now, I still baffle when people ask me this question. My intention was never to + create a distribution with specific differences between KISS. My intention was + being my own BDFL of a distribution I maintain. There are lots of differences + between the main repositories, but they are subtle and not worth talking about. + I personally never even installed KISS Linux on my system. So Carbs, isn't + something like a downstream fork of KISS, it is just a distribution that was + initially based on KISS. + </p> + + <p> + I try to contribute as much as I can to KISS Linux. I think that it is a + brilliant distribution, and it was a great starting point for Carbs. I am really + grateful to Dylan and all the other contributors. + </p> + </div> + </div> + + <div id="outline-container-org5736e5e" class="outline-3"> + <h3 id="org5736e5e">What I'm working on now</h3> + <div class="outline-text-3" id="text-org5736e5e"> + <p> + Currently I have a few projects that I'm working on for Carbs. These are, + </p> + + <p> + A BSD port for Carbs. For a while, I have been working on BSD compatibility on + my fork of the [package manager]. I have tested, without any more issues, on + OpenBSD and FreeBSD. The biggest issues remaining are choosing a vendor for BSD, + packaging the BSD source, and providing a minimal base (like busybox for BSD). + If you aren't familiar with BSD, it has a single source code for all of the + utilities (kernel, command line programs, etc.). Contributions (even chipping in + ideas) are very welcome. + </p> + + <p> + Adding binary package distribution support natively to the package manager. + Biggest issue in small/old computers are compile times. This feature is for the + bigger packages such as webkit, clang, llvm that take a considerable amount of + time. Some computers with low memories cannot even compile firefox/webkit. + </p> + + <p> + Adding rsync repository support to the package manager. This is not a current + issue, but rather a futureproofing. As time passes, distribution repositories + grow larger. KISS and Carbs are young distributions without this problem right + now. But in something like 5 years, this size will presumably increase to + hundreds of megabytes. At that point it will be pointless to have the repository + sources unless you specifically need them. + </p> + </div> + </div> + + <div id="outline-container-orga98fc37" class="outline-3"> + <h3 id="orga98fc37">What's up with all the init/service daemons?</h3> + <div class="outline-text-3" id="text-orga98fc37"> + <p> + If you have ever checked the <a href="https://github.com/carbslinux/repository">repository</a>, you may have noticed that there are + lots of init/service related packages. I have had my fair share of time with all + of them, and it is an area that I am really interested in. I have even written + my own <a href="https://github.com/cemkeylan/shinit">init daemon</a> and <a href="https://github.com/cemkeylan/sysmgr">service supervisor</a>. I maintain all those packages on KISS + Community Repository as well with the exception of busybox. Those are, <code>busybox + init/runit</code>, <code>runit</code>, <code>sinit</code>, and <code>sysmgr</code>. I would definitely recommend + checking out <code>shinit</code> and <code>sysmgr</code>. + </p> + </div> + </div> + + <div id="outline-container-orgeb4597c" class="outline-3"> + <h3 id="orgeb4597c">Why I don't publicize Carbs</h3> + <div class="outline-text-3" id="text-orgeb4597c"> + <p> + There are a couple of reasons I don't publicize Carbs a lot. + </p> + + <p> + KISS is the better alternative in terms of support and community. I work on + maintaining this distribution just as hard as Dylan, but in the end, Carbs is + based on his original hard work, and I believe that he deserves the recognition + more than I do. + </p> + + <p> + Since I cannot answer questions like "What is the difference?", I prefer staying + as the silent sibling project of KISS Linux. Plus, there is no point in dividing + the newly-emerging community in half. + </p> + + <p> + That's not because I don't have ideas for the future of Carbs, I do. I just + think that I will deserve the recognition once those above lists are checked. + </p> + + <p> + I think that's about it, if you have questions you can send me a mail, ping me + on IRC (my handle is <code>merakor</code>), and I will be happy to answer. Maybe your + question fits this post, and I can update it to thoroughly give an explanation. + </p> + </div> + </div> + ]]></description> </item> <item> -<title>The Relation of Carbs and KISS</title> -<pubDate>Fri, 08 May 2020</pubDate> -<dc:creator>Cem Keylan</dc:creator> -<link>https://carbslinux.org/blog/20200508.html</link> -<description><h1>The Relation of Carbs and KISS</h1> - -<p><strong>Date:</strong> May 08 2020</p> - -<p>Since I have forked KISS, I have received many questions -that can be summarized as &ldquo;Why?&rdquo;. I have realized that I -never truly answered this question. That&rsquo;s the reason I am -writing this post, to give some background on Carbs, and -some differences between KISS Linux and Carbs Linux for -anyone who may be wondering. Perhaps I could make this a -&ldquo;FAQ&rdquo; page later on.</p> - -<h2>History</h2> - -<p>I had the idea of creating my own Linux distribution since -the May of 2019. Back then, I had my own <a href="https://linuxfromscratch.org">Linux from Scratch</a> -build, and I wanted to slim it down my own way and replace -the software (with musl,sbase,etc.). The name Carbs Linux -was in my mind since then. I wanted to write my own package -manager, but I wasn&rsquo;t satisfied with anything I had built.</p> - -<p>I had written some incomplete package managers (all named <code>fat</code>) -and I quickly threw them into the trash can, where they -honestly belonged. I would want to share them with you for -laughs, but my hard-drive got wiped and I have a problem -of not doing an &ldquo;initial commit&rdquo; until a program I write -is in a usable state.</p> - -<p>I have obtained the &lsquo;carbslinux.org&rsquo; domain name in September -2019, but then life got on the way, and I stopped for a long -time.</p> - -<p>One day on Reddit, I saw Dylan&rsquo;s post on <a href="https://reddit.com/r/unixporn">r/unixporn</a> about -KISS, and I really thought that it was interesting. Here is -my <a href="https://www.reddit.com/r/unixporn/comments/ducd34/sowm_kiss_d/f7lua7x">comment</a> to Dylan on that post. I checked out the package -manager and the repository. The packaging system was extremely -clean and well-thought. I decided to give it a go and fork -KISS.</p> - -<h2>Differences between KISS and Carbs</h2> - -<p>Now, I still baffle when people ask me this question. My -intention was never to create a distribution with specific -differences between KISS. My intention was being my own -BDFL of a distribution I maintain. There are lots of -differences between the main repositories, but they are subtle -and not worth talking about. I personally never even installed -KISS Linux on my system. So Carbs, isn&rsquo;t something like a -downstream fork of KISS, it is just a distribution that was -initially based on KISS.</p> - -<p>I try to contribute as much as I can to KISS Linux. I think -that it is a brilliant distribution, and it was a great starting -point for Carbs. I am really grateful to Dylan and all the -other contributors.</p> - -<h2>What I&rsquo;m working on now</h2> - -<p>Currently I have a few projects that I&rsquo;m working on for Carbs. -These are,</p> - -<p>A BSD port for Carbs. For a while, I have been working on BSD -compatibility on my fork of the <a href="https://github.com/carbslinux/kiss">package manager</a>. I have tested, -without any more issues, on OpenBSD and FreeBSD. The biggest -issues remaining are choosing a vendor for BSD, packaging the -BSD source, and providing a minimal base (like busybox for BSD). -If you aren&rsquo;t familiar with BSD, it has a single source code -for all of the utilities (kernel, command line programs, etc.). -Contributions (even chipping in ideas) are very welcome.</p> - -<p>Adding binary package distribution support natively to the package -manager. Biggest issue in small/old computers are compile times. -This feature is for the bigger packages such as webkit, clang, -llvm that take a considerable amount of time. Some computers -with low memories cannot even compile firefox/webkit.</p> - -<p>Adding rsync repository support to the package manager. This -is not a current issue, but rather a futureproofing. As time -passes, distribution repositories grow larger. KISS and Carbs -are young distributions without this problem right now. But -in something like 5 years, this size will presumably increase -to hundreds of megabytes. At that point it will be pointless -to have the repository sources unless you specifically need them.</p> - -<h2>What&rsquo;s up with all the init/service daemons?</h2> - -<p>If you have ever checked the <a href="https://github.com/carbslinux/repository">repository</a>, you may have noticed -that there are lots of init/service related packages. I have had -my fair share of time with all of them, and it is an area that I -am really interested in. I have even written my own <a href="https://github.com/cemkeylan/shinit">init daemon</a> -and <a href="https://github.com/cemkeylan/sysmgr">service supervisor</a>. I maintain all those packages on KISS -Community Repository as well with the exception of busybox. Those -are, <code>busybox init/runit</code>, <code>runit</code>, <code>sinit</code>, and <code>sysmgr</code>. I would -definitely recommend checking out <code>shinit</code> and <code>sysmgr</code>.</p> - -<h2>Why I don&rsquo;t publicize Carbs</h2> - -<p>There are a couple of reasons I don&rsquo;t publicize Carbs a lot.</p> - -<p>KISS is the better alternative in terms of support and community. -I work on maintaining this distribution just as hard as Dylan, -but in the end, Carbs is based on his original hard work, and I -believe that he deserves the recognition more than I do.</p> - -<p>Since I cannot answer questions like &ldquo;What is the difference?&rdquo;, I -prefer staying as the silent sibling project of KISS Linux. Plus, -there is no point in dividing the newly-emerging community in half.</p> - -<p>That&rsquo;s not because I don&rsquo;t have ideas for the future of Carbs, I -do. I just think that I will deserve the recognition once those -above lists are checked.</p> - -<p>I think that&rsquo;s about it, if you have questions you can send me a -mail, ping me on IRC (my handle is <code>merakor</code>), and I will be happy -to answer. Maybe your question fits this post, and I can update it -to thoroughly give an explanation.</p> - -<p>Cheers, -Cem</p></description> + <title>Outsource Repository Concept</title> + <link>https://carbslinux.org/blog/20200410.html</link> + <author>root@carbslinux.org (Cem Keylan)</author> + <guid isPermaLink="false">https://carbslinux.org/blog/20200410.html</guid> + <pubDate>Fri, 10 Apr 2020 00:00:00 +0300</pubDate> + + <description><![CDATA[<p> + In April 3rd, I have added submodule support for Carbs Linux's fork of <code>kiss</code>. + Now, from that sentence, it really doesn't sound exciting at all. But in + reality, it opens a path to lots of creative output, and a better way to manage + multi-user repositories (such as KISS Community). + </p> + + <p> + When managing a repository of submodules, the repository maintainer's only job + is to deal with adding packages. A package maintainer doesn't have to wait for + the repository maintainer to update their packages, as they are only making the + changes to their own repositories. + </p> + + <p> + This way, an end-user can also track from their preferred maintainers, and do + that with the tidyness of a single repository in their <code>KISS_PATH</code>. + </p> + + <p> + Carbs Linux now has an outsource repository for some packages. Firefox and its + dependencies have been purged from the main repository, but can be found on it. + </p> + + <p> + <a href="https://github.com/CarbsLinux/outsource">https://github.com/CarbsLinux/outsource</a> + </p> + ]]></description> </item> <item> -<title>Outsource Repository Concept</title> -<pubDate>Fri, 10 Apr 2020</pubDate> -<dc:creator>Cem Keylan</dc:creator> -<link>https://carbslinux.org/blog/20200410.html</link> -<description><h1>Outsource Repository Concept</h1> - -<p>In April 3rd, I have added submodule support for Carbs -Linux&rsquo;s fork of <code>kiss</code>. Now, from that sentence, it really -doesn&rsquo;t sound exciting at all. But in reality, it opens a -path to lots of creative output, and a better way to manage -multi-user repositories (such as KISS Community).</p> - -<p>When managing a repository of submodules, the repository -maintainer&rsquo;s only job is to deal with adding packages. -A package maintainer doesn&rsquo;t have to wait for the repository -maintainer to update their packages, as they are only making -the changes to their own repositories.</p> - -<p>This way, an end-user can also track from their preferred -maintainers, and do that with the tidyness of a single repository -in their <code>KISS_PATH</code>.</p> - -<p>Carbs Linux now has an outsource repository for some packages. -Firefox and its dependencies have been purged from the main repository, -but can be found on it.</p> - -<p><a href="https://github.com/CarbsLinux/outsource">https://github.com/CarbsLinux/outsource</a></p></description> -</item> -<item> -<title>Roadmap for Carbs</title> -<pubDate>Mon, 06 Apr 2020</pubDate> -<dc:creator>Cem Keylan</dc:creator> -<link>https://carbslinux.org/blog/20200406.html</link> -<description><h1>Roadmap for Carbs</h1> - -<p>It has been a busy week. There are lots of changes in -direction, and more to come. I want to talk a little -about all of them.</p> - -<h2>Carbs Linux Server Going Down</h2> - -<p>It became harder to maintain and pay for the server, and I will be -shutting it down in May. I am currently in the phase of -carrying over everything to <a href="https://github.com/CarbsLinux">Github</a>. The repository and the -website is served on Github now. I have also moved the <a href="https://github.com/CarbsLinux/wiki/wiki">Wiki</a> -to Github and anyone can edit it there. There are some outdated -posts that I will be fixing around this week.</p> - -<p>I am not quite sure where to store the downloads page now. But I -will be switching that to a new source as well. (Maybe Source Forge?)</p> - -<p>I feel a little sad for switching, but serving on Github is faster, -cheaper, and hassle-free.</p> - -<h2>Forking KISS</h2> - -<p>I had a personal fork of KISS, which I enjoyed thoroughly. I didn&rsquo;t -intend to make it the default when I started it, but it has matured -enough to be so. The package manager can now be found on <a href="https://github.com/CarbsLinux/kiss">this repository</a>. -See it for the added changes.</p> - -<p>This will be a change for the better, as I can develop the package -manager as it fits my views.</p> - -<h2>Small Changes on the Website</h2> - -<p>I have made some small changes on the website. The build is not dependent -on Plan9 utilities anymore. It was fun messing around with <code>rc</code> and <code>mk</code>, -but they are quite limited compared to POSIX shell.</p> - -<p>RSS feeds are finally working as intended, both for the <a href="https://carbslinux.org/news.xml">news</a> section, and -the <a href="https://carbslinux.org/rss.xml">blog</a> secion.</p> - -<p>You can see every page&rsquo;s <code>.txt</code> output at the end of the page by clicking -&lsquo;View Page Source&rsquo;. Meanwhile, I will be updating some pages to be a little -more &lsquo;human-readable&rsquo;.</p> - -<h2>Outsources Repository</h2> - -<p>I have opened an <code>outsource</code> repository, which I will be pushing this week. -I will add a new post when I am ready to push it. I think it will be interesting, -it will also make more sense about the changes I have added to the package -manager. The now empty repository, can be found <a href="https://github.com/CarbsLinux/outsource">here</a>!</p> - -<h2>New Tarball</h2> - -<p>Finally, I have released a new tarball today, which can be obtained from the -<a href="https://dl.carbslinux.org/releases">downloads page</a>.</p> - -<p>I am planning to add more of these update posts as I&rsquo;m feeling better about -the website structure overall.</p> - -<p>- Cem</p></description> + <title>Roadmap for Carbs</title> + <link>https://carbslinux.org/blog/20200406.html</link> + <author>root@carbslinux.org (Cem Keylan)</author> + <guid isPermaLink="false">https://carbslinux.org/blog/20200406.html</guid> + <pubDate>Mon, 06 Apr 2020 00:00:00 +0300</pubDate> + + <description><![CDATA[<p> + It has been a busy week. There are lots of changes in direction, and more to + come. I want to talk a little about all of them. + </p> + + <div id="outline-container-org87c73aa" class="outline-3"> + <h3 id="org87c73aa">Carbs Linux Server Going Down</h3> + <div class="outline-text-3" id="text-org87c73aa"> + <p> + It became harder to maintain and pay for the server, and I will be shutting it + down in May. I am currently in the phase of carrying over everything to <a href="https://github.com/CarbsLinux">Github</a>. + The repository and the website is served on Github now. I have also moved the + <a href="https://github.com/CarbsLinux/wiki/wiki">Wiki</a> to Github and anyone can edit it there. There are some outdated posts that + I will be fixing around this week. + </p> + + <p> + I am not quite sure where to store the downloads page now. But I will be + switching that to a new source as well. (Maybe SourceHut?) + </p> + + <p> + I feel a little sad for switching, but serving on Github is faster, cheaper, and + hassle-free. + </p> + </div> + </div> + + <div id="outline-container-orgb8b557f" class="outline-3"> + <h3 id="orgb8b557f">Forking KISS</h3> + <div class="outline-text-3" id="text-orgb8b557f"> + <p> + I had a personal fork of KISS, which I enjoyed thoroughly. I didn't intend to + make it the default when I started it, but it has matured enough to be so. The + package manager can now be found on <a href="https://github.com/CarbsLinux/kiss">this repository</a>. See it for the added + changes. + </p> + + <p> + This will be a change for the better, as I can develop the package manager as it + fits my views. + </p> + </div> + </div> + + <div id="outline-container-orgf2589d6" class="outline-3"> + <h3 id="orgf2589d6">Small Changes on the Website</h3> + <div class="outline-text-3" id="text-orgf2589d6"> + <p> + I have made some small changes on the website. The build is not dependent on + Plan9 utilities anymore. It was fun messing around with <code>rc</code> and <code>mk</code>, but they + are quite limited compared to POSIX shell. + </p> + + <p> + RSS feeds are finally working as intended, both for the <a href="https://carbslinux.org/news.xml">news</a> section, and the + <a href="https://carbslinux.org/rss.xml">blog</a> section. + </p> + + <p> + You can see every page's <code>.txt</code> output at the end of the page by clicking 'View + Page Source'. Meanwhile, I will be updating some pages to be a little more + 'human-readable'. + </p> + </div> + </div> + + <div id="outline-container-orge93d687" class="outline-3"> + <h3 id="orge93d687">Outsources Repository</h3> + <div class="outline-text-3" id="text-orge93d687"> + <p> + I have opened an <code>outsource</code> repository, which I will be pushing this week. I + will add a new post when I am ready to push it. I think it will be interesting, + it will also make more sense about the changes I have added to the package + manager. The now empty repository, can be found <a href="https://github.com/CarbsLinux/outsource">here</a>! + </p> + </div> + </div> + + <div id="outline-container-orgd091825" class="outline-3"> + <h3 id="orgd091825">New Tarball</h3> + <div class="outline-text-3" id="text-orgd091825"> + <p> + Finally, I have released a new tarball today, which can be obtained from the + <a href="https://dl.carbslinux.org/releases">downloads page</a>. + </p> + + <p> + I am planning to add more of these update posts as I'm feeling better about the + website structure overall. + </p> + </div> + </div> + ]]></description> </item> <item> -<title>Switching to New Website</title> -<pubDate>Tue, 28 Jan 2020</pubDate> -<dc:creator>Cem Keylan</dc:creator> -<link>https://carbslinux.org/blog/20200128.html</link> -<description><h1>Switching to New Website</h1> - -<p><strong>Date:</strong> Jan 28 2020</p> - -<p>In case you haven&rsquo;t seen it before, this website -was powered by <a href="http://werc.cat-v.org">werc</a>. And -even though I liked it really much, it was too -powerful for a small website like this.</p> - -<p>So I have decided to reimplement this website with -my own static generation scripts. The source will -probably be on <a href="https://carbslinux.org/git/website/log.html">https://carbslinux.org/git/website/log.html</a> -when I decide to publish the website.</p> - -<p>The generation requires Plan9 programs, although -I have used them just for my enthusiasm. I have built -the site with a combination of mk (instead of make), rc, -and POSIX sh. I am not yet exactly familiar with rc, -but I will replace the shell scripts when I feel like -I can.</p></description> + <title>Switching to New Website</title> + <link>https://carbslinux.org/blog/20200128.html</link> + <author>root@carbslinux.org (Cem Keylan)</author> + <guid isPermaLink="false">https://carbslinux.org/blog/20200128.html</guid> + <pubDate>Tue, 28 Jan 2020 00:00:00 +0300</pubDate> + + <description><![CDATA[<p> + In case you haven't seen it before, this website was powered by <a href="http://werc.cat-v.org">werc</a>. And even + though I liked it really much, it was too powerful for a small website like + this. + </p> + + <p> + So I have decided to reimplement this website with my own static generation + scripts. The source will probably be on <a href="https://git.carbslinux.org/website/log.html">its git repository</a> when I decide to + publish the website. + </p> + + <p> + The generation requires Plan9 programs, although I have used them just for my + enthusiasm. I have built the site with a combination of mk (instead of make), + rc, and POSIX sh. I am not yet exactly familiar with rc, but I will replace the + shell scripts when I feel like I can. + </p> + ]]></description> </item> - </channel> +</channel> </rss> diff --git a/docs/style.css b/docs/style.css index 74eebb9..d35af15 100644 --- a/docs/style.css +++ b/docs/style.css @@ -1,117 +1,243 @@ -/* Cem Keylan (C) 2019-2020 */ - +/* + * Stylesheet for Carbs Linux website + * Copyright (c) 2019-2021 Cem Keylan + */ :root { - --color0: #0A1E2B; - --color1: #5C5B6F; - --color2: #9B506D; - --color3: #C34266; - --color4: #7B9BB7; - --color5: #BF6790; - --color6: #6a9faf; - --color7: #A676D2; - --color8: #8b8288; - --color9: #5C5B6F; - --color10: #9B506D; - --color11: #C34266; - --color12: #4E708D; - --color13: #BF6790; - --color14: #528899; - --color15: #c7bac3; - --fg: #0a1e2b; - --bg: #ffffff; - --altbg: #bf6790; - --link: #bf6790; - --linkalt: #4e708d; -} - - -html { - background-color: var(--bg); - font-family: monospace; - font-size: 16px; - color: var(--fg); - padding-bottom: 100px; - -webkit-text-size-adjust: 100%; - -ms-text-size-adjust: 100%; - -ms-overflow-style: scrollbar; - -webkit-tap-highlight-color: transparent; -} -.header { - text-align: center; -} -.header strong{ - color: var(--color5) -} -.header a{ - text-decoration: none; - text-align: center; - color: var(--fg); - margin-left: 10px; - margin-right: 10px; -} -.header a:hover{ - text-decoration: none; - text-align: center; - color: var(--linkalt); - margin-left: 10px; - margin-right: 10px; -} -.border { - padding-top: 1%; - border-bottom: solid 2px; - color: var(--fg); -} -a { - text-decoration: none; - font-weight: bold; - color: var(--link); -} -a:hover { - text-decoration: underline; - font-weight: bold; - color: var(--linkalt); -} -.post-title { - text-align: center; -} -ul li::before { - color: var(--color4); -} + --color-carbs-color-bg: #F3F6F8; + --color-carbs-color-fg: #0A1E2B; + --color-carbs-highlight: #E9ECEE; + --color-carbs-pink: #BF6790; + --color-carbs-purple: #8C45D4; + --color-carbs-blue: #3F74A6; + --color-carbs-blue-alt: #3F41A6; + --color-carbs-red: #D32C2C; + --color-carbs-grey: #738B8B; + --color-carbs-green: #027A59; + --color-carbs-orange: #B45123; } + @media (prefers-color-scheme: dark) { + :root { + --color-carbs-color-bg: #0A1E2B; + --color-carbs-color-fg: #F3F6F8; + --color-carbs-highlight: #0A2830; + --color-carbs-pink: #BF6790; + --color-carbs-purple: #A6A6D2; + --color-carbs-blue: #6790BF; + --color-carbs-blue-alt: #67BCBF; + --color-carbs-red: #C34266; + --color-carbs-grey: #686868; + --color-carbs-green: #67BF96; + --color-carbs-orange: #F47A00; } } body { - width: 80%; - max-width: 1050px; - margin-left: auto; - margin-right: auto; - margin-top: 20px; - overflow: none; - overflow-y: scroll; - padding-right: 10px; - padding-left: 10px; - color: var(--fg); -} + margin: 0; + background-color: var(--color-carbs-color-bg); + font-family: "Noto Sans", "Open Sans", sans-serif; + font-size: 16px; + color: var(--color-carbs-color-fg); + -webkit-text-size-adjust: 100%; + -ms-text-size-adjust: 100%; + -ms-overflow-style: scrollbar; + -webkit-tap-highlight-color: transparent; } + +/* Reasonable line-height for better readability. */ +p, pre, li, dt, dd, table, code, address { + line-height: 1.5em; } + +p { + margin-top: 1em; + margin-bottom: 1em; } + +#content { + width: 95%; + margin: 0 auto; + margin-left: auto; + margin-right: auto; + text-align: left; + max-width: 50em; } + +.subtitle { + color: var(--color-carbs-color-fg); + font-weight: normal; + font-size: 16px; + font-style: italic; } + +code, pre.src { + padding: .2em .4em; + margin: 0; + font-size: 85%; } + code { - color: var(--fg); - content: "> "; -} -p,tr,td,table { color: var(--fg); } + background-color: var(--color-carbs-highlight); + border-radius: 3px; } + +h1 a, h2 a, h3 a, h4 a, h5 a, h6 a { + color: inherit; } + h1 a:hover, h2 a:hover, h3 a:hover, h4 a:hover, h5 a:hover, h6 a:hover { + text-decoration: none; } + h1 { - color: var(--color7); - font-weight: bolder; -} + color: var(--color-carbs-pink); + font-weight: 800; } + h1 a:hover { + color: #bf6a67; } + @media (prefers-color-scheme: dark) { + h1 a:hover { + color: #bf6a67; } } h2 { - color: var(--color4); - font-weight: bold; -} + color: var(--color-carbs-blue); + font-weight: 700; } + h2 a:hover { + color: var(--color-carbs-purple); } + h3 { - color: var(--fg); - font-weight: bold; -} -.footer { - text-align: center; -} - -pre { margin-left: 2em; } + color: var(--color-carbs-color-fg); + font-weight: 600; } + h3 a:hover { + color: var(--color-carbs-blue); } + +pre { + font: monospace; + border-radius: 3px; + border: 1px solid var(--color-carbs-highlight); + background-color: var(--color-carbs-highlight); + padding: 0.5em; + margin: 1em; } + pre code, pre.src { + display: block; + overflow: auto; } + pre code { + background: transparent; } + +a { + text-decoration: none; + font-weight: bold; + color: var(--color-carbs-pink); } + +a:hover { + text-decoration: underline; + color: var(--color-carbs-blue-alt); } + blockquote { - border-left: 1px solid var(--color6); - font-style: italic; -} + border-left: 1px solid var(--color-carbs-highlight); + font-style: italic; } + +#preamble { + margin-bottom: 2em; } + +#navbar { + background: #0A1E2B none repeat scroll 0 0 !important; + border-bottom: 5px solid #BF6790 !important; + min-height: 40px; + padding: 10px 15px !important; } + #navbar label, #navbar #hamburger { + display: none; } + #navbar a.navbartitle { + margin: 0 !important; + padding: 0 !important; + color: #BF6790 !important; + float: left !important; + font-weight: bolder !important; + font-size: 200% !important; } + #navbar a.navbartitle:hover { + text-decoration: none; + color: #BF6790; } + #navbar #navbarlist li a { + color: #F3F6F8; + font-weight: bold; + text-decoration: none; } + #navbar ul { + display: block; + list-style: none; + margin: 0; + padding: 0; + text-align: right; + font-size: 0; + letter-spacing: 0; } + #navbar ul li { + display: inline-block; + font-size: 14px; + font-family: "Noto Sans", "Open Sans", sans-serif !important; + line-height: 1.4; + letter-spacing: 0; + padding-top: 14px; + padding-right: 15px; + padding-left: 15px; + margin: 0; } + #navbar ul li a:hover { + color: #A6A6D2 !important; + text-decoration: none !important; } + +@media screen and (max-width: 768px) { + #navbar label { + display: inline-block; + box-sizing: border-box; + color: #F3F6F8; + background: #BF6790; + border-radius: 0.2em; + font-style: normal; + text-align: center; + margin-right: auto; + margin-left: auto; + font-size: 1em; + padding: 0.5em 0; + font-size: 1em; + width: 2.2em; + height: 100%; + float: right; } + #navbar ul { + margin-left: 0; + margin-right: 0; + text-align: left; } + #navbar #navbarlist { + margin-top: 50px; + display: none; } + #navbar #navbarlist li { + box-sizing: border-box; + border-top: 1px solid var(--color-carbs-purple); + display: block; + width: 100%; + padding: 0.5em; } + #navbar input:checked ~ #navbarlist { + display: block; } } + +footer { + clear: both; + margin-top: 2em; + background: #0A1E2B none repeat scroll 0 0 !important; + border-top: 5px solid #BF6790 !important; + padding: 10px 15px !important; + bottom: 0; } + footer p { + text-align: center; + color: #F3F6F8; } + +/* Syntax highlighting for org-mode source block exports */ +.org-comment, .org-comment-delimiter { + color: var(--color-carbs-grey); + font-style: italic; } + +.org-builtin { + color: var(--color-carbs-blue); } + +.org-constant { + color: var(--color-carbs-pink); } + +.org-doc { + color: var(--color-carbs-grey); } + +.org-function-name { + color: var(--color-carbs-blue); } + +.org-variable-name { + color: var(--color-carbs-purple); } + +.org-keyword { + color: var(--color-carbs-blue-alt); } + +.org-string { + color: var(--color-carbs-green); } + +.org-type { + color: var(--color-carbs-orange); } + +.org-warning { + color: var(--color-carbs-red); } diff --git a/elisp/no-littering.el b/elisp/no-littering.el new file mode 100644 index 0000000..88fe0e7 --- /dev/null +++ b/elisp/no-littering.el @@ -0,0 +1,454 @@ +;;; no-littering.el --- help keeping ~/.emacs.d clean -*- lexical-binding: t; -*- + +;; Copyright (C) 2016-2021 Jonas Bernoulli + +;; Author: Jonas Bernoulli <jonas@bernoul.li> +;; Homepage: https://github.com/emacscollective/no-littering +;; Package-Requires: ((cl-lib "0.5")) + +;; This file is not part of GNU Emacs. + +;; This file is free software; you can redistribute it and/or modify +;; it under the terms of the GNU General Public License as published by +;; the Free Software Foundation; either version 3, or (at your option) +;; any later version. + +;; This file is distributed in the hope that it will be useful, +;; but WITHOUT ANY WARRANTY; without even the implied warranty of +;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +;; GNU General Public License for more details. + +;; For a full copy of the GNU General Public License +;; see https://www.gnu.org/licenses. + +;;; Commentary: + +;; Help keeping ~/.emacs.d clean. + +;; The default paths used to store configuration files and persistent +;; data are not consistent across Emacs packages. This isn't just a +;; problem with third-party packages but even with built-in packages. + +;; Some packages put these files directly in `user-emacs-directory' +;; or $HOME or in a subdirectory of either of the two or elsewhere. +;; Furthermore sometimes file names are used that don't provide any +;; insight into what package might have created them. + +;; This package sets out to fix this by changing the values of path +;; variables to put configuration files in `no-littering-etc-directory' +;; (defaulting to "etc/" under `user-emacs-directory', thus usually +;; "~/.emacs.d/etc/") and persistent data files in +;; `no-littering-var-directory' (defaulting to "var/" under +;; `user-emacs-directory', thus usually "~/.emacs.d/var/"), and +;; by using descriptive file names and subdirectories when appropriate. +;; This is similar to a color-theme; a "path-theme" if you will. + +;; We still have a long way to go until most built-in and many third- +;; party path variables are properly "themed". Like a color-theme, +;; this package depends on user contributions to accomplish decent +;; coverage. Pull requests are highly welcome (but please follow the +;; conventions described below and in the pull request template). + +;; `no-littering' cannot help with moving existing files to the new +;; location. You will have to move the files manually. See issue +;; #79 for more information. + +;; Usage: + +;; Load the feature `no-littering' as early as possible in your init +;; file. Make sure you load it at least before you change any path +;; variables using some other method. +;; +;; (require 'no-littering) + +;; If you would like to use base directories different from what +;; `no-littering' uses by default, then you have to set the respective +;; variables before loading the feature. +;; +;; (setq no-littering-etc-directory +;; (expand-file-name "config/" user-emacs-directory)) +;; (setq no-littering-var-directory +;; (expand-file-name "data/" user-emacs-directory)) +;; (require 'no-littering) + +;; Conventions: + +;; * A) File names +;; +;; 1. File names are based on the name of the respective Emacs Lisp +;; variables and the name of the respective Emacs package. +;; +;; 2. The name of the respective Emacs package should serve as the +;; prefix of the file name, unless the file is in a subdirectory in +;; which case the name of the subdirectory serves as the prefix. +;; +;; 3. If the name of the package and the prefix of the variable do not +;; match, then we prefer the name of the package. +;; +;; 4. If the name of a path variable ends with `-file`, `-default-file`, +;; `-directory`, `-default-directory`, or something similar, then that +;; suffix is usually dropped from the file name. +;; +;; 5. If applicable, the appropriate extension is added to the file name +;; so that files are visited using the appropriate major-modes and +;; also to provide a hint about the kind of data stored in the file. +;; E.g. if a file contains an S-expression, then the suffix should be +;; `*.el`. + +;; * B) File location and subdirectories +;; +;; 1. If a package has only one data file, then that is usually placed in +;; `no-littering-var-directory` itself. Likewise if a package has +;; only one config file, then that is placed in +;; `no-littering-etc-directory` itself. +;; +;; 2. If a package has multiple data (or config files), then those files +;; are placed in a subdirectory of `no-littering-var-directory` (or +;; `no-littering-etc-directory`). +;; +;; 3. If a subdirectory is used for a package's data (or config) file +;; variables, then the name of the directory should match the name of +;; the package in most cases. The subdirectory name may serve as the +;; package prefix of the file name. +;; +;; 4. If a package provides a "framework" for other packages to use, +;; then we may reuse its directories for other packages that make use +;; of that framework or otherwise "extend" the "main package". +;; E.g. we place all `helm` related files in `helm/`. +;; +;; 5. If a package only defines a single variable that specifies a data +;; (or config) directory, then the directory name should +;; nevertheless be just the package name. E.g. the path used for +;; `sx-cache-directory` from the `sx` package is `sx/cache/`, not +;; `sx-cache/`. +;; +;; 6. However if the name of the directory variable implies that the +;; package won't ever define any data (or config) files that won't be +;; placed in that directory, then we use a top-level directory. E.g. +;; when the name of the variable is `<package>-directory`, in which +;; case we would use just `<package>/` as the path. + +;; * C) Ordering and alignment +;; +;; 1. The code that sets the values of themed variables is split into two +;; groups. The first group sets the value of variables that belong to +;; packages that are part of Emacs, and the second group is used for +;; variables that are defined by packages that are not part of Emacs. +;; +;; 2. Each of these lists is sorted alphabetically (usually by variable +;; name). Please keep it that way. +;; +;; 3. We attempt to align the value forms inside different `setq` forms. +;; If the symbol part for a particular variable is too long to allow +;; doing so, then don't worry about it and just break the alignment. +;; If it turns out that this happens very often, then we will adjust +;; the alignment eventually. + +;; * D) Commit messages +;; +;; 1. Please theme each package using a separate commit and use commit +;; messages of the form "<package>: theme <variable". +;; +;; 2. If a package has several path variables, then you should theme them +;; all in one commit. +;; +;; 3. If the variable names do not fit nicely on the summary line, then +;; use a message such as: +;; +;; foo: theme variables +;; +;; Theme `foo-config-file', `foo-cache-directory', +;; and `foo-persistent-file'. +;; 4. When appropriate add statements like the following to the commit +;; message: +;; +;; - This file is used to store an s-expression. +;; - This file is used to store raw text. +;; - This is the only configuration/data file of the package. +;; - This package does/doesn't take care of creating the containing +;; directory if necessary. (If the package does not do it, then you +;; should also fix that and submit an upstream pull request.) +;; +;; 5. If you are uncertain, then be explicit about it by adding a comment +;; to the pull-request. + +;;; Code: + +(require 'cl-lib) + +(defvar no-littering-etc-directory + (expand-file-name (convert-standard-filename "etc/") user-emacs-directory) + "The directory where packages place their configuration files. +This variable has to be set before `no-littering' is loaded.") + +(defvar no-littering-var-directory + (expand-file-name (convert-standard-filename "var/") user-emacs-directory) + "The directory where packages place their persistent data files. +This variable has to be set before `no-littering' is loaded.") + +;;;###autoload +(defun no-littering-expand-etc-file-name (file) + "Expand filename FILE relative to `no-littering-etc-directory'." + (expand-file-name (convert-standard-filename file) + no-littering-etc-directory)) + +;;;###autoload +(defun no-littering-expand-var-file-name (file) + "Expand filename FILE relative to `no-littering-var-directory'." + (expand-file-name (convert-standard-filename file) + no-littering-var-directory)) + +(cl-letf (((symbol-function 'etc) + (symbol-function #'no-littering-expand-etc-file-name)) + ((symbol-function 'var) + (symbol-function #'no-littering-expand-var-file-name))) + (make-directory no-littering-etc-directory t) + (make-directory no-littering-var-directory t) + (with-no-warnings ; many of these variables haven't been defined yet + +;;; Built-in packages + + (setq abbrev-file-name (etc "abbrev.el")) + (setq auto-insert-directory (etc "auto-insert/")) + (setq auto-save-list-file-prefix (var "auto-save/sessions/")) + (setq backup-directory-alist (list (cons "." (var "backup/")))) + (setq bookmark-default-file (var "bookmark-default.el")) + (setq calc-settings-file (etc "calc-settings.el")) + (eval-after-load 'desktop + `(make-directory ,(var "desktop/") t)) + (setq desktop-dirname (var "desktop/")) + (setq desktop-path (list desktop-dirname)) + (setq diary-file (var "diary")) + (setq ecomplete-database-file (var "ecomplete-database.el")) + (setq ede-project-placeholder-cache-file (var "ede-projects.el")) + (eval-after-load 'erc + `(make-directory ,(var "erc/dcc/") t)) + (setq erc-dcc-get-default-directory (var "erc/dcc/")) + (setq erc-log-channels-directory (var "erc/log-channels/")) + (eval-after-load 'eshell + `(make-directory ,(etc "eshell/") t)) + (setq eshell-aliases-file (etc "eshell/aliases")) + (setq eshell-directory-name (var "eshell/")) + (setq eudc-options-file (etc "eudc-options.el")) + (eval-after-load 'eww + `(make-directory ,(var "eww/") t)) + (setq eww-bookmarks-directory (var "eww/")) + (setq filesets-menu-cache-file (var "filesets-menu-cache.el")) + (setq gamegrid-user-score-file-directory (var "gamegrid-user-score/")) + (setq ido-save-directory-list-file (var "ido-save-directory-list.el")) + (setq image-dired-db-file (var "image-dired/db.el")) + (setq image-dired-dir (var "image-dired/")) + (setq image-dired-gallery-dir (var "image-dired/gallery/")) + (setq image-dired-temp-image-file (var "image-dired/temp-image")) + (setq image-dired-temp-rotate-image-file (var "image-dired/temp-rotate-image")) + (setq kkc-init-file-name (var "kkc-init.el")) + (eval-after-load 'newsticker + `(make-directory ,(var "newsticker/") t)) + (setq newsticker-cache-filename (var "newsticker/cache.el")) + (setq newsticker-dir (var "newsticker/data/")) + (setq nsm-settings-file (var "nsm-settings.el")) + (eval-after-load 'org + `(make-directory ,(var "org/") t)) + (setq org-clock-persist-file (var "org/clock-persist.el")) + (setq org-id-locations-file (var "org/id-locations.el")) + (setq org-publish-timestamp-directory (var "org/timestamps/")) + (setq project-list-file (var "project-list.el")) + (setq quickurl-url-file (var "quickurl-url.el")) + (setq rcirc-log-directory (var "rcirc-log/")) + (setq recentf-save-file (var "recentf-save.el")) + (setq remember-data-file (var "remember/data")) + (setq remember-data-directory (var "remember/data.d/")) + (setq save-place-file (var "save-place.el")) + (setq savehist-file (var "savehist.el")) + (setq srecode-map-save-file (var "srecode-map.el")) + (setq semanticdb-default-save-directory (var "semantic/")) + (setq shared-game-score-directory (var "shared-game-score/")) + (setq timeclock-file (var "timeclock")) + (setq tramp-auto-save-directory (var "tramp/auto-save/")) + (setq tramp-persistency-file-name (var "tramp/persistency.el")) + (setq type-break-file-name (var "type-break.el")) + (setq url-cache-directory (var "url/cache/")) + (setq url-configuration-directory (var "url/configuration/")) + +;;; Third-party packages + + (setq ac-comphist-file (var "ac-comphist.el")) + (setq amx-save-file (var "amx-save.el")) + (setq anaconda-mode-installation-directory (var "anaconda-mode/")) + (setq annotate-file (var "annotations.el")) + (setq async-byte-compile-log-file (var "async-bytecomp.log")) + (setq auto-package-update-last-update-day-path (var "auto-package-update-last-update-day")) + (eval-after-load 'bbdb + `(make-directory ,(var "bbdb/") t)) + (setq bbdb-file (var "bbdb/bbdb.el")) + (setq bbdb-vcard-directory (var "bbdb/vcard/")) + (setq bm-repository-file (var "bm-repository.el")) + (eval-after-load 'bookmark+-1 + `(make-directory ,(var "bmkp/") t)) + (setq bmkp-bmenu-commands-file (var "bmkp/bmenu-commands.el")) + (setq bmkp-current-bookmark-file (var "bmkp/current-bookmark.el")) + (setq bmkp-last-bookmark-file (var "bmkp/last-bookmark.el")) + (setq bookiez-file (var "bookiez")) + (setq cider-repl-history-file (var "cider-repl-history.el")) + (eval-after-load 'command-log-mode + `(make-directory ,(var "command-log-mode-logging/") t)) + (setq clm/logging-dir (var "command-log-mode/logging/")) + (eval-after-load 'company + `(make-directory ,(var "company/") t)) + (setq company-statistics-file (var "company/statistics.el")) + (setq company-tabnine-binaries-folder (var "company/tabnine-binaries")) + (setq dap-breakpoints-file (var "dap/breakpoints.el")) + (setq dap-java-test-runner (var "lsp-java/eclipse.jdt.ls/test-runner/junit-platform-console-standalone.jar")) + (setq dap-utils-extension-path (var "dap/extensions/")) + (setq debbugs-gnu-persistency-file (var "debbugs.el")) + (setq dired-recent-directories-file (var "dired-recent-directories.el")) + (setq elbank-data-file (var "elbank-data.el")) + (setq elmo-msgdb-directory (var "elmo/")) + (setq elmo-split-log-file (var "elmo/split-log")) + (eval-after-load 'elfeed + `(make-directory ,(var "elfeed/") t)) + (setq elfeed-db-directory (var "elfeed/db/")) + (setq elfeed-enclosure-default-dir (var "elfeed/enclosures/")) + (setq elfeed-score-score-file (etc "elfeed/score/score.el")) + (setq elpher-bookmarks-file (var "elpher-bookmarks.el")) + (eval-after-load 'x-win + (let ((session-dir (var "emacs-session/"))) + `(progn + (make-directory ,session-dir t) + (defun emacs-session-filename (session-id) + "Construct a filename to save the session in based on SESSION-ID. +This function overrides the one on `x-win' to use `no-littering' +directories." + (expand-file-name session-id ,session-dir))))) + (setq emms-directory (var "emms/")) + (eval-after-load 'emojify + `(make-directory ,(var "emojify/") t)) + (setq emojify-emojis-dir (var "emojify/")) + (setq epkg-repository (var "epkgs/")) + (setq equake-persistent-display-file (var "equake-persistent-display")) + (setq forge-database-file (var "forge/database.sqlite")) + (setq forge-post-directory (var "forge/posts/")) + (setq geben-temporary-file-directory (var "geben/")) + (eval-after-load 'geiser + `(make-directory ,(var "geiser/") t)) + (setq geiser-repl-history-filename (var "geiser/repl-history")) + (setq hackernews-visited-links-file (var "hackernews/visited-links.el")) + (eval-after-load 'helm + `(make-directory ,(var "helm/") t)) + (setq helm-adaptive-history-file (var "helm/adaptive-history.el")) + (setq helm-backup-path (var "helm/backup/")) + (setq helm-github-stars-cache-file (var "helm/github-stars-cache.el")) + (setq helm-net-curl-log-file (var "helm/helm-curl.log")) + (setq historian-save-file (var "historian-save.el")) + (setq indium-workspace-file (var "indium/workspaces.el")) + (setq irfc-directory (var "irfc/")) + (setq irony-user-dir (var "irony/")) + (setq jabber-avatar-cache-directory (var "jabber/avatar-cache")) + (eval-after-load 'jabber + `(make-directory ,(var "jabber/avatar-cache/") t)) + (setq jabber-history-dir (var "jabber/history")) + (eval-after-load 'jabber + `(make-directory ,(var "jabber/history/") t)) + (setq keyfreq-file (var "keyfreq.el")) + (setq keyfreq-file-lock (var "keyfreq.lock")) + (setq libbcel-oauth-store-filename (var "libbcel-oauth-store.el.gpg")) + (setq litable-list-file (var "litable-list.el")) + (setq logview-cache-filename (var "logview-cache")) + (setq logview-views-file (etc "logview-views")) + (eval-after-load 'lookup + `(make-directory ,(etc "lookup/") t)) + (setq lookup-init-directory (etc "lookup/")) + (setq lsp-eslint-library-choices-file (var "lsp/eslint-library-choices.el")) + (setq lsp-python-ms-dir (var "lsp-python-ms/")) + (eval-after-load 'lsp-mode + `(make-directory ,(var "lsp/") t)) + (setq lsp-server-install-dir (var "lsp/server/")) + (setq lsp-session-file (var "lsp/session.el")) + (setq lsp-java-workspace-dir (var "lsp-java/workspace/")) + (setq lsp-java-server-install-dir (var "lsp-java/eclipse.jdt.ls/server/")) + (setq magithub-dir (var "magithub/")) + (setq magithub-cache-file (var "magithub/cache.el")) + (setq mc/list-file (var "mc-list.el")) + (setq meghanada-server-install-dir (var "meghanada/")) + (setq multi-compile-history-file (var "multi-compile-history.el")) + (setq nix-buffer-directory-name (var "nix-buffer/")) + ;; The value of this variable MUST NOT end with ".el" but the + ;; actual file name MUST end with ".el". Use "git blame" for + ;; more information. + (setq notmuch-init-file (etc "notmuch-init")) + (setq nov-save-place-file (var "nov-save-place.el")) + (setq omnisharp-cache-directory (var "omnisharp/cache")) + (setq org-gcal-dir (var "org/gcal/")) + (eval-after-load 'org-caldav + `(make-directory ,(var "org/caldav/save") t)) + (setq org-caldav-backup-file (var "org/caldav/backup.org")) + (setq org-caldav-save-directory (var "org/caldav/save")) + (setq org-journal-cache-file (var "org/journal-cache.el")) + (setq org-recent-headings-save-file (var "org/recent-headings.el")) + (setq org-registry-file (var "org/registry.el")) + (setq org-roam-db-location (var "org/org-roam.db")) + (setq package-quickstart-file (var "package-quickstart.el")) + (setq pandoc-data-dir (etc "pandoc-mode/")) + (setq pcache-directory (var "pcache/")) + (setq pdf-view-restore-filename (var "pdf-view-restore.el")) + (setq persist--directory-location (var "persist/")) + (setq persistent-scratch-save-file (var "persistent-scratch.el")) + (setq persp-save-dir (var "persp-mode/")) + (eval-after-load 'projectile + `(make-directory ,(var "projectile/") t)) + (setq prescient-save-file (var "prescient-save.el")) + (setq projectile-cache-file (var "projectile/cache.el")) + (setq projectile-known-projects-file (var "projectile/known-projects.el")) + (setq psession-elisp-objects-default-directory (var "psession/")) + (setq purpose-default-layout-file (etc "window-purpose/default-layout.el")) + (setq purpose-layout-dirs (list (etc "window-purpose/layouts/"))) + (setq pyim-dcache-directory (var "pyim/dcache/")) + (setq quack-dir (var "quack/")) + (setq rfc-mode-directory (var "rfc-mode/")) + (setq request-storage-directory (var "request/storage/")) + (setq rmh-elfeed-org-files (list (var "elfeed/rmh-elfeed.org"))) + (setq runner-init-file (var "runner-init.el")) + (setq save-kill-file-name (var "save-kill.el")) + (setq save-visited-files-location (var "save-visited-files-location")) + (eval-after-load 'sly + `(make-directory ,(var "sly/") t)) + (setq sly-mrepl-history-file-name (var "sly/mrepl-history")) + (setq smex-save-file (var "smex-save.el")) + (setq speed-type-gb-dir (var "speed-type/")) + (eval-after-load 'sx + `(make-directory ,(var "sx/cache/") t)) + (setq sx-cache-directory (var "sx/cache/")) + (setq tldr-directory-path (var "tldr/")) + (setq transient-history-file (var "transient/history.el")) + (setq transient-levels-file (etc "transient/levels.el")) + (setq transient-values-file (etc "transient/values.el")) + (setq treemacs-persist-file (var "treemacs/persist.org")) + (setq treemacs-last-error-persist-file (var "treemacs/persist-last-error.org")) + (setq undo-fu-session-directory (var "undo-fu-session/")) + (setq undohist-directory (var "undohist/")) + (setq undo-tree-history-directory-alist (list (cons "." (var "undo-tree-hist/")))) + (setq user-emacs-ensime-directory (var "ensime/")) + (setq vimish-fold-dir (var "vimish-fold/")) + (eval-after-load 'wl + `(make-directory ,(etc "wanderlust") t)) + (setq wl-init-file (etc "wanderlust/init.el")) + (setq wl-folders-file (etc "wanderlust/folders")) + (setq wl-address-file (etc "wanderlust/address")) + (setq wl-alias-file (etc "wanderlust/alias")) + (setq wl-x-face-file (etc "wanderlust/x-face")) + (setq wl-temporary-file-directory (var "wanderlust-tmp")) + (setq x86-lookup-cache-directory (var "x86-lookup/cache/")) + (eval-after-load 'xkcd + `(make-directory ,(var "xkcd/") t)) + (setq xkcd-cache-dir (var "xkcd/")) + (eval-after-load 'yasnippet + `(make-directory ,(etc "yasnippet/snippets/") t)) + (setq yas-snippet-dirs (list (etc "yasnippet/snippets/"))) + )) + +;;; _ +(provide 'no-littering) +;; Local Variables: +;; indent-tabs-mode: nil +;; End: +;;; no-littering.el ends here diff --git a/index/20191210.news b/index/20191210.news deleted file mode 100644 index e8041d9..0000000 --- a/index/20191210.news +++ /dev/null @@ -1,5 +0,0 @@ -Dec 10 2019 --------------------------------------------------------------------------------- - -First alpha release was made. See the [downloads page](//dl.carbslinux.org/releases). - diff --git a/index/20191215.news b/index/20191215.news deleted file mode 100644 index c22fbd1..0000000 --- a/index/20191215.news +++ /dev/null @@ -1,8 +0,0 @@ -Dec 15 2019 --------------------------------------------------------------------------------- - -Carbs Linux Wiki is now available to be edited and updated by the users go -to the [wiki](//carbslinux.org/wiki) to obtain more information. - -**February 2020 EDIT:** Changed link for wiki - diff --git a/index/20191217.news b/index/20191217.news deleted file mode 100644 index 1fbb081..0000000 --- a/index/20191217.news +++ /dev/null @@ -1,5 +0,0 @@ -Dec 17 2019 --------------------------------------------------------------------------------- - -Installation instruction are now complete. A review would be greatly appreciated! - diff --git a/index/20191218.news b/index/20191218.news deleted file mode 100644 index 35f1023..0000000 --- a/index/20191218.news +++ /dev/null @@ -1,5 +0,0 @@ -Dec 18 2019 --------------------------------------------------------------------------------- - -carbs-rootfs-20191218.tar.xz was [released](//dl.carbslinux.org/releases) - diff --git a/index/20200109.news b/index/20200109.news deleted file mode 100644 index 7621360..0000000 --- a/index/20200109.news +++ /dev/null @@ -1,14 +0,0 @@ -Jan 09 2020 --------------------------------------------------------------------------------- - -Happy new year, everyone! I am back after some long silence. I was unable to commit for a -while, but I have pulled some new updates from the KISS repository, added some of my own. -This week I will be changing/adding some things. - -Important things are, - -* Carbs-init was updated to 0.3. -* I will be adding an implementation of suckless.org's [sinit](//core.suckless.org/sinit) as `carbs-sinit` -* Carbs Repository was added to [repology.org](//repology.org/repository/carbs) -* A new rootfs tarball will be coming up tomorrow. - diff --git a/index/20200110.news b/index/20200110.news deleted file mode 100644 index 8deacbc..0000000 --- a/index/20200110.news +++ /dev/null @@ -1,5 +0,0 @@ -Jan 10 2020 --------------------------------------------------------------------------------- - -carbs-rootfs-20200110.tar.xz was [released](//dl.carbslinux.org/releases) - diff --git a/index/20200113.news b/index/20200113.news deleted file mode 100644 index f9c467e..0000000 --- a/index/20200113.news +++ /dev/null @@ -1,19 +0,0 @@ -Jan 13 2020 --------------------------------------------------------------------------------- - -**Busybox update reqires manual intervention** - -The new busybox package conflicts with the pre-update busybox-init. That's why -you should rebuild and install `busybox-init` before doing the update. - - # Do a kiss update first (but don't actually update it yet), or manually pull the git repository - $ kiss u # Cancel this operation after it asks for you to confirm the update - - # Install the busybox-init package - $ kiss b busybox-init && kiss i busybox-init - - # Continue your update as you normally would. - $ kiss u - -I have moved runit and logging utilities from the busybox-init package to the busybox -package, which is the cause of these conflicts. diff --git a/index/20200115.news b/index/20200115.news deleted file mode 100644 index dd21908..0000000 --- a/index/20200115.news +++ /dev/null @@ -1,5 +0,0 @@ -Jan 15 2020 --------------------------------------------------------------------------------- - -sinit has been taken to `core`, and is now officially supported - diff --git a/index/20200122.news b/index/20200122.news deleted file mode 100644 index f1d7fd3..0000000 --- a/index/20200122.news +++ /dev/null @@ -1,6 +0,0 @@ -Jan 22 2020 --------------------------------------------------------------------------------- - -Expect downtime on Jan 24 2020 22:00 UTC as I will be migrating -this web server to my Carbs Linux server! - diff --git a/index/20200128.news b/index/20200128.news deleted file mode 100644 index 45b373c..0000000 --- a/index/20200128.news +++ /dev/null @@ -1,11 +0,0 @@ -Jan 28 2020 --------------------------------------------------------------------------------- - -Web Server is now on a Carbs Linux server. It is not complete yet, -but I will be adding a little more for the intended functionality. -Downtimes can be expected. - -UPDATE: ssl is now working. - -UPDATE2: downloads are back again. - diff --git a/index/20200214.news b/index/20200214.news deleted file mode 100644 index 9fda471..0000000 --- a/index/20200214.news +++ /dev/null @@ -1,52 +0,0 @@ -Feb 14 2020 --------------------------------------------------------------------------------- - -**IMPORTANT!** Carbs-init update to be released on 17th of February -will require manual intervention. I am holding this update back so -people can see it before they update their system (even though the -update will show the same message as this). The rationale for the -update is explained below the intervention. - - # There is an explanation for each init - # You only need to follow the instructions - # for your own init-system - - ## busybox-init - # If you did not edit your inittab simply - # move inittab.new to inittab - -> mv /etc/inittab.new /etc/inittab - - # If you did edit your inittab you can use - # a simple sed command to remove the necessary lines - -> sed -i '/getty/d;/runsvdir/d' /etc/inittab - - - ## runit - # same as busybox-init, if you did not edit - # /etc/runit/2 move 2.new to 2 - -> mv /etc/runit/2.new /etc/runit/2 - - # else - -> vim /etc/runit/2 - # open your 2 file and remove the for loop containing - # getty commands. If you are using runit, it is recommended - # to comment out /etc/init/runit.boot - - ## sinit/minit - # If you did not edit your {sinit-,}launch-services.boot - # you can simply remove it. - -> rm -f /etc/init/launch-services.boot /etc/init/sinit-launch-services.boot - - # This should leave you without any issues, and you can safely reboot. - -Carbs-init update is to make sure init systems do not clash, and do -not have to use different files. This is a sensible update both for -the user user and for the maintainer side. - -To give an example, before this update busybox-init was managing getty -through `inittab`, runit was managing through `/etc/runit/2`, and -minit/sinit were launching from `/etc/init/launch-services.boot`. This -is a configuration nightmare for everyone, and since I am maintaining -and constantly testing those init providers, a huge nightmare for me. -This is a Quality of Life update. - diff --git a/index/20200218.news b/index/20200218.news deleted file mode 100644 index c6c7d83..0000000 --- a/index/20200218.news +++ /dev/null @@ -1,11 +0,0 @@ -Feb 18 2020 --------------------------------------------------------------------------------- - -A new tarball is released. It can be found on <https://dl.carbslinux.org>. - -**edit:** I have removed the tarball because of a bootstrapping issue. -I will be re-adding it later today. - -**edit 2:** I have added a tarball (20200219) to reflect my recent -changes on Busybox. - diff --git a/index/20200405.news b/index/20200405.news deleted file mode 100644 index d7c52f2..0000000 --- a/index/20200405.news +++ /dev/null @@ -1,14 +0,0 @@ -Apr 05 2020 --------------------------------------------------------------------------------- - -Carbs Linux repositories will be hosted only on Github. Commits will be -pushed there, and not the repository. You have until -May 4, 2020 Monday to switch your remotes to <https://github.com/CarbsLinux/repository>. -The git repository will continue to be served until then (without additional -commits). - -You can switch your remote by executing the following command on your -repository directory. - - git remote set-url origin https://github.com/CarbsLinux/repository - diff --git a/index/20200406.news b/index/20200406.news deleted file mode 100644 index 6ce25e8..0000000 --- a/index/20200406.news +++ /dev/null @@ -1,5 +0,0 @@ -Apr 06 2020 --------------------------------------------------------------------------------- - -A new rootfs tarball has been released. See the -[downloads](https://dl.carbslinux.org) page diff --git a/index/20200410.news b/index/20200410.news deleted file mode 100644 index 9627c7d..0000000 --- a/index/20200410.news +++ /dev/null @@ -1,4 +0,0 @@ -Apr 10 2020 --------------------------------------------------------------------------------- - -IRC channel can now be accessed from `#carbslinux` at freenode! diff --git a/index/20200427.news b/index/20200427.news deleted file mode 100644 index a0960ac..0000000 --- a/index/20200427.news +++ /dev/null @@ -1,7 +0,0 @@ -Apr 27 2020 --------------------------------------------------------------------------------- - -A new rootfs tarball has been released! You can -see it on <https://dl.carbslinux.org/releases>! - -**EDIT:** A new bug fix release has been made. diff --git a/index/20200510.news b/index/20200510.news deleted file mode 100644 index efee43f..0000000 --- a/index/20200510.news +++ /dev/null @@ -1,8 +0,0 @@ -May 10 2020 --------------------------------------------------------------------------------- - -A GCC 10.1.0 change causes a kernel panic for kernels built -with GCC 10.1. This issue can be resolved by applying this -[patch] to your kernel sources. - -[patch]: https://git.kernel.org/pub/scm/linux/kernel/git/tip/tip.git/patch/?id=f670269a42bfdd2c83a1118cc3d1b475547eac22 diff --git a/index/20200519.news b/index/20200519.news deleted file mode 100644 index 878bf97..0000000 --- a/index/20200519.news +++ /dev/null @@ -1,7 +0,0 @@ -May 19 2020 --------------------------------------------------------------------------------- - -A rootfs tarball targeting the i686 architecture has -been released. It can be found on the [downloads page] - -[downloads page]: https://dl.carbslinux.org/releases/i686 diff --git a/index/20200526.news b/index/20200526.news deleted file mode 100644 index a8e97ce..0000000 --- a/index/20200526.news +++ /dev/null @@ -1,7 +0,0 @@ -May 26 2020 --------------------------------------------------------------------------------- - -An initial version for binary package management is released. -It can be found on the [GitHub page]. - -[GitHub page]: https://github.com/CarbsLinux/kiss-bin diff --git a/index/20200727.news b/index/20200727.news deleted file mode 100644 index d75846d..0000000 --- a/index/20200727.news +++ /dev/null @@ -1,7 +0,0 @@ -Jul 27 2020 --------------------------------------------------------------------------------- - -Carbs Linux's fork of the `kiss` package manager has been renamed to -`Carbs Packaging Tools` due to huge amount of changes. Your latest `kiss` -update will handle the bootstrapping. You will need to rename your `KISS-*` -variables to `CPT-*` diff --git a/index/20200903.news b/index/20200903.news deleted file mode 100644 index 3822950..0000000 --- a/index/20200903.news +++ /dev/null @@ -1,6 +0,0 @@ -Sep 03 2020 --------------------------------------------------------------------------------- - -The default TLS provider has been reverted to 'libressl'. System update will -replace bearssl dependencies with libressl. You may choose to keep or remove -bearssl after the update. diff --git a/index/index.md b/index/index.md deleted file mode 100644 index da84be7..0000000 --- a/index/index.md +++ /dev/null @@ -1,61 +0,0 @@ -Carbs Linux is an in-development Linux® distribution with a suckless mindset. -The base system consists of only the necessary programs to create a Linux -distribution. - -Package Manager --------------------------------------------------------------------------------- - -Carbs Linux uses its own package manager [Carbs Packaging Tools], a POSIX shell -package manager forked from KISS with the tool-based approach of xbps. - - -Small base --------------------------------------------------------------------------------- - -By default, Carbs Linux comes with busybox for coreutils, bearssl for its -crypto library, musl libc, and other basic utilities that are required for -building new software. The majority of the base packages are statically linked. - - -Multiple Init Support --------------------------------------------------------------------------------- - -Carbs Linux has support for multiple init systems and service supervisors. In -the main repository are - -- `sinit` -- `busybox-init` (SysVinit clone) -- `runit-init` - -for init systems, and - -- `sysmgr` -- `busybox-runit` -- `runit` - -for service supervisors. The [carbs-init] package is the collection of init -scripts that ensure the interoperability of these init and service systems, and -make it easier for the user to switch to their preferred combinations of system -supervision. - -Nothing holds you back, however, from ditching any of these and packaging some -other system supervision technique along with your own init scripts. - - -[carbs-init]: https://github.com/CarbsLinux/repository/tree/master/core/carbs-init -[Carbs Packaging Tools]: https://github.com/CarbsLinux/cpt - -Links --------------------------------------------------------------------------------- - -* IRC - `#carbslinux` on freenode -* Reddit - [/r/carbslinux] -* [Mailing Lists] - -[/r/carbslinux]: http://reddit.com/r/carbslinux -[Mailing Lists]: /mailing-lists.html - -News --------------------------------------------------------------------------------- - -[RSS Feed](/news.xml) | [See all news](/news.html) diff --git a/news/20191210.org b/news/20191210.org new file mode 100644 index 0000000..7e7c0c8 --- /dev/null +++ b/news/20191210.org @@ -0,0 +1,4 @@ +#+TITLE: {{{date(%b %d\, %Y)}}} +#+DATE: <2019-12-10 Tue> + +First alpha release was made. See the [[https://dl.carbslinux.org/releases][downloads page]]. diff --git a/index/20191212.news b/news/20191212.org index fedcd24..df21941 100644 --- a/index/20191212.news +++ b/news/20191212.org @@ -1,5 +1,5 @@ -Dec 12 2019 --------------------------------------------------------------------------------- +#+TITLE: {{{date(%b %d\, %Y)}}} +#+DATE: <2019-12-12 Thu> Busybox and Busybox-init has been seperated into two different packages. This is for adding standalone runit/runit-init to the repositories. diff --git a/news/20191217.org b/news/20191217.org new file mode 100644 index 0000000..daa160b --- /dev/null +++ b/news/20191217.org @@ -0,0 +1,5 @@ +#+TITLE: {{{date(%b %d\, %Y)}}} +#+DATE: <2019-12-17 Tue> + +Installation instruction are now complete. A review would be greatly appreciated! + diff --git a/news/20191218.org b/news/20191218.org new file mode 100644 index 0000000..337cfdb --- /dev/null +++ b/news/20191218.org @@ -0,0 +1,4 @@ +#+TITLE: {{{date(%b %d\, %Y)}}} +#+DATE: <2019-12-18 Wed> + +carbs-rootfs-20191218.tar.xz was released. diff --git a/news/20200109.org b/news/20200109.org new file mode 100644 index 0000000..bb09f67 --- /dev/null +++ b/news/20200109.org @@ -0,0 +1,13 @@ +#+TITLE: {{{date(%b %d\, %Y)}}} +#+DATE: <2020-01-09 Thu> + +Happy new year, everyone! I am back after some long silence. I was unable to commit for a +while, but I have pulled some new updates from the KISS repository, added some of my own. +This week I will be changing/adding some things. + +Important things are, + +- Carbs-init was updated to 0.3. +- I will be adding an implementation of suckless.org's [[https://core.suckless.org/sinit][sinit]] as =carbs-sinit= +- Carbs Repository was added to [[https://repology.org/repository/carbs][repology.org]] +- A new rootfs tarball will be coming up tomorrow. diff --git a/news/20200110.org b/news/20200110.org new file mode 100644 index 0000000..0a83a3e --- /dev/null +++ b/news/20200110.org @@ -0,0 +1,4 @@ +#+TITLE: {{{date(%b %d\, %Y)}}} +#+DATE: <2020-01-10 Fri> + +carbs-rootfs-20200110.tar.xz was released. diff --git a/news/20200113.org b/news/20200113.org new file mode 100644 index 0000000..5fbdf9f --- /dev/null +++ b/news/20200113.org @@ -0,0 +1,23 @@ +#+TITLE: {{{date(%b %d\, %Y)}}} +#+DATE: <2020-01-13 Mon> + +**Busybox update reqires manual intervention** + +The new busybox package conflicts with the pre-update busybox-init. That's why +you should rebuild and install `busybox-init` before doing the update. + +#+BEGIN_SRC sh +# Do a kiss update first (but don't actually update it yet), or manually pull +# the git repository +kiss u # Cancel this operation after it asks for you to confirm the update + +# Install the busybox-init package +kiss b busybox-init && kiss i busybox-init + +# Continue your update as you normally would. +kiss u + +#+END_SRC + +I have moved runit and logging utilities from the busybox-init package to the busybox +package, which is the cause of these conflicts. diff --git a/news/20200115.org b/news/20200115.org new file mode 100644 index 0000000..8da8e13 --- /dev/null +++ b/news/20200115.org @@ -0,0 +1,4 @@ +#+TITLE: {{{date(%b %d\, %Y)}}} +#+DATE: <2020-01-15 Wed> + +sinit has been taken to =core=, and is now officially supported diff --git a/news/20200122.org b/news/20200122.org new file mode 100644 index 0000000..9e6b998 --- /dev/null +++ b/news/20200122.org @@ -0,0 +1,5 @@ +#+TITLE: {{{date(%b %d\, %Y)}}} +#+DATE: <2020-01-22 Wed> + +Expect downtime on Jan 24 2020 22:00 UTC as I will be migrating this web server +to my Carbs Linux server! diff --git a/news/20200128.org b/news/20200128.org new file mode 100644 index 0000000..e917fa3 --- /dev/null +++ b/news/20200128.org @@ -0,0 +1,10 @@ +#+TITLE: {{{date(%b %d\, %Y)}}} +#+DATE: <2020-01-28 Tue> + +Web Server is now on a Carbs Linux server. It is not complete yet, but I will be +adding a little more for the intended functionality. Downtimes can be expected. + +UPDATE: ssl is now working. + +UPDATE2: downloads are back again. + diff --git a/news/20200213.org b/news/20200213.org new file mode 100644 index 0000000..f37d9eb --- /dev/null +++ b/news/20200213.org @@ -0,0 +1,6 @@ +#+TITLE: {{{date(%b %d\, %Y)}}} +#+DATE: <2020-02-13 Thu> + +Runit is now released on the core repository! You can now replace busybox-init +with runit-init. You can also replace the busybox runit utilities with the +actual runit. This will reduce the dependency on busybox greatly. diff --git a/news/20200214.org b/news/20200214.org new file mode 100644 index 0000000..36b3325 --- /dev/null +++ b/news/20200214.org @@ -0,0 +1,50 @@ +#+TITLE: {{{date(%b %d\, %Y)}}} +#+DATE: <2020-02-14 Fri> + +**IMPORTANT!** Carbs-init update to be released on 17th of February +will require manual intervention. I am holding this update back so +people can see it before they update their system (even though the +update will show the same message as this). The rationale for the +update is explained below the intervention. + +#+BEGIN_SRC sh +# There is an explanation for each init You only need to follow the instructions +# for your own init-system + +## busybox-init +# If you did not edit your inittab simply move inittab.new to inittab +mv /etc/inittab.new /etc/inittab + +# If you did edit your inittab you can use a simple sed command to remove the +# necessary lines +sed -i '/getty/d;/runsvdir/d' /etc/inittab + + +## runit +# same as busybox-init, if you did not edit /etc/runit/2 move 2.new to 2 +mv /etc/runit/2.new /etc/runit/2 + +# else +vim /etc/runit/2 +# open your 2 file and remove the for loop containing getty commands. If you are +# using runit, it is recommended to comment out /etc/init/runit.boot + +## sinit/minit +# If you did not edit your {sinit-,}launch-services.boot you can simply remove +# it. +rm -f /etc/init/launch-services.boot /etc/init/sinit-launch-services.boot + +# This should leave you without any issues, and you can safely reboot. +#+END_SRC + +Carbs-init update is to make sure init systems do not clash, and do +not have to use different files. This is a sensible update both for +the user user and for the maintainer side. + +To give an example, before this update busybox-init was managing getty +through =inittab=, runit was managing through =/etc/runit/2=, and +minit/sinit were launching from =/etc/init/launch-services.boot=. This +is a configuration nightmare for everyone, and since I am maintaining +and constantly testing those init providers, a huge nightmare for me. +This is a Quality of Life update. + diff --git a/news/20200218.org b/news/20200218.org new file mode 100644 index 0000000..ee56dfd --- /dev/null +++ b/news/20200218.org @@ -0,0 +1,10 @@ +#+TITLE: {{{date(%b %d\, %Y)}}} +#+DATE: <2020-02-18 Tue> + +A new tarball is released. It can be found on [[https://dl.carbslinux.org]]. + +**edit:** I have removed the tarball because of a bootstrapping issue. I will be +re-adding it later today. + +**edit 2:** I have added a tarball (20200219) to reflect my recent changes on +Busybox. diff --git a/news/20200405.org b/news/20200405.org new file mode 100644 index 0000000..375a7ac --- /dev/null +++ b/news/20200405.org @@ -0,0 +1,14 @@ +#+TITLE: {{{date(%b %d\, %Y)}}} +#+DATE: <2020-04-05 Sun> + +Carbs Linux repositories will be hosted only on Github. Commits will be pushed +there, and not the repository. You have until May 4, 2020 Monday to switch your +remotes to [[https://github.com/CarbsLinux/repository]]. The git repository will +continue to be served until then (without additional commits). + +You can switch your remote by executing the following command on your repository +directory. + +#+BEGIN_SRC sh +git remote set-url origin https://github.com/CarbsLinux/repository +#+END_SRC diff --git a/news/20200406.org b/news/20200406.org new file mode 100644 index 0000000..31209ca --- /dev/null +++ b/news/20200406.org @@ -0,0 +1,4 @@ +#+TITLE: {{{date(%b %d\, %Y)}}} +#+DATE: <2020-04-06 Mon> + +A new rootfs tarball has been released. See the downloads page. diff --git a/news/20200410.org b/news/20200410.org new file mode 100644 index 0000000..fda05fb --- /dev/null +++ b/news/20200410.org @@ -0,0 +1,4 @@ +#+TITLE: {{{date(%b %d\, %Y)}}} +#+DATE: <2020-04-10 Fri> + +IRC channel can now be accessed from =#carbslinux= at freenode! diff --git a/news/20200427.org b/news/20200427.org new file mode 100644 index 0000000..867f83c --- /dev/null +++ b/news/20200427.org @@ -0,0 +1,7 @@ +#+TITLE: {{{date(%b %d\, %Y)}}} +#+DATE: <2020-04-27 Mon> + +A new rootfs tarball has been released! You can see it on +[[https://dl.carbslinux.org/releases]]! + +**EDIT:** A new bug fix release has been made. diff --git a/news/20200510.org b/news/20200510.org new file mode 100644 index 0000000..c7b7d32 --- /dev/null +++ b/news/20200510.org @@ -0,0 +1,7 @@ +#+TITLE: {{{date(%b %d\, %Y)}}} +#+DATE: <2020-05-10 Sun> + +A GCC 10.1.0 change causes a kernel panic for kernels built with GCC 10.1. This +issue can be resolved by applying this [[https://git.kernel.org/pub/scm/linux/kernel/git/tip/tip.git/patch/?id=f670269a42bfdd2c83a1118cc3d1b475547eac22][patch]] to your kernel sources. + +**EDIT:** The patch is no longer necessary. diff --git a/news/20200519.org b/news/20200519.org new file mode 100644 index 0000000..0583f19 --- /dev/null +++ b/news/20200519.org @@ -0,0 +1,5 @@ +#+TITLE: {{{date(%b %d\, %Y)}}} +#+DATE: <2020-05-19 Tue> + +A rootfs tarball targeting the i686 architecture has been released. It can be +found on the downloads page. diff --git a/news/20200526.org b/news/20200526.org new file mode 100644 index 0000000..70c4fec --- /dev/null +++ b/news/20200526.org @@ -0,0 +1,5 @@ +#+TITLE: {{{date(%b %d\, %Y)}}} +#+DATE: <2020-05-26 Tue> + +An initial version for binary package management is released. It can be found on +the [[https://github.com/CarbsLinux/kiss-bin][GitHub page]]. diff --git a/index/20200617.news b/news/20200617.org index 07b290f..0aee0df 100644 --- a/index/20200617.news +++ b/news/20200617.org @@ -1,5 +1,5 @@ -Jun 17 2020 --------------------------------------------------------------------------------- +#+TITLE: {{{date(%b %d\, %Y)}}} +#+DATE: <2020-06-17 Wed> A new rootfs tarball including the changes to the core is released and can be found on the downloads page. diff --git a/news/20200727.org b/news/20200727.org new file mode 100644 index 0000000..0afe0b3 --- /dev/null +++ b/news/20200727.org @@ -0,0 +1,7 @@ +#+TITLE: {{{date(%b %d\, %Y)}}} +#+DATE: <2020-07-27 Mon> + +Carbs Linux's fork of the =kiss= package manager has been renamed to =Carbs +Packaging Tools= due to huge amount of changes. Your latest =kiss= update will +handle the bootstrapping. You will need to rename your =KISS-*= variables to +=CPT-*=. diff --git a/news/20200903.org b/news/20200903.org new file mode 100644 index 0000000..4c1941d --- /dev/null +++ b/news/20200903.org @@ -0,0 +1,6 @@ +#+TITLE: {{{date(%b %d\, %Y)}}} +#+DATE: <2020-09-03 Thu> + +The default TLS provider has been reverted to =libressl=. System update will +replace bearssl dependencies with libressl. You may choose to keep or remove +bearssl after the update. diff --git a/index/20200916.news b/news/20200916.org index 29b68f9..50e9ecb 100644 --- a/index/20200916.news +++ b/news/20200916.org @@ -1,5 +1,5 @@ -Sep 16 2020 --------------------------------------------------------------------------------- +#+TITLE: {{{date(%b %d\, %Y)}}} +#+DATE: <2020-09-16 Wed> The libressl "revert" was reverted. System update will replace libressl dependencies with bearssl. You may choose to keep or remove bearssl after the diff --git a/news/index.org b/news/index.org new file mode 100644 index 0000000..3a09a0f --- /dev/null +++ b/news/index.org @@ -0,0 +1,107 @@ +#+TITLE: News Index + +* [[file:20200916.html][Sep 16, 2020]] +The libressl "revert" was reverted. System update will replace libressl +dependencies with bearssl. You may choose to keep or remove bearssl after the +update. +* [[file:20200903.html][Sep 03, 2020]] +The default TLS provider has been reverted to =libressl=. System update will +replace bearssl dependencies with libressl. You may choose to keep or remove +bearssl after the update. +* [[file:20200727.html][Jul 27, 2020]] +Carbs Linux's fork of the =kiss= package manager has been renamed to =Carbs + Packaging Tools= due to huge amount of changes. Your latest =kiss= update will +handle the bootstrapping. You will need to rename your =KISS-*= variables to +=CPT-*=. +* [[file:20200617.html][Jun 17, 2020]] +A new rootfs tarball including the changes to the core is released and can be +found on the downloads page. +* [[file:20200526.html][May 26, 2020]] +An initial version for binary package management is released. It can be found on +the [[https://github.com/CarbsLinux/kiss-bin][GitHub page]]. +* [[file:20200519.html][May 19, 2020]] +A rootfs tarball targeting the i686 architecture has been released. It can be +found on the downloads page. +* [[file:20200510.html][May 10, 2020]] +A GCC 10.1.0 change causes a kernel panic for kernels built with GCC 10.1. This +issue can be resolved by applying this [[https://git.kernel.org/pub/scm/linux/kernel/git/tip/tip.git/patch/?id=f670269a42bfdd2c83a1118cc3d1b475547eac22][patch]] to your kernel sources. + +**EDIT:** The patch is no longer necessary. +* [[file:20200427.html][Apr 27, 2020]] +A new rootfs tarball has been released! You can see it on +[[https://dl.carbslinux.org/releases]]! + +**EDIT:** A new bug fix release has been made. +* [[file:20200410.html][Apr 10, 2020]] +IRC channel can now be accessed from =#carbslinux= at freenode! +* [[file:20200406.html][Apr 06, 2020]] +A new rootfs tarball has been released. See the downloads page. +* [[file:20200405.html][Apr 05, 2020]] +Carbs Linux repositories will be hosted only on Github. Commits will be pushed +there, and not the repository. You have until May 4, 2020 Monday to switch your +remotes to [[https://github.com/CarbsLinux/repository]]. The git repository will +continue to be served until then (without additional commits). + +You can switch your remote by executing the following command on your repository +directory. + +#+begin_src sh + git remote set-url origin https://github.com/CarbsLinux/repository +#+end_src +* [[file:20200218.html][Feb 18, 2020]] +A new tarball is released. It can be found on [[https://dl.carbslinux.org]]. + +**edit:** I have removed the tarball because of a bootstrapping issue. I will be +re-adding it later today. + +**edit 2:** I have added a tarball (20200219) to reflect my recent changes on +Busybox. +* [[file:20200214.html][Feb 14, 2020]] +**IMPORTANT!** Carbs-init update to be released on 17th of February +will require manual intervention. I am holding this update back so +people can see it before they update their system (even though the +update will show the same message as this). The rationale for the +update is explained below the intervention. + +#+begin_src sh + # There is an explanation for each init You only need to follow the instructions + # for your own init-system + + ## busybox-init + # If you did not edit your inittab simply move inittab.new to inittab + mv /etc/inittab.new /etc/inittab + + # If you did edit your inittab you can use a simple sed command to remove the + # necessary lines + sed -i '/getty/d;/runsvdir/d' /etc/inittab + + + ## runit + # same as busybox-init, if you did not edit /etc/runit/2 move 2.new to 2 + mv /etc/runit/2.new /etc/runit/2 + + # else + vim /etc/runit/2 + # open your 2 file and remove the for loop containing getty commands. If you are + # using runit, it is recommended to comment out /etc/init/runit.boot + + ## sinit/minit + # If you did not edit your {sinit-,}launch-services.boot you can simply remove + # it. + rm -f /etc/init/launch-services.boot /etc/init/sinit-launch-services.boot + + # This should leave you without any issues, and you can safely reboot. +#+end_src + +Carbs-init update is to make sure init systems do not clash, and do +not have to use different files. This is a sensible update both for +the user user and for the maintainer side. + +To give an example, before this update busybox-init was managing getty +through =inittab=, runit was managing through =/etc/runit/2=, and +minit/sinit were launching from =/etc/init/launch-services.boot=. This +is a configuration nightmare for everyone, and since I am maintaining +and constantly testing those init providers, a huge nightmare for me. +This is a Quality of Life update. + + diff --git a/news/latest-news.org b/news/latest-news.org new file mode 100644 index 0000000..6922cf2 --- /dev/null +++ b/news/latest-news.org @@ -0,0 +1,19 @@ +* [[file:20200916.html][Sep 16, 2020]] +The libressl "revert" was reverted. System update will replace libressl +dependencies with bearssl. You may choose to keep or remove bearssl after the +update. +* [[file:20200903.html][Sep 03, 2020]] +The default TLS provider has been reverted to =libressl=. System update will +replace bearssl dependencies with libressl. You may choose to keep or remove +bearssl after the update. +* [[file:20200727.html][Jul 27, 2020]] +Carbs Linux's fork of the =kiss= package manager has been renamed to =Carbs + Packaging Tools= due to huge amount of changes. Your latest =kiss= update will +handle the bootstrapping. You will need to rename your =KISS-*= variables to +=CPT-*=. +* [[file:20200617.html][Jun 17, 2020]] +A new rootfs tarball including the changes to the core is released and can be +found on the downloads page. +* [[file:20200526.html][May 26, 2020]] +An initial version for binary package management is released. It can be found on +the [[https://github.com/CarbsLinux/kiss-bin][GitHub page]]. diff --git a/news/news.org b/news/news.org new file mode 100644 index 0000000..1934369 --- /dev/null +++ b/news/news.org @@ -0,0 +1,172 @@ +#+TITLE: Carbs Linux news +#+DESCRIPTION: a simple Linux distribution + +* {{{date(%b %d\, %Y)}}} +:PROPERTIES: +:RSS_PERMALINK: 20200916.html +:PUBDATE: 2020-09-16 +:ID: ab636904-61dd-4fba-934c-6d5e2e2c7a9e +:END: +The libressl "revert" was reverted. System update will replace libressl +dependencies with bearssl. You may choose to keep or remove bearssl after the +update. +* {{{date(%b %d\, %Y)}}} +:PROPERTIES: +:RSS_PERMALINK: 20200903.html +:PUBDATE: 2020-09-03 +:ID: fb6e737c-93d4-4010-a374-d395744563bf +:END: +The default TLS provider has been reverted to =libressl=. System update will +replace bearssl dependencies with libressl. You may choose to keep or remove +bearssl after the update. +* {{{date(%b %d\, %Y)}}} +:PROPERTIES: +:RSS_PERMALINK: 20200727.html +:PUBDATE: 2020-07-27 +:ID: b47e26d5-3210-4125-b41e-8654e1c1e319 +:END: +Carbs Linux's fork of the =kiss= package manager has been renamed to =Carbs + Packaging Tools= due to huge amount of changes. Your latest =kiss= update will +handle the bootstrapping. You will need to rename your =KISS-*= variables to +=CPT-*=. +* {{{date(%b %d\, %Y)}}} +:PROPERTIES: +:RSS_PERMALINK: 20200617.html +:PUBDATE: 2020-06-17 +:ID: 0fa2546c-3cec-42c3-a620-c44aeb14bd82 +:END: +A new rootfs tarball including the changes to the core is released and can be +found on the downloads page. +* {{{date(%b %d\, %Y)}}} +:PROPERTIES: +:RSS_PERMALINK: 20200526.html +:PUBDATE: 2020-05-26 +:ID: 327084ea-554d-4604-8d1d-27a9017fa4bf +:END: +An initial version for binary package management is released. It can be found on +the [[https://github.com/CarbsLinux/kiss-bin][GitHub page]]. +* {{{date(%b %d\, %Y)}}} +:PROPERTIES: +:RSS_PERMALINK: 20200519.html +:PUBDATE: 2020-05-19 +:ID: e3cc197e-693d-4ed4-a766-19ae94d4e655 +:END: +A rootfs tarball targeting the i686 architecture has been released. It can be +found on the downloads page. +* {{{date(%b %d\, %Y)}}} +:PROPERTIES: +:RSS_PERMALINK: 20200510.html +:PUBDATE: 2020-05-10 +:ID: 05213ce1-1eed-4736-8663-32c95e8f58a5 +:END: +A GCC 10.1.0 change causes a kernel panic for kernels built with GCC 10.1. This +issue can be resolved by applying this [[https://git.kernel.org/pub/scm/linux/kernel/git/tip/tip.git/patch/?id=f670269a42bfdd2c83a1118cc3d1b475547eac22][patch]] to your kernel sources. + +**EDIT:** The patch is no longer necessary. +* {{{date(%b %d\, %Y)}}} +:PROPERTIES: +:RSS_PERMALINK: 20200427.html +:PUBDATE: 2020-04-27 +:ID: 35dd49b7-15ed-4e17-8aaf-6b3331253a1f +:END: +A new rootfs tarball has been released! You can see it on +[[https://dl.carbslinux.org/releases]]! + +**EDIT:** A new bug fix release has been made. +* {{{date(%b %d\, %Y)}}} +:PROPERTIES: +:RSS_PERMALINK: 20200410.html +:PUBDATE: 2020-04-10 +:ID: e08b6a03-9967-4b72-aef3-5cafbe8fc926 +:END: +IRC channel can now be accessed from =#carbslinux= at freenode! +* {{{date(%b %d\, %Y)}}} +:PROPERTIES: +:RSS_PERMALINK: 20200406.html +:PUBDATE: 2020-04-06 +:ID: a62bac15-b653-4b2d-b9b0-d59a71718f6b +:END: +A new rootfs tarball has been released. See the downloads page. +* {{{date(%b %d\, %Y)}}} +:PROPERTIES: +:RSS_PERMALINK: 20200405.html +:PUBDATE: 2020-04-05 +:ID: 80ab6b81-ed74-4ccd-bae5-01a179864631 +:END: +Carbs Linux repositories will be hosted only on Github. Commits will be pushed +there, and not the repository. You have until May 4, 2020 Monday to switch your +remotes to [[https://github.com/CarbsLinux/repository]]. The git repository will +continue to be served until then (without additional commits). + +You can switch your remote by executing the following command on your repository +directory. + +#+begin_src sh + git remote set-url origin https://github.com/CarbsLinux/repository +#+end_src +* {{{date(%b %d\, %Y)}}} +:PROPERTIES: +:RSS_PERMALINK: 20200218.html +:PUBDATE: 2020-02-18 +:ID: 74395814-c8cc-4616-99ca-ce1f7b5d1f6e +:END: +A new tarball is released. It can be found on [[https://dl.carbslinux.org]]. + +**edit:** I have removed the tarball because of a bootstrapping issue. I will be +re-adding it later today. + +**edit 2:** I have added a tarball (20200219) to reflect my recent changes on +Busybox. +* {{{date(%b %d\, %Y)}}} +:PROPERTIES: +:RSS_PERMALINK: 20200214.html +:PUBDATE: 2020-02-14 +:ID: 17da458e-41cc-424d-ae9c-789720db202b +:END: +**IMPORTANT!** Carbs-init update to be released on 17th of February +will require manual intervention. I am holding this update back so +people can see it before they update their system (even though the +update will show the same message as this). The rationale for the +update is explained below the intervention. + +#+begin_src sh + # There is an explanation for each init You only need to follow the instructions + # for your own init-system + + ## busybox-init + # If you did not edit your inittab simply move inittab.new to inittab + mv /etc/inittab.new /etc/inittab + + # If you did edit your inittab you can use a simple sed command to remove the + # necessary lines + sed -i '/getty/d;/runsvdir/d' /etc/inittab + + + ## runit + # same as busybox-init, if you did not edit /etc/runit/2 move 2.new to 2 + mv /etc/runit/2.new /etc/runit/2 + + # else + vim /etc/runit/2 + # open your 2 file and remove the for loop containing getty commands. If you are + # using runit, it is recommended to comment out /etc/init/runit.boot + + ## sinit/minit + # If you did not edit your {sinit-,}launch-services.boot you can simply remove + # it. + rm -f /etc/init/launch-services.boot /etc/init/sinit-launch-services.boot + + # This should leave you without any issues, and you can safely reboot. +#+end_src + +Carbs-init update is to make sure init systems do not clash, and do +not have to use different files. This is a sensible update both for +the user user and for the maintainer side. + +To give an example, before this update busybox-init was managing getty +through =inittab=, runit was managing through =/etc/runit/2=, and +minit/sinit were launching from =/etc/init/launch-services.boot=. This +is a configuration nightmare for everyone, and since I am maintaining +and constantly testing those init providers, a huge nightmare for me. +This is a Quality of Life update. + diff --git a/org-publish.el b/org-publish.el new file mode 100755 index 0000000..46b196a --- /dev/null +++ b/org-publish.el @@ -0,0 +1,303 @@ +#!/usr/bin/emacs --script +;; Lots of code were taken from: +;; - https://gitlab.com/to1ne/blog/-/blob/master/elisp/publish.el +;; - https://github.com/dmacvicar/site.org/blob/master/publish.el + +;; I don't want this script, especially package, to mess my Emacs directory. +(setq user-emacs-directory (expand-file-name ".cache/" default-directory)) +(load-file (expand-file-name "elisp/no-littering.el" default-directory)) + +(setq package-user-dir (with-no-warnings (no-littering-expand-var-file-name "package/"))) +(require 'package) +(package-initialize) + +(unless package-archive-contents + (add-to-list 'package-archives '("org" . "https://orgmode.org/elpa/") t) + (add-to-list 'package-archives '("melpa" . "https://melpa.org/packages/") t) + (package-refresh-contents)) + +(dolist (pkg '(org-plus-contrib htmlize)) + (unless (package-installed-p pkg) + (package-install pkg))) + +(require 'cl-lib) +(require 'sh-script) +(require 'ox) +(require 'ox-publish) +(require 'ox-rss) + +(defvar carbs--src-directory (expand-file-name "src/" default-directory) + "Directory for most of the static webpage content") + +(defvar carbs--publish-directory (expand-file-name "docs/" default-directory) + "Root directory of the published website") + +(defvar carbs--news-directory (expand-file-name "news/" default-directory) + "Directory for news posts.") + +(defvar carbs--blog-directory (expand-file-name "blog/" default-directory) + "Directory for blog posts.") + +(defvar carbs--template-directory (expand-file-name "templates/" default-directory) + "Directory for all types of templates") + +(defun carbs--insert-template (file) + "Insert FILE from `carbs--template-directory'." + (with-temp-buffer + (insert-file-contents (expand-file-name file carbs--template-directory)) + (buffer-string))) + +(defun carbs/org-html-publish-to-html (plist filename pub-dir) + "Wrapper function that adds publishing date as a subtitle. + +PLIST contains the properties, FILENAME the source file and + PUB-DIR the output directory." + (let ((project (cons 'rw plist))) + (plist-put plist :subtitle + (carbs/format-date-subtitle filename project)) + (org-html-publish-to-html plist filename pub-dir))) + +(defun carbs/org-html-publish-blog-index (plist filename pub-dir) + "Wrapper function to publish only the index file to html. +PLIST contains the properties, FILENAME the source file and PUB-DIR the output +directory." + (if (equal "index.org" (file-name-nondirectory filename)) + (org-html-publish-to-html plist filename pub-dir))) + +(defun carbs/format-rss-feed-entry (entry style project) + "Format ENTRY for the RSS feed. +ENTRY is a file name. STYLE is either 'list' or 'tree'. +PROJECT is the current project." + (cond ((not (directory-name-p entry)) + (let* ((file (org-publish--expand-file-name entry project)) + (title (org-publish-find-title entry project)) + (date (format-time-string "%Y-%m-%d" (org-publish-find-date entry project))) + (link (concat (file-name-sans-extension entry) ".html"))) + (with-temp-buffer + (insert (format "* %s\n" title)) + (org-set-property "RSS_PERMALINK" link) + (org-set-property "PUBDATE" date) + (insert-file-contents file) + (buffer-string)))) + ((eq style 'tree) + ;; Return only last subdir. + (file-name-nondirectory (directory-file-name entry))) + (t entry))) + +(defun carbs/format-rss-feed (title list) + "Generate RSS feed, as a string. +TITLE is the title of the RSS feed. LIST is an internal +representation for the files to include, as returned by +`org-list-to-lisp'. PROJECT is the current project." + (concat "#+TITLE: " title "\n" + "#+DESCRIPTION: a simple Linux distribution\n\n" + (org-list-to-subtree list 1 '(:icount "" :istart "")))) + +(defun carbs/org-rss-publish-to-rss (plist filename pub-dir) + "Publish RSS with PLIST, only when FILENAME is 'rss.org'. +PUB-DIR is when the output will be placed." + (org-rss-publish-to-rss plist filename pub-dir)) + +(defun carbs/format-date-subtitle (file project) + "Format the date found in FILE of PROJECT." + (format-time-string "posted on %Y-%m-%d" (org-publish-find-date file project))) + +(defun carbs--pre/postamble-format (type) + "Return the content for the pre/postamble of TYPE." + `(("en" ,(carbs--insert-template (format "%s.html" type))))) + +(defun carbs/org-publish-sitemap (title list) + "Generate sitemap as a string, having TITLE. +LIST is an internal representation for the files to include, as +returned by `org-list-to-lisp'." + (let ((filtered-list (cl-remove-if (lambda (x) + (and (sequencep x) (null (car x)))) + list))) + (concat (carbs--insert-template "blog.org") + (org-list-to-org filtered-list) "\n"))) + +(defun carbs/org-publish-sitemap-entry (entry style project) + "Format for sitemap ENTRY, as a string. +ENTRY is a file name. STYLE is the style of the sitemap. +PROJECT is the current project." + (unless (equal entry "404.org") + (format "[[file:%s][%s]] /%s/" + entry + (org-publish-find-title entry project) + (carbs/format-date-subtitle entry project)))) + +(defun carbs/org-publish-news (title list) + "Generate sitemap as a string, having TITLE. +LIST is an internal representation for the files to include, as +returned by `org-list-to-lisp'." + (let ((filtered-list (cl-remove-if (lambda (x) + (and (sequencep x) (null (car x)))) + list))) + (concat "#+TITLE: News Index\n\n" + (org-list-to-subtree filtered-list 1 '(:istart "" :icount "")) "\n"))) + +(defun carbs/org-publish-news-latest (title list) + "Generate sitemap as a string, having TITLE. +LIST is an internal representation for the files to include, as +returned by `org-list-to-lisp'." + (let* ((filtered-list (cl-remove-if (lambda (x) + (and (sequencep x) (null (car x)))) + list)) + (latest-posts (seq-subseq filtered-list 0 (min (length filtered-list) 6)))) + (concat + (org-list-to-subtree latest-posts 1 '(:istart "" :icount "")) "\n"))) + +(defun carbs/org-publish-news-entry (entry style project) + "Format for sitemap ENTRY, as a string. +ENTRY is a file name. STYLE is the style of the sitemap. +PROJECT is the current project." + (cond ((not (directory-name-p entry)) + (let* ((file (org-publish--expand-file-name entry project)) + (date (format-time-string "%b %d, %Y" (org-publish-find-date entry project))) + (link (concat (file-name-sans-extension entry) ".html"))) + (with-temp-buffer + (insert (format "* [[file:%s][%s]]\n" link date)) + (insert-file-contents file) + (buffer-string)))) + ((eq style 'tree) + ;; Return only last subdir. + (file-name-nondirectory (directory-file-name entry))) + (t entry))) + +(setq user-full-name "Cem Keylan" + user-mail-address "root@carbslinux.org" + org-publish-timestamp-directory (with-no-warnings (no-littering-expand-var-file-name "timestamps/")) + org-html-doctype "html5" + org-html-head "<link rel=\"stylesheet\" type=\"text/css\" href=\"/style.css\">" + org-html-head-include-scripts nil + org-html-metadata-timestamp-format "%Y-%m-%d" + org-html-head-include-default-style nil + org-html-html5-fancy t + org-html-htmlize-output-type 'css + org-export-with-toc nil + org-export-with-section-numbers nil + + org-publish-project-alist + (list + (list "news" + :author "" + :base-directory carbs--news-directory + :html-preamble t + :html-postamble t + :html-preamble-format (carbs--pre/postamble-format 'preamble) + :html-postamble-format (carbs--pre/postamble-format 'postamble) + :publishing-directory (expand-file-name "news/" carbs--publish-directory) + :publishing-function '(org-html-publish-to-html org-ascii-publish-to-ascii) + :exclude (regexp-opt '("index.org" "news.org" "latest-news.org")) + :auto-sitemap t + :sitemap-filename "index.org" + :sitemap-style 'list + :sitemap-title "Carbs Linux news" + :sitemap-sort-files 'anti-chronologically + :sitemap-function 'carbs/org-publish-news + :sitemap-format-entry 'carbs/org-publish-news-entry) + (list "news-rss-generate" + :base-directory carbs--news-directory + :publishing-directory carbs--publish-directory + :publishing-function 'ignore + :exclude (regexp-opt '("index.org" "news.org" "latest-news.org")) + :html-link-home "https://carbslinux.org/news" + :auto-sitemap t + :sitemap-filename "news.org" + :sitemap-style 'list + :sitemap-title "Carbs Linux news" + :sitemap-sort-files 'anti-chronologically + :sitemap-function 'carbs/format-rss-feed + :sitemap-format-entry 'carbs/format-rss-feed-entry) + (list "latest-news" + :base-directory carbs--news-directory + :publishing-directory carbs--publish-directory + :publishing-function 'ignore + :exclude (regexp-opt '("index.org" "news.org" "latest-news.org")) + :auto-sitemap t + :sitemap-filename "latest-news.org" + :sitemap-style 'list + :sitemap-title "Carbs Linux news" + :sitemap-sort-files 'anti-chronologically + :sitemap-function 'carbs/org-publish-news-latest + :sitemap-format-entry 'carbs/org-publish-news-entry) + (list "news-rss-publish" + :base-directory carbs--news-directory + :exclude "." + :include '("news.org") + :rss-extension "xml" + :recursive t + :html-link-home "https://carbslinux.org/news" + :publishing-directory carbs--publish-directory + :publishing-function 'carbs/org-rss-publish-to-rss) + (list "home" + :base-directory carbs--src-directory + :html-preamble t + :html-postamble t + :html-preamble-format (carbs--pre/postamble-format 'preamble) + :html-postamble-format (carbs--pre/postamble-format 'postamble) + :publishing-directory carbs--publish-directory + :publishing-function 'org-html-publish-to-html) + (list "blog-index-publish" + :base-directory carbs--blog-directory + :publishing-directory (expand-file-name "blog/" carbs--publish-directory) + :publishing-function 'carbs/org-html-publish-blog-index + :html-preamble t + :html-postamble t + :html-preamble-format (carbs--pre/postamble-format 'preamble) + :html-postamble-format (carbs--pre/postamble-format 'postamble) + :html-link-org-files-as-html t + :exclude (regexp-opt '("rss.org" "index.org")) + :auto-sitemap t + :sitemap-filename "index.org" + :sitemap-style 'list + :sitemap-title "Carbs Linux blog" + :sitemap-sort-files 'anti-chronologically + :sitemap-function 'carbs/org-publish-sitemap + :sitemap-format-entry 'carbs/org-publish-sitemap-entry) + (list "blog" + :base-directory carbs--blog-directory + :publishing-directory (expand-file-name "blog/" carbs--publish-directory) + :publishing-function 'carbs/org-html-publish-to-html + :html-preamble t + :html-postamble t + :html-preamble-format (carbs--pre/postamble-format 'preamble) + :html-postamble-format (carbs--pre/postamble-format 'postamble) + :exclude (regexp-opt '("rss.org" "index.org")) + :html-link-org-files-as-html t) + (list "blog-generate-rss-sitemap" + :base-extension "org" + :base-directory carbs--blog-directory + :html-link-home "https://carbslinux.org/blog" + :exclude (regexp-opt '("rss.org" "index.org")) + :publishing-function 'ignore + :publishing-directory (expand-file-name "blog/" carbs--publish-directory) + :rss-extension "xml" + :auto-sitemap t + :html-link-org-files-as-html t + :sitemap-filename "rss.org" + :sitemap-title "Carbs Linux blog" + :sitemap-style 'list + :sitemap-sort-files 'anti-chronologically + :sitemap-function 'carbs/format-rss-feed + :sitemap-format-entry 'carbs/format-rss-feed-entry) + (list "blog-publish-rss-sitemap" + :base-directory carbs--blog-directory + :rss-extension "xml" + :recursive t + :exclude "." + :include '("rss.org") + :publishing-directory carbs--publish-directory + :publishing-function 'carbs/org-rss-publish-to-rss + :html-link-home "https://carbslinux.org/blog" + :html-link-use-abs-url t) + (list "plaintext" + :author "" + :base-directory carbs--src-directory + :publishing-directory carbs--publish-directory + :publishing-function 'org-ascii-publish-to-ascii + :base-extension "org" + :exclude (regexp-opt '("rss.org")) + :recursive t))) + +(org-publish-all) diff --git a/src/404.md b/src/404.md deleted file mode 100644 index afd5166..0000000 --- a/src/404.md +++ /dev/null @@ -1,3 +0,0 @@ -# 404 - -Requested page not found. diff --git a/src/blog/20200128.md b/src/blog/20200128.md deleted file mode 100644 index 5c56b45..0000000 --- a/src/blog/20200128.md +++ /dev/null @@ -1,21 +0,0 @@ -Switching to New Website -======================== - -**Date:** Jan 28 2020 - -In case you haven't seen it before, this website -was powered by [werc](http://werc.cat-v.org). And -even though I liked it really much, it was too -powerful for a small website like this. - -So I have decided to reimplement this website with -my own static generation scripts. The source will -probably be on <https://carbslinux.org/git/website/log.html> -when I decide to publish the website. - -The generation requires Plan9 programs, although -I have used them just for my enthusiasm. I have built -the site with a combination of mk (instead of make), rc, -and POSIX sh. I am not yet exactly familiar with rc, -but I will replace the shell scripts when I feel like -I can. diff --git a/src/blog/20200406.md b/src/blog/20200406.md deleted file mode 100644 index c695b69..0000000 --- a/src/blog/20200406.md +++ /dev/null @@ -1,84 +0,0 @@ -Roadmap for Carbs -================= - -It has been a busy week. There are lots of changes in -direction, and more to come. I want to talk a little -about all of them. - - -Carbs Linux Server Going Down ------------------------------ - -It became harder to maintain and pay for the server, and I will be -shutting it down in May. I am currently in the phase of -carrying over everything to [Github]. The repository and the -website is served on Github now. I have also moved the [Wiki] -to Github and anyone can edit it there. There are some outdated -posts that I will be fixing around this week. - -I am not quite sure where to store the downloads page now. But I -will be switching that to a new source as well. (Maybe Source Forge?) - -I feel a little sad for switching, but serving on Github is faster, -cheaper, and hassle-free. - -[Github]: https://github.com/CarbsLinux -[Wiki]: https://github.com/CarbsLinux/wiki/wiki - - -Forking KISS ------------- - -I had a personal fork of KISS, which I enjoyed thoroughly. I didn't -intend to make it the default when I started it, but it has matured -enough to be so. The package manager can now be found on [this repository]. -See it for the added changes. - -This will be a change for the better, as I can develop the package -manager as it fits my views. - -[this repository]: https://github.com/CarbsLinux/kiss - - -Small Changes on the Website ----------------------------- - -I have made some small changes on the website. The build is not dependent -on Plan9 utilities anymore. It was fun messing around with `rc` and `mk`, -but they are quite limited compared to POSIX shell. - -RSS feeds are finally working as intended, both for the [news] section, and -the [blog] secion. - -You can see every page's `.txt` output at the end of the page by clicking -'View Page Source'. Meanwhile, I will be updating some pages to be a little -more 'human-readable'. - -[news]: https://carbslinux.org/news.xml -[blog]: https://carbslinux.org/rss.xml - - -Outsources Repository ---------------------- - -I have opened an `outsource` repository, which I will be pushing this week. -I will add a new post when I am ready to push it. I think it will be interesting, -it will also make more sense about the changes I have added to the package -manager. The now empty repository, can be found [here]! - -[here]: https://github.com/CarbsLinux/outsource - - -New Tarball ------------ - -Finally, I have released a new tarball today, which can be obtained from the -[downloads page]. - -[downloads page]: https://dl.carbslinux.org/releases - - -I am planning to add more of these update posts as I'm feeling better about -the website structure overall. - -\- Cem diff --git a/src/blog/20200410.md b/src/blog/20200410.md deleted file mode 100644 index f6edffe..0000000 --- a/src/blog/20200410.md +++ /dev/null @@ -1,24 +0,0 @@ -Outsource Repository Concept -============================ - -In April 3rd, I have added submodule support for Carbs -Linux's fork of `kiss`. Now, from that sentence, it really -doesn't sound exciting at all. But in reality, it opens a -path to lots of creative output, and a better way to manage -multi-user repositories (such as KISS Community). - -When managing a repository of submodules, the repository -maintainer's only job is to deal with adding packages. -A package maintainer doesn't have to wait for the repository -maintainer to update their packages, as they are only making -the changes to their own repositories. - -This way, an end-user can also track from their preferred -maintainers, and do that with the tidyness of a single repository -in their `KISS_PATH`. - -Carbs Linux now has an outsource repository for some packages. -Firefox and its dependencies have been purged from the main repository, -but can be found on it. - -<https://github.com/CarbsLinux/outsource> diff --git a/src/blog/20200508.md b/src/blog/20200508.md deleted file mode 100644 index f1b2cdd..0000000 --- a/src/blog/20200508.md +++ /dev/null @@ -1,141 +0,0 @@ -The Relation of Carbs and KISS -============================== - -**Date:** May 08 2020 - -Since I have forked KISS, I have received many questions -that can be summarized as "Why?". I have realized that I -never truly answered this question. That's the reason I am -writing this post, to give some background on Carbs, and -some differences between KISS Linux and Carbs Linux for -anyone who may be wondering. Perhaps I could make this a -"FAQ" page later on. - -History -------- - -I had the idea of creating my own Linux distribution since -the May of 2019. Back then, I had my own [Linux from Scratch] -build, and I wanted to slim it down my own way and replace -the software (with musl,sbase,etc.). The name Carbs Linux -was in my mind since then. I wanted to write my own package -manager, but I wasn't satisfied with anything I had built. - -I had written some incomplete package managers (all named `fat`) -and I quickly threw them into the trash can, where they -honestly belonged. I would want to share them with you for -laughs, but my hard-drive got wiped and I have a problem -of not doing an "initial commit" until a program I write -is in a usable state. - -I have obtained the 'carbslinux.org' domain name in September -2019, but then life got on the way, and I stopped for a long -time. - -One day on Reddit, I saw Dylan's post on [r/unixporn] about -KISS, and I really thought that it was interesting. Here is -my [comment] to Dylan on that post. I checked out the package -manager and the repository. The packaging system was extremely -clean and well-thought. I decided to give it a go and fork -KISS. - -[Linux from Scratch]: https://linuxfromscratch.org -[r/unixporn]: https://reddit.com/r/unixporn -[comment]: https://www.reddit.com/r/unixporn/comments/ducd34/sowm_kiss_d/f7lua7x - - -Differences between KISS and Carbs ----------------------------------- - -Now, I still baffle when people ask me this question. My -intention was never to create a distribution with specific -differences between KISS. My intention was being my own -BDFL of a distribution I maintain. There are lots of -differences between the main repositories, but they are subtle -and not worth talking about. I personally never even installed -KISS Linux on my system. So Carbs, isn't something like a -downstream fork of KISS, it is just a distribution that was -initially based on KISS. - -I try to contribute as much as I can to KISS Linux. I think -that it is a brilliant distribution, and it was a great starting -point for Carbs. I am really grateful to Dylan and all the -other contributors. - - -What I'm working on now ------------------------ - -Currently I have a few projects that I'm working on for Carbs. -These are, - -A BSD port for Carbs. For a while, I have been working on BSD -compatibility on my fork of the [package manager]. I have tested, -without any more issues, on OpenBSD and FreeBSD. The biggest -issues remaining are choosing a vendor for BSD, packaging the -BSD source, and providing a minimal base (like busybox for BSD). -If you aren't familiar with BSD, it has a single source code -for all of the utilities (kernel, command line programs, etc.). -Contributions (even chipping in ideas) are very welcome. - -Adding binary package distribution support natively to the package -manager. Biggest issue in small/old computers are compile times. -This feature is for the bigger packages such as webkit, clang, -llvm that take a considerable amount of time. Some computers -with low memories cannot even compile firefox/webkit. - -Adding rsync repository support to the package manager. This -is not a current issue, but rather a futureproofing. As time -passes, distribution repositories grow larger. KISS and Carbs -are young distributions without this problem right now. But -in something like 5 years, this size will presumably increase -to hundreds of megabytes. At that point it will be pointless -to have the repository sources unless you specifically need them. - - -[package manager]: https://github.com/carbslinux/kiss - - -What's up with all the init/service daemons? --------------------------------------------- - -If you have ever checked the [repository], you may have noticed -that there are lots of init/service related packages. I have had -my fair share of time with all of them, and it is an area that I -am really interested in. I have even written my own [init daemon] -and [service supervisor]. I maintain all those packages on KISS -Community Repository as well with the exception of busybox. Those -are, `busybox init/runit`, `runit`, `sinit`, and `sysmgr`. I would -definitely recommend checking out `shinit` and `sysmgr`. - -[repository]: https://github.com/carbslinux/repository -[init daemon]: https://github.com/cemkeylan/shinit -[service supervisor]: https://github.com/cemkeylan/sysmgr - - -Why I don't publicize Carbs ---------------------------- - -There are a couple of reasons I don't publicize Carbs a lot. - -KISS is the better alternative in terms of support and community. -I work on maintaining this distribution just as hard as Dylan, -but in the end, Carbs is based on his original hard work, and I -believe that he deserves the recognition more than I do. - -Since I cannot answer questions like "What is the difference?", I -prefer staying as the silent sibling project of KISS Linux. Plus, -there is no point in dividing the newly-emerging community in half. - -That's not because I don't have ideas for the future of Carbs, I -do. I just think that I will deserve the recognition once those -above lists are checked. - - -I think that's about it, if you have questions you can send me a -mail, ping me on IRC (my handle is `merakor`), and I will be happy -to answer. Maybe your question fits this post, and I can update it -to thoroughly give an explanation. - -Cheers, -Cem diff --git a/src/blog/20200528.md b/src/blog/20200528.md deleted file mode 100644 index 9ceaec5..0000000 --- a/src/blog/20200528.md +++ /dev/null @@ -1,51 +0,0 @@ -kiss 2.0.0 and overall changes -==================================================================== - -Carbs Linux kiss version 2.0.0 has been released which introduces -rsync repositories. - -Git is no longer a mandatory dependency for the package manager, -every git source on the core repository has been replaced with -https sources (sbase, sinit), and rootfs tarballs will no longer -ship with git. Repositories in the upcoming tarball will be rsync -repositories. - -Git is now on the `extra` repository and is still (optionally) -used in the package manager. - -The idea behind this change is size reductions and increased -speed with rsync. As I said on the previous post, git repositories -get larger and larger over the time span. Currently my personal -copy of the git repository is around 77MB and I have forked KISS -Linux (as a shallow copy) around December. Obviously, I have commits -that I ommitted. I tend to create commits I dislike, which I change -with 'git reset --soft HEAD^', which doesn't actually remove the -commits, etc. A user will have a repository much smaller than mine. - -This is a precaution with the added bonuses of speed and dropping a -mandatory dependency. - -You can see the rest of the changelog [here]. - -[here]: https://github.com/CarbsLinux/kiss/blob/master/CHANGELOG.md - - -Binary Repositories -------------------- - -A few days ago, I have also published [kiss-bin], a first version -for managing binary repositories. Currently, there are some caveats -that I'll be fixing along the way. I decided not to include this -in the package manager natively as managing the source based and -binary based packages together adds levels of complexity that we -do not want. Instead, this is an extension for kiss which sources -the package manager as a library. I hope to see it being adopted -by others interested on the matter as well. - - -[kiss-bin]: https://github.com/CarbsLinux/kiss-bin - -That's about it. - -Cheers, -Cem diff --git a/src/blog/20200803.md b/src/blog/20200803.md deleted file mode 100644 index eaee932..0000000 --- a/src/blog/20200803.md +++ /dev/null @@ -1,77 +0,0 @@ -August 2020 News Post -================================================================================ - -We are having some stalls during this summer, as I am currently working on -university-related stuff. Nonetheless, there are some important changes that I -want to share in this month's post. - -INDEX --------------------------------------------------------------------------------- - -- [Carbs Packaging Tools](#carbs-packaging-tools) -- [Docs](#docs) -- [Re-opening the Carbs Linux server](#re-opening-the-carbs-linux-server) - - -Carbs Packaging Tools --------------------------------------------------------------------------------- - -This month I have reworked `kiss` into a new package manager, now renamed as -`cpt`. Updating `kiss` will now bootstrap the new package manager, so you don't -have to manually edit your system. If you don't like the idea of this, you can -look up the `post-install` script on `core/kiss` and apply the changes manually. - -You will also need to rename your KISS_* variables to CPT_*. So, KISS_PATH -becomes CPT_PATH. - -The rework changes the previous commands on the package manager into standalone -tools, and move the package manager functions to a library. This makes it easier -for a user to import functions and variables from the package manager, and -extend the package manager with their own intended way. Previously this required -ugly hacks and workarounds to use the package manager functions. I will be -making use of these changes to re-implement binary package management functions -as well. - -If you want to use the library on your script you can simply do this: - - +--------------------------------------------------------------------------+ - | | - | #!/bin/sh | - | . cpt-lib | - | (...) | - | | - +--------------------------------------------------------------------------+ - -There are obviously some clean-up and simplifications needed in this new -tool-based package management method. - - -Docs --------------------------------------------------------------------------------- - -I have added documentation for the distribution, and finally updated the guide -for installation. It is now _almost_ complete. These docs can be installed to -your system for online viewing. I will also add a documentation crawler similar -to how werc[^1] works (but as an offline viewer). You can find `carbs-docs` from -the repository. Currently, the documentation lacks but I will be adding new -stuff. These will solely be distribution specific documentation and will not be -a wiki-like source. If anyone would like to contribute to a wiki-like -documentation source, I would happily re-open the distribution wiki. You can -find the source on https://github.com/CarbsLinux/docs - - -Re-opening the Carbs Linux server --------------------------------------------------------------------------------- - -Back in May, I had shutdown the Carbs Linux server due to financial issues, but -I am slowly reverting to the self-hosted model. Back then, the git repositories -were mirrored to GitHub, and the management was overall much more flexible. The -server used to run Carbs Linux as well (that was fun and horrifying at the same -time). Now, I will be relaunching the git server which will be the upstream -source before August 5. You can switch your remote, but GitHub will stay as a -remote nonetheless. - -EDIT: The git-server is up! - - -[^1]: http://werc.cat-v.org diff --git a/src/blog/20201210.md b/src/blog/20201210.md deleted file mode 100644 index d4ef484..0000000 --- a/src/blog/20201210.md +++ /dev/null @@ -1,21 +0,0 @@ -First Year of Carbs Linux -================================================================================ - -December 10, 2020 marks the first year after the initial release of Carbs -Linux. When I forked the KISS Linux repository on the 9th of December, I was -fairly new to package management. Carbs Linux used to be almost identical to -KISS Linux. A lot has changed since then: - -- [2020 Jan 13] Replaced default init system to `sinit` -- [2020 Jan 15] Packaged `WebKit2GTK` -- [2020 May 17] Added `bearssl` on the testing repository -- [2020 May 28] Added `rsync` repository support to kiss -- [2020 Jun 03] Replaced `bison` with `byacc` -- [2020 Jun 11] Replaced `libressl` with `bearssl` -- [2020 Jun 24] Replaced `kiss` with `cpt` - -I have really enjoyed maintaining and developing this distribution, and I want -to thank everyone who was involved in some way or another. While I have slowed -down in development due to college workload, I am still actively maintaining all -the packages on the repository. I do have some ideas that I am thinking of -implementing during the semester break. Hope to see you all in January. diff --git a/src/blog/index.md b/src/blog/index.md deleted file mode 100644 index 347ef61..0000000 --- a/src/blog/index.md +++ /dev/null @@ -1,16 +0,0 @@ -Blog Index -================================================================================ - -This is the Carbs Linux Blog Index. You can find every post here. [RSS Feed] - -[RSS Feed]: /rss.xml - - -* Dec 10 2020 - [First Year of Carbs Linux](20201210.html) -* Aug 03 2020 - [August 2020 News Post](20200803.html) -* Jun 17 2020 - [June Newspost](20200617.html) -* May 28 2020 - [kiss 2.0.0 and overall changes](20200528.html) -* May 08 2020 - [The Relation of Carbs and KISS](20200508.html) -* Apr 10 2020 - [Outsource Repository Concept](20200410.html) -* Apr 06 2020 - [Roadmap for Carbs](20200406.html) -* Jan 28 2020 - [Switching to New Website](20200128.html) diff --git a/src/contributing.md b/src/contributing.md deleted file mode 100644 index 3fe71ce..0000000 --- a/src/contributing.md +++ /dev/null @@ -1,9 +0,0 @@ -Contribute to the Carbs Linux Project -===================================== - -This is a small project made possible by volunteers. There are -ways you can help this project stay alive. - -* Contribute to the [Carbs Linux repository](http://git.carbslinux.org/repository/log.html) -* Contribute to the [KISS community repository](https://github.com/kisslinux/community) -* Contribute to the [wiki](//wiki.carbslinux.org) diff --git a/src/docs.md b/src/docs.md deleted file mode 100644 index a481cf0..0000000 --- a/src/docs.md +++ /dev/null @@ -1,15 +0,0 @@ -Carbs Linux documentation -================================================================================ - -Welcome to the Carbs Linux source of documentation! You can install these to -your system for viewing offline: - - +--------------------------------------------------------------------------+ - | | - | $ cpt-build carbs-docs && cpt-install carbs-docs | - | | - +--------------------------------------------------------------------------+ - - -Documentation Index --------------------------------------------------------------------------------- diff --git a/src/docs.org b/src/docs.org new file mode 100644 index 0000000..8d2d515 --- /dev/null +++ b/src/docs.org @@ -0,0 +1,60 @@ +#+TITLE: Documentation + +Below are sources of documentation regarding Carbs Linux and tools surrounding +it. + +* User Manual + +Carbs Linux User Manual aims to be a general-purpose explanation of the +distribution, from the installation steps to the style guide of the project. It +can be accessed or otherwise obtained with various methods: + +** HTML + +You can view the Manual from your browser. The Manual can be viewed as + +- [[file:docs/carbslinux][One HTML page per node]] +- [[file:docs/carbslinux.html][Single HTML page]] + +** Plain text + +You can download [[file:docs/carbslinux.txt][carbslinux.txt]] in order to view the Manual from your preferred +pager. + +#+begin_src sh +curl -LO https://carbslinux.org/docs/carbslinux.txt +less carbslinux.txt +#+end_src + +** Info + +You can install the =carbs-docs= package and either =texinfo= or =info= packages +to view the Manual offline. + +#+begin_src sh +cpt bi info carbs-docs +info carbslinux +#+end_src + +** Source + +You can also acquire the source for generating the Manual, which requires +=emacs= for exporting the Org-mode documentation and =texinfo= for generating +html/info pages. + +#+begin_src sh +git clone git://git.carbslinux.org/docs +#+end_src + +* Installation Instructions + +Installation Manual is part of the [[*User Manual][User Manual]], but it can also be obtained +separately: + +- [[file:install.org][HTML]] +- [[file:install.txt][Plaintext]] + +* Carbs Packaging Tools + +The user manual for CPT is not complete yet, but will be released with the 6.0.0 +release. You can see the [[https://github.com/CarbsLinux/cpt][repository]] in order to check its status. diff --git a/src/docs/0013.html b/src/docs/0013.html deleted file mode 100644 index 27102b1..0000000 --- a/src/docs/0013.html +++ /dev/null @@ -1,49 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> -<html> -<!-- Copyright (C) 2020 Cem Keylan - -Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.3 or -any later version published by the Free Software Foundation; with no -Invariant Sections, with no Front-Cover Texts and no Back-Cover Texts. -A copy of the license is included in the section entitled "GNU Free -Documentation License." - --> -<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> -<!-- This file redirects to the location of a node or anchor --> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> -<title>0013 (Carbs Linux User Manual)</title> - -<meta name="description" content="0013 (Carbs Linux User Manual)"> -<meta name="keywords" content="0013 (Carbs Linux User Manual)"> -<meta name="resource-type" content="document"> -<meta name="distribution" content="global"> -<meta name="Generator" content="makeinfo"> -<style type="text/css"> -<!-- -a.summary-letter {text-decoration: none} -blockquote.indentedblock {margin-right: 0em} -div.display {margin-left: 3.2em} -div.example {margin-left: 3.2em} -div.lisp {margin-left: 3.2em} -kbd {font-style: oblique} -pre.display {font-family: inherit} -pre.format {font-family: inherit} -pre.menu-comment {font-family: serif} -pre.menu-preformatted {font-family: serif} -span.nolinebreak {white-space: nowrap} -span.roman {font-family: initial; font-weight: normal} -span.sansserif {font-family: sans-serif; font-weight: normal} -ul.no-bullet {list-style: none} ---> -</style> - -<meta http-equiv="Refresh" content="0; url=Conventions.html#g_t0013"> - -</head> - -<body lang="en"> - -<p>The node you are looking for is at <a href="Conventions.html#g_t0013">0013</a>.</p> -</body> diff --git a/src/docs/1010.html b/src/docs/1010.html deleted file mode 100644 index a9635e8..0000000 --- a/src/docs/1010.html +++ /dev/null @@ -1,49 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> -<html> -<!-- Copyright (C) 2020 Cem Keylan - -Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.3 or -any later version published by the Free Software Foundation; with no -Invariant Sections, with no Front-Cover Texts and no Back-Cover Texts. -A copy of the license is included in the section entitled "GNU Free -Documentation License." - --> -<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> -<!-- This file redirects to the location of a node or anchor --> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> -<title>1010 (Carbs Linux User Manual)</title> - -<meta name="description" content="1010 (Carbs Linux User Manual)"> -<meta name="keywords" content="1010 (Carbs Linux User Manual)"> -<meta name="resource-type" content="document"> -<meta name="distribution" content="global"> -<meta name="Generator" content="makeinfo"> -<style type="text/css"> -<!-- -a.summary-letter {text-decoration: none} -blockquote.indentedblock {margin-right: 0em} -div.display {margin-left: 3.2em} -div.example {margin-left: 3.2em} -div.lisp {margin-left: 3.2em} -kbd {font-style: oblique} -pre.display {font-family: inherit} -pre.format {font-family: inherit} -pre.menu-comment {font-family: serif} -pre.menu-preformatted {font-family: serif} -span.nolinebreak {white-space: nowrap} -span.roman {font-family: initial; font-weight: normal} -span.sansserif {font-family: sans-serif; font-weight: normal} -ul.no-bullet {list-style: none} ---> -</style> - -<meta http-equiv="Refresh" content="0; url=Shell-Conventions.html#g_t1010"> - -</head> - -<body lang="en"> - -<p>The node you are looking for is at <a href="Shell-Conventions.html#g_t1010">1010</a>.</p> -</body> diff --git a/src/docs/1041.html b/src/docs/1041.html deleted file mode 100644 index a75e629..0000000 --- a/src/docs/1041.html +++ /dev/null @@ -1,49 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> -<html> -<!-- Copyright (C) 2020 Cem Keylan - -Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.3 or -any later version published by the Free Software Foundation; with no -Invariant Sections, with no Front-Cover Texts and no Back-Cover Texts. -A copy of the license is included in the section entitled "GNU Free -Documentation License." - --> -<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> -<!-- This file redirects to the location of a node or anchor --> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> -<title>1041 (Carbs Linux User Manual)</title> - -<meta name="description" content="1041 (Carbs Linux User Manual)"> -<meta name="keywords" content="1041 (Carbs Linux User Manual)"> -<meta name="resource-type" content="document"> -<meta name="distribution" content="global"> -<meta name="Generator" content="makeinfo"> -<style type="text/css"> -<!-- -a.summary-letter {text-decoration: none} -blockquote.indentedblock {margin-right: 0em} -div.display {margin-left: 3.2em} -div.example {margin-left: 3.2em} -div.lisp {margin-left: 3.2em} -kbd {font-style: oblique} -pre.display {font-family: inherit} -pre.format {font-family: inherit} -pre.menu-comment {font-family: serif} -pre.menu-preformatted {font-family: serif} -span.nolinebreak {white-space: nowrap} -span.roman {font-family: initial; font-weight: normal} -span.sansserif {font-family: sans-serif; font-weight: normal} -ul.no-bullet {list-style: none} ---> -</style> - -<meta http-equiv="Refresh" content="0; url=Shell-Conventions.html#g_t1041"> - -</head> - -<body lang="en"> - -<p>The node you are looking for is at <a href="Shell-Conventions.html#g_t1041">1041</a>.</p> -</body> diff --git a/src/docs/1042.html b/src/docs/1042.html deleted file mode 100644 index c9e5426..0000000 --- a/src/docs/1042.html +++ /dev/null @@ -1,49 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> -<html> -<!-- Copyright (C) 2020 Cem Keylan - -Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.3 or -any later version published by the Free Software Foundation; with no -Invariant Sections, with no Front-Cover Texts and no Back-Cover Texts. -A copy of the license is included in the section entitled "GNU Free -Documentation License." - --> -<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> -<!-- This file redirects to the location of a node or anchor --> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> -<title>1042 (Carbs Linux User Manual)</title> - -<meta name="description" content="1042 (Carbs Linux User Manual)"> -<meta name="keywords" content="1042 (Carbs Linux User Manual)"> -<meta name="resource-type" content="document"> -<meta name="distribution" content="global"> -<meta name="Generator" content="makeinfo"> -<style type="text/css"> -<!-- -a.summary-letter {text-decoration: none} -blockquote.indentedblock {margin-right: 0em} -div.display {margin-left: 3.2em} -div.example {margin-left: 3.2em} -div.lisp {margin-left: 3.2em} -kbd {font-style: oblique} -pre.display {font-family: inherit} -pre.format {font-family: inherit} -pre.menu-comment {font-family: serif} -pre.menu-preformatted {font-family: serif} -span.nolinebreak {white-space: nowrap} -span.roman {font-family: initial; font-weight: normal} -span.sansserif {font-family: sans-serif; font-weight: normal} -ul.no-bullet {list-style: none} ---> -</style> - -<meta http-equiv="Refresh" content="0; url=Shell-Conventions.html#g_t1042"> - -</head> - -<body lang="en"> - -<p>The node you are looking for is at <a href="Shell-Conventions.html#g_t1042">1042</a>.</p> -</body> diff --git a/src/docs/1043.html b/src/docs/1043.html deleted file mode 100644 index 32807ad..0000000 --- a/src/docs/1043.html +++ /dev/null @@ -1,49 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> -<html> -<!-- Copyright (C) 2020 Cem Keylan - -Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.3 or -any later version published by the Free Software Foundation; with no -Invariant Sections, with no Front-Cover Texts and no Back-Cover Texts. -A copy of the license is included in the section entitled "GNU Free -Documentation License." - --> -<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> -<!-- This file redirects to the location of a node or anchor --> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> -<title>1043 (Carbs Linux User Manual)</title> - -<meta name="description" content="1043 (Carbs Linux User Manual)"> -<meta name="keywords" content="1043 (Carbs Linux User Manual)"> -<meta name="resource-type" content="document"> -<meta name="distribution" content="global"> -<meta name="Generator" content="makeinfo"> -<style type="text/css"> -<!-- -a.summary-letter {text-decoration: none} -blockquote.indentedblock {margin-right: 0em} -div.display {margin-left: 3.2em} -div.example {margin-left: 3.2em} -div.lisp {margin-left: 3.2em} -kbd {font-style: oblique} -pre.display {font-family: inherit} -pre.format {font-family: inherit} -pre.menu-comment {font-family: serif} -pre.menu-preformatted {font-family: serif} -span.nolinebreak {white-space: nowrap} -span.roman {font-family: initial; font-weight: normal} -span.sansserif {font-family: sans-serif; font-weight: normal} -ul.no-bullet {list-style: none} ---> -</style> - -<meta http-equiv="Refresh" content="0; url=Shell-Conventions.html#g_t1043"> - -</head> - -<body lang="en"> - -<p>The node you are looking for is at <a href="Shell-Conventions.html#g_t1043">1043</a>.</p> -</body> diff --git a/src/docs/1050.html b/src/docs/1050.html deleted file mode 100644 index c913527..0000000 --- a/src/docs/1050.html +++ /dev/null @@ -1,49 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> -<html> -<!-- Copyright (C) 2020 Cem Keylan - -Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.3 or -any later version published by the Free Software Foundation; with no -Invariant Sections, with no Front-Cover Texts and no Back-Cover Texts. -A copy of the license is included in the section entitled "GNU Free -Documentation License." - --> -<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> -<!-- This file redirects to the location of a node or anchor --> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> -<title>1050 (Carbs Linux User Manual)</title> - -<meta name="description" content="1050 (Carbs Linux User Manual)"> -<meta name="keywords" content="1050 (Carbs Linux User Manual)"> -<meta name="resource-type" content="document"> -<meta name="distribution" content="global"> -<meta name="Generator" content="makeinfo"> -<style type="text/css"> -<!-- -a.summary-letter {text-decoration: none} -blockquote.indentedblock {margin-right: 0em} -div.display {margin-left: 3.2em} -div.example {margin-left: 3.2em} -div.lisp {margin-left: 3.2em} -kbd {font-style: oblique} -pre.display {font-family: inherit} -pre.format {font-family: inherit} -pre.menu-comment {font-family: serif} -pre.menu-preformatted {font-family: serif} -span.nolinebreak {white-space: nowrap} -span.roman {font-family: initial; font-weight: normal} -span.sansserif {font-family: sans-serif; font-weight: normal} -ul.no-bullet {list-style: none} ---> -</style> - -<meta http-equiv="Refresh" content="0; url=Shell-Conventions.html#g_t1050"> - -</head> - -<body lang="en"> - -<p>The node you are looking for is at <a href="Shell-Conventions.html#g_t1050">1050</a>.</p> -</body> diff --git a/src/docs/2010.html b/src/docs/2010.html deleted file mode 100644 index 482ddf3..0000000 --- a/src/docs/2010.html +++ /dev/null @@ -1,49 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> -<html> -<!-- Copyright (C) 2020 Cem Keylan - -Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.3 or -any later version published by the Free Software Foundation; with no -Invariant Sections, with no Front-Cover Texts and no Back-Cover Texts. -A copy of the license is included in the section entitled "GNU Free -Documentation License." - --> -<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> -<!-- This file redirects to the location of a node or anchor --> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> -<title>2010 (Carbs Linux User Manual)</title> - -<meta name="description" content="2010 (Carbs Linux User Manual)"> -<meta name="keywords" content="2010 (Carbs Linux User Manual)"> -<meta name="resource-type" content="document"> -<meta name="distribution" content="global"> -<meta name="Generator" content="makeinfo"> -<style type="text/css"> -<!-- -a.summary-letter {text-decoration: none} -blockquote.indentedblock {margin-right: 0em} -div.display {margin-left: 3.2em} -div.example {margin-left: 3.2em} -div.lisp {margin-left: 3.2em} -kbd {font-style: oblique} -pre.display {font-family: inherit} -pre.format {font-family: inherit} -pre.menu-comment {font-family: serif} -pre.menu-preformatted {font-family: serif} -span.nolinebreak {white-space: nowrap} -span.roman {font-family: initial; font-weight: normal} -span.sansserif {font-family: sans-serif; font-weight: normal} -ul.no-bullet {list-style: none} ---> -</style> - -<meta http-equiv="Refresh" content="0; url=Repository-Conventions.html#g_t2010"> - -</head> - -<body lang="en"> - -<p>The node you are looking for is at <a href="Repository-Conventions.html#g_t2010">2010</a>.</p> -</body> diff --git a/src/docs/2050.html b/src/docs/2050.html deleted file mode 100644 index a8b2a70..0000000 --- a/src/docs/2050.html +++ /dev/null @@ -1,49 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> -<html> -<!-- Copyright (C) 2020 Cem Keylan - -Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.3 or -any later version published by the Free Software Foundation; with no -Invariant Sections, with no Front-Cover Texts and no Back-Cover Texts. -A copy of the license is included in the section entitled "GNU Free -Documentation License." - --> -<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> -<!-- This file redirects to the location of a node or anchor --> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> -<title>2050 (Carbs Linux User Manual)</title> - -<meta name="description" content="2050 (Carbs Linux User Manual)"> -<meta name="keywords" content="2050 (Carbs Linux User Manual)"> -<meta name="resource-type" content="document"> -<meta name="distribution" content="global"> -<meta name="Generator" content="makeinfo"> -<style type="text/css"> -<!-- -a.summary-letter {text-decoration: none} -blockquote.indentedblock {margin-right: 0em} -div.display {margin-left: 3.2em} -div.example {margin-left: 3.2em} -div.lisp {margin-left: 3.2em} -kbd {font-style: oblique} -pre.display {font-family: inherit} -pre.format {font-family: inherit} -pre.menu-comment {font-family: serif} -pre.menu-preformatted {font-family: serif} -span.nolinebreak {white-space: nowrap} -span.roman {font-family: initial; font-weight: normal} -span.sansserif {font-family: sans-serif; font-weight: normal} -ul.no-bullet {list-style: none} ---> -</style> - -<meta http-equiv="Refresh" content="0; url=Repository-Conventions.html#g_t2050"> - -</head> - -<body lang="en"> - -<p>The node you are looking for is at <a href="Repository-Conventions.html#g_t2050">2050</a>.</p> -</body> diff --git a/src/docs/2210.html b/src/docs/2210.html deleted file mode 100644 index 1304a27..0000000 --- a/src/docs/2210.html +++ /dev/null @@ -1,49 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> -<html> -<!-- Copyright (C) 2020 Cem Keylan - -Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.3 or -any later version published by the Free Software Foundation; with no -Invariant Sections, with no Front-Cover Texts and no Back-Cover Texts. -A copy of the license is included in the section entitled "GNU Free -Documentation License." - --> -<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> -<!-- This file redirects to the location of a node or anchor --> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> -<title>2210 (Carbs Linux User Manual)</title> - -<meta name="description" content="2210 (Carbs Linux User Manual)"> -<meta name="keywords" content="2210 (Carbs Linux User Manual)"> -<meta name="resource-type" content="document"> -<meta name="distribution" content="global"> -<meta name="Generator" content="makeinfo"> -<style type="text/css"> -<!-- -a.summary-letter {text-decoration: none} -blockquote.indentedblock {margin-right: 0em} -div.display {margin-left: 3.2em} -div.example {margin-left: 3.2em} -div.lisp {margin-left: 3.2em} -kbd {font-style: oblique} -pre.display {font-family: inherit} -pre.format {font-family: inherit} -pre.menu-comment {font-family: serif} -pre.menu-preformatted {font-family: serif} -span.nolinebreak {white-space: nowrap} -span.roman {font-family: initial; font-weight: normal} -span.sansserif {font-family: sans-serif; font-weight: normal} -ul.no-bullet {list-style: none} ---> -</style> - -<meta http-equiv="Refresh" content="0; url=Repository-Conventions.html#g_t2210"> - -</head> - -<body lang="en"> - -<p>The node you are looking for is at <a href="Repository-Conventions.html#g_t2210">2210</a>.</p> -</body> diff --git a/src/docs/2211.html b/src/docs/2211.html deleted file mode 100644 index 9d2f2b3..0000000 --- a/src/docs/2211.html +++ /dev/null @@ -1,49 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> -<html> -<!-- Copyright (C) 2020 Cem Keylan - -Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.3 or -any later version published by the Free Software Foundation; with no -Invariant Sections, with no Front-Cover Texts and no Back-Cover Texts. -A copy of the license is included in the section entitled "GNU Free -Documentation License." - --> -<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> -<!-- This file redirects to the location of a node or anchor --> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> -<title>2211 (Carbs Linux User Manual)</title> - -<meta name="description" content="2211 (Carbs Linux User Manual)"> -<meta name="keywords" content="2211 (Carbs Linux User Manual)"> -<meta name="resource-type" content="document"> -<meta name="distribution" content="global"> -<meta name="Generator" content="makeinfo"> -<style type="text/css"> -<!-- -a.summary-letter {text-decoration: none} -blockquote.indentedblock {margin-right: 0em} -div.display {margin-left: 3.2em} -div.example {margin-left: 3.2em} -div.lisp {margin-left: 3.2em} -kbd {font-style: oblique} -pre.display {font-family: inherit} -pre.format {font-family: inherit} -pre.menu-comment {font-family: serif} -pre.menu-preformatted {font-family: serif} -span.nolinebreak {white-space: nowrap} -span.roman {font-family: initial; font-weight: normal} -span.sansserif {font-family: sans-serif; font-weight: normal} -ul.no-bullet {list-style: none} ---> -</style> - -<meta http-equiv="Refresh" content="0; url=Repository-Conventions.html#g_t2211"> - -</head> - -<body lang="en"> - -<p>The node you are looking for is at <a href="Repository-Conventions.html#g_t2211">2211</a>.</p> -</body> diff --git a/src/docs/2212.html b/src/docs/2212.html deleted file mode 100644 index e14d231..0000000 --- a/src/docs/2212.html +++ /dev/null @@ -1,49 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> -<html> -<!-- Copyright (C) 2020 Cem Keylan - -Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.3 or -any later version published by the Free Software Foundation; with no -Invariant Sections, with no Front-Cover Texts and no Back-Cover Texts. -A copy of the license is included in the section entitled "GNU Free -Documentation License." - --> -<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> -<!-- This file redirects to the location of a node or anchor --> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> -<title>2212 (Carbs Linux User Manual)</title> - -<meta name="description" content="2212 (Carbs Linux User Manual)"> -<meta name="keywords" content="2212 (Carbs Linux User Manual)"> -<meta name="resource-type" content="document"> -<meta name="distribution" content="global"> -<meta name="Generator" content="makeinfo"> -<style type="text/css"> -<!-- -a.summary-letter {text-decoration: none} -blockquote.indentedblock {margin-right: 0em} -div.display {margin-left: 3.2em} -div.example {margin-left: 3.2em} -div.lisp {margin-left: 3.2em} -kbd {font-style: oblique} -pre.display {font-family: inherit} -pre.format {font-family: inherit} -pre.menu-comment {font-family: serif} -pre.menu-preformatted {font-family: serif} -span.nolinebreak {white-space: nowrap} -span.roman {font-family: initial; font-weight: normal} -span.sansserif {font-family: sans-serif; font-weight: normal} -ul.no-bullet {list-style: none} ---> -</style> - -<meta http-equiv="Refresh" content="0; url=Repository-Conventions.html#g_t2212"> - -</head> - -<body lang="en"> - -<p>The node you are looking for is at <a href="Repository-Conventions.html#g_t2212">2212</a>.</p> -</body> diff --git a/src/docs/2220.html b/src/docs/2220.html deleted file mode 100644 index 4012c71..0000000 --- a/src/docs/2220.html +++ /dev/null @@ -1,49 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> -<html> -<!-- Copyright (C) 2020 Cem Keylan - -Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.3 or -any later version published by the Free Software Foundation; with no -Invariant Sections, with no Front-Cover Texts and no Back-Cover Texts. -A copy of the license is included in the section entitled "GNU Free -Documentation License." - --> -<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> -<!-- This file redirects to the location of a node or anchor --> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> -<title>2220 (Carbs Linux User Manual)</title> - -<meta name="description" content="2220 (Carbs Linux User Manual)"> -<meta name="keywords" content="2220 (Carbs Linux User Manual)"> -<meta name="resource-type" content="document"> -<meta name="distribution" content="global"> -<meta name="Generator" content="makeinfo"> -<style type="text/css"> -<!-- -a.summary-letter {text-decoration: none} -blockquote.indentedblock {margin-right: 0em} -div.display {margin-left: 3.2em} -div.example {margin-left: 3.2em} -div.lisp {margin-left: 3.2em} -kbd {font-style: oblique} -pre.display {font-family: inherit} -pre.format {font-family: inherit} -pre.menu-comment {font-family: serif} -pre.menu-preformatted {font-family: serif} -span.nolinebreak {white-space: nowrap} -span.roman {font-family: initial; font-weight: normal} -span.sansserif {font-family: sans-serif; font-weight: normal} -ul.no-bullet {list-style: none} ---> -</style> - -<meta http-equiv="Refresh" content="0; url=Repository-Conventions.html#g_t2220"> - -</head> - -<body lang="en"> - -<p>The node you are looking for is at <a href="Repository-Conventions.html#g_t2220">2220</a>.</p> -</body> diff --git a/src/docs/2230.html b/src/docs/2230.html deleted file mode 100644 index b03a69c..0000000 --- a/src/docs/2230.html +++ /dev/null @@ -1,49 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> -<html> -<!-- Copyright (C) 2020 Cem Keylan - -Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.3 or -any later version published by the Free Software Foundation; with no -Invariant Sections, with no Front-Cover Texts and no Back-Cover Texts. -A copy of the license is included in the section entitled "GNU Free -Documentation License." - --> -<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> -<!-- This file redirects to the location of a node or anchor --> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> -<title>2230 (Carbs Linux User Manual)</title> - -<meta name="description" content="2230 (Carbs Linux User Manual)"> -<meta name="keywords" content="2230 (Carbs Linux User Manual)"> -<meta name="resource-type" content="document"> -<meta name="distribution" content="global"> -<meta name="Generator" content="makeinfo"> -<style type="text/css"> -<!-- -a.summary-letter {text-decoration: none} -blockquote.indentedblock {margin-right: 0em} -div.display {margin-left: 3.2em} -div.example {margin-left: 3.2em} -div.lisp {margin-left: 3.2em} -kbd {font-style: oblique} -pre.display {font-family: inherit} -pre.format {font-family: inherit} -pre.menu-comment {font-family: serif} -pre.menu-preformatted {font-family: serif} -span.nolinebreak {white-space: nowrap} -span.roman {font-family: initial; font-weight: normal} -span.sansserif {font-family: sans-serif; font-weight: normal} -ul.no-bullet {list-style: none} ---> -</style> - -<meta http-equiv="Refresh" content="0; url=Repository-Conventions.html#g_t2230"> - -</head> - -<body lang="en"> - -<p>The node you are looking for is at <a href="Repository-Conventions.html#g_t2230">2230</a>.</p> -</body> diff --git a/src/docs/2240.html b/src/docs/2240.html deleted file mode 100644 index c8e98f2..0000000 --- a/src/docs/2240.html +++ /dev/null @@ -1,49 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> -<html> -<!-- Copyright (C) 2020 Cem Keylan - -Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.3 or -any later version published by the Free Software Foundation; with no -Invariant Sections, with no Front-Cover Texts and no Back-Cover Texts. -A copy of the license is included in the section entitled "GNU Free -Documentation License." - --> -<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> -<!-- This file redirects to the location of a node or anchor --> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> -<title>2240 (Carbs Linux User Manual)</title> - -<meta name="description" content="2240 (Carbs Linux User Manual)"> -<meta name="keywords" content="2240 (Carbs Linux User Manual)"> -<meta name="resource-type" content="document"> -<meta name="distribution" content="global"> -<meta name="Generator" content="makeinfo"> -<style type="text/css"> -<!-- -a.summary-letter {text-decoration: none} -blockquote.indentedblock {margin-right: 0em} -div.display {margin-left: 3.2em} -div.example {margin-left: 3.2em} -div.lisp {margin-left: 3.2em} -kbd {font-style: oblique} -pre.display {font-family: inherit} -pre.format {font-family: inherit} -pre.menu-comment {font-family: serif} -pre.menu-preformatted {font-family: serif} -span.nolinebreak {white-space: nowrap} -span.roman {font-family: initial; font-weight: normal} -span.sansserif {font-family: sans-serif; font-weight: normal} -ul.no-bullet {list-style: none} ---> -</style> - -<meta http-equiv="Refresh" content="0; url=Repository-Conventions.html#g_t2240"> - -</head> - -<body lang="en"> - -<p>The node you are looking for is at <a href="Repository-Conventions.html#g_t2240">2240</a>.</p> -</body> diff --git a/src/docs/2241.html b/src/docs/2241.html deleted file mode 100644 index dba5354..0000000 --- a/src/docs/2241.html +++ /dev/null @@ -1,49 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> -<html> -<!-- Copyright (C) 2020 Cem Keylan - -Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.3 or -any later version published by the Free Software Foundation; with no -Invariant Sections, with no Front-Cover Texts and no Back-Cover Texts. -A copy of the license is included in the section entitled "GNU Free -Documentation License." - --> -<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> -<!-- This file redirects to the location of a node or anchor --> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> -<title>2241 (Carbs Linux User Manual)</title> - -<meta name="description" content="2241 (Carbs Linux User Manual)"> -<meta name="keywords" content="2241 (Carbs Linux User Manual)"> -<meta name="resource-type" content="document"> -<meta name="distribution" content="global"> -<meta name="Generator" content="makeinfo"> -<style type="text/css"> -<!-- -a.summary-letter {text-decoration: none} -blockquote.indentedblock {margin-right: 0em} -div.display {margin-left: 3.2em} -div.example {margin-left: 3.2em} -div.lisp {margin-left: 3.2em} -kbd {font-style: oblique} -pre.display {font-family: inherit} -pre.format {font-family: inherit} -pre.menu-comment {font-family: serif} -pre.menu-preformatted {font-family: serif} -span.nolinebreak {white-space: nowrap} -span.roman {font-family: initial; font-weight: normal} -span.sansserif {font-family: sans-serif; font-weight: normal} -ul.no-bullet {list-style: none} ---> -</style> - -<meta http-equiv="Refresh" content="0; url=Repository-Conventions.html#g_t2241"> - -</head> - -<body lang="en"> - -<p>The node you are looking for is at <a href="Repository-Conventions.html#g_t2241">2241</a>.</p> -</body> diff --git a/src/docs/ADDENDUM-How-to-use-this-License-for-your-documents.html b/src/docs/ADDENDUM-How-to-use-this-License-for-your-documents.html deleted file mode 100644 index b3423c8..0000000 --- a/src/docs/ADDENDUM-How-to-use-this-License-for-your-documents.html +++ /dev/null @@ -1,49 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> -<html> -<!-- Copyright (C) 2020 Cem Keylan - -Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.3 or -any later version published by the Free Software Foundation; with no -Invariant Sections, with no Front-Cover Texts and no Back-Cover Texts. -A copy of the license is included in the section entitled "GNU Free -Documentation License." - --> -<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> -<!-- This file redirects to the location of a node or anchor --> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> -<title>ADDENDUM How to use this License for your documents (Carbs Linux User Manual)</title> - -<meta name="description" content="ADDENDUM How to use this License for your documents (Carbs Linux User Manual)"> -<meta name="keywords" content="ADDENDUM How to use this License for your documents (Carbs Linux User Manual)"> -<meta name="resource-type" content="document"> -<meta name="distribution" content="global"> -<meta name="Generator" content="makeinfo"> -<style type="text/css"> -<!-- -a.summary-letter {text-decoration: none} -blockquote.indentedblock {margin-right: 0em} -div.display {margin-left: 3.2em} -div.example {margin-left: 3.2em} -div.lisp {margin-left: 3.2em} -kbd {font-style: oblique} -pre.display {font-family: inherit} -pre.format {font-family: inherit} -pre.menu-comment {font-family: serif} -pre.menu-preformatted {font-family: serif} -span.nolinebreak {white-space: nowrap} -span.roman {font-family: initial; font-weight: normal} -span.sansserif {font-family: sans-serif; font-weight: normal} -ul.no-bullet {list-style: none} ---> -</style> - -<meta http-equiv="Refresh" content="0; url=GNU-Free-Documentation-License.html#ADDENDUM-How-to-use-this-License-for-your-documents"> - -</head> - -<body lang="en"> - -<p>The node you are looking for is at <a href="GNU-Free-Documentation-License.html#ADDENDUM-How-to-use-this-License-for-your-documents">ADDENDUM How to use this License for your documents</a>.</p> -</body> diff --git a/src/docs/Bootloader.html b/src/docs/Bootloader.html deleted file mode 100644 index 6f23a5b..0000000 --- a/src/docs/Bootloader.html +++ /dev/null @@ -1,91 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> -<html> -<!-- Copyright (C) 2020 Cem Keylan - -Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.3 or -any later version published by the Free Software Foundation; with no -Invariant Sections, with no Front-Cover Texts and no Back-Cover Texts. -A copy of the license is included in the section entitled "GNU Free -Documentation License." - --> -<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> -<title>Bootloader (Carbs Linux User Manual)</title> - -<meta name="description" content="Bootloader (Carbs Linux User Manual)"> -<meta name="keywords" content="Bootloader (Carbs Linux User Manual)"> -<meta name="resource-type" content="document"> -<meta name="distribution" content="global"> -<meta name="Generator" content="makeinfo"> -<link href="index.html" rel="start" title="Top"> -<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents"> -<link href="Making-your-system-bootable.html" rel="up" title="Making your system bootable"> -<link href="Init-scripts.html" rel="next" title="Init scripts"> -<link href="Making-your-system-bootable.html" rel="prev" title="Making your system bootable"> -<style type="text/css"> -<!-- -a.summary-letter {text-decoration: none} -blockquote.indentedblock {margin-right: 0em} -div.display {margin-left: 3.2em} -div.example {margin-left: 3.2em} -div.lisp {margin-left: 3.2em} -kbd {font-style: oblique} -pre.display {font-family: inherit} -pre.format {font-family: inherit} -pre.menu-comment {font-family: serif} -pre.menu-preformatted {font-family: serif} -span.nolinebreak {white-space: nowrap} -span.roman {font-family: initial; font-weight: normal} -span.sansserif {font-family: sans-serif; font-weight: normal} -ul.no-bullet {list-style: none} ---> -</style> - - -</head> - -<body lang="en"> -<span id="Bootloader"></span><div class="header"> -<p> -Next: <a href="Init-scripts.html" accesskey="n" rel="next">Init scripts</a>, Up: <a href="Making-your-system-bootable.html" accesskey="u" rel="up">Making your system bootable</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> -</div> -<hr> -<span id="Bootloader-1"></span><h4 class="subsection">1.5.1 Bootloader</h4> - -<p>In the main repository, there is efibootmgr and grub to serve as bootloaders. -efibootmgr can be used as a standalone bootloader, or can be used to install -grub in a UEFI environment. efibootmgr is needed unless you are using a device -without UEFI support (or you really want to use BIOS for a reason). -</p> -<ol> -<li> GRUB BIOS installation - - -<div class="example"> -<pre class="example">cpt b grub && cpt i grub -grub-install --target=i386-pc /dev/sdX -grub-mkconfig -o /boot/grub/grub.cfg -</pre></div> - -</li><li> GRUB UEFI installation - - -<div class="example"> -<pre class="example">cpt b efibootmgr && cpt i efibootmgr -cpt b grub && cpt i grub - -grub-install --target=x86_64-efi \ - --efi-directory=esp \ - --bootloader-id=CarbsLinux - -grub-mkconfig -o /boot/grub/grub.cfg -</pre></div> -</li></ol> - - - - -</body> -</html> diff --git a/src/docs/Building-the-kernel.html b/src/docs/Building-the-kernel.html deleted file mode 100644 index e0f5ee2..0000000 --- a/src/docs/Building-the-kernel.html +++ /dev/null @@ -1,72 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> -<html> -<!-- Copyright (C) 2020 Cem Keylan - -Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.3 or -any later version published by the Free Software Foundation; with no -Invariant Sections, with no Front-Cover Texts and no Back-Cover Texts. -A copy of the license is included in the section entitled "GNU Free -Documentation License." - --> -<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> -<title>Building the kernel (Carbs Linux User Manual)</title> - -<meta name="description" content="Building the kernel (Carbs Linux User Manual)"> -<meta name="keywords" content="Building the kernel (Carbs Linux User Manual)"> -<meta name="resource-type" content="document"> -<meta name="distribution" content="global"> -<meta name="Generator" content="makeinfo"> -<link href="index.html" rel="start" title="Top"> -<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents"> -<link href="Kernel.html" rel="up" title="Kernel"> -<link href="Making-your-system-bootable.html" rel="next" title="Making your system bootable"> -<link href="Kernel-dependencies.html" rel="prev" title="Kernel dependencies"> -<style type="text/css"> -<!-- -a.summary-letter {text-decoration: none} -blockquote.indentedblock {margin-right: 0em} -div.display {margin-left: 3.2em} -div.example {margin-left: 3.2em} -div.lisp {margin-left: 3.2em} -kbd {font-style: oblique} -pre.display {font-family: inherit} -pre.format {font-family: inherit} -pre.menu-comment {font-family: serif} -pre.menu-preformatted {font-family: serif} -span.nolinebreak {white-space: nowrap} -span.roman {font-family: initial; font-weight: normal} -span.sansserif {font-family: sans-serif; font-weight: normal} -ul.no-bullet {list-style: none} ---> -</style> - - -</head> - -<body lang="en"> -<span id="Building-the-kernel"></span><div class="header"> -<p> -Previous: <a href="Kernel-dependencies.html" accesskey="p" rel="prev">Kernel dependencies</a>, Up: <a href="Kernel.html" accesskey="u" rel="up">Kernel</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> -</div> -<hr> -<span id="Building-the-kernel-1"></span><h4 class="subsection">1.4.3 Building the kernel</h4> - -<p>Next step is configuring and building the kernel. You can check Gentoo’s -<a href="https://wiki.gentoo.org/wiki/Kernel/Configuration">kernel configuration guide</a> to learn more about the matter. Overall, Gentoo Wiki -is a good place to learn about configuration according to your hardware. The -following will assume a monolithic kernel. -</p> -<div class="example"> -<pre class="example">make menuconfig -make -install -Dm755 $(make -s image_name) /boot/vmlinuz-linux -</pre></div> - - - - -</body> -</html> diff --git a/src/docs/Chroot.html b/src/docs/Chroot.html deleted file mode 100644 index c648361..0000000 --- a/src/docs/Chroot.html +++ /dev/null @@ -1,80 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> -<html> -<!-- Copyright (C) 2020 Cem Keylan - -Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.3 or -any later version published by the Free Software Foundation; with no -Invariant Sections, with no Front-Cover Texts and no Back-Cover Texts. -A copy of the license is included in the section entitled "GNU Free -Documentation License." - --> -<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> -<title>Chroot (Carbs Linux User Manual)</title> - -<meta name="description" content="Chroot (Carbs Linux User Manual)"> -<meta name="keywords" content="Chroot (Carbs Linux User Manual)"> -<meta name="resource-type" content="document"> -<meta name="distribution" content="global"> -<meta name="Generator" content="makeinfo"> -<link href="index.html" rel="start" title="Top"> -<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents"> -<link href="Installation.html" rel="up" title="Installation"> -<link href="Setting-up-repositories.html" rel="next" title="Setting up repositories"> -<link href="Obtain-the-chroot-helper.html" rel="prev" title="Obtain the chroot helper"> -<style type="text/css"> -<!-- -a.summary-letter {text-decoration: none} -blockquote.indentedblock {margin-right: 0em} -div.display {margin-left: 3.2em} -div.example {margin-left: 3.2em} -div.lisp {margin-left: 3.2em} -kbd {font-style: oblique} -pre.display {font-family: inherit} -pre.format {font-family: inherit} -pre.menu-comment {font-family: serif} -pre.menu-preformatted {font-family: serif} -span.nolinebreak {white-space: nowrap} -span.roman {font-family: initial; font-weight: normal} -span.sansserif {font-family: sans-serif; font-weight: normal} -ul.no-bullet {list-style: none} ---> -</style> - - -</head> - -<body lang="en"> -<span id="Chroot"></span><div class="header"> -<p> -Next: <a href="System-Configuration.html" accesskey="n" rel="next">System Configuration</a>, Previous: <a href="Preparing-Environment.html" accesskey="p" rel="prev">Preparing Environment</a>, Up: <a href="Installation.html" accesskey="u" rel="up">Installation</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> -</div> -<hr> -<span id="Chroot-1"></span><h3 class="section">1.2 Chroot</h3> - -<p>Chroot into Carbs Linux! -</p> -<div class="example"> -<pre class="example">./cpt-chroot /mnt -</pre></div> - -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="Setting-up-repositories.html" accesskey="1">Setting up repositories</a></td><td> </td><td align="left" valign="top">Basic setup for obtaining repositories -</td></tr> -<tr><td align="left" valign="top">• <a href="Updating-packages.html" accesskey="2">Updating packages</a></td><td> </td><td align="left" valign="top">Update your system -</td></tr> -<tr><td align="left" valign="top">• <a href="Installing-packages.html" accesskey="3">Installing packages</a></td><td> </td><td align="left" valign="top">Install new software on your system -</td></tr> -<tr><td align="left" valign="top">• <a href="Essential-Software.html" accesskey="4">Essential Software</a></td><td> </td><td align="left" valign="top">Software you might want to include on your system -</td></tr> -<tr><td align="left" valign="top">• <a href="Obtaining-the-documentation.html" accesskey="5">Obtaining the documentation</a></td><td> </td><td align="left" valign="top">Install documentation for offline use (optional) -</td></tr> -</table> - - - - -</body> -</html> diff --git a/src/docs/Configuring-Init.html b/src/docs/Configuring-Init.html deleted file mode 100644 index 93f7f35..0000000 --- a/src/docs/Configuring-Init.html +++ /dev/null @@ -1,78 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> -<html> -<!-- Copyright (C) 2020 Cem Keylan - -Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.3 or -any later version published by the Free Software Foundation; with no -Invariant Sections, with no Front-Cover Texts and no Back-Cover Texts. -A copy of the license is included in the section entitled "GNU Free -Documentation License." - --> -<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> -<title>Configuring Init (Carbs Linux User Manual)</title> - -<meta name="description" content="Configuring Init (Carbs Linux User Manual)"> -<meta name="keywords" content="Configuring Init (Carbs Linux User Manual)"> -<meta name="resource-type" content="document"> -<meta name="distribution" content="global"> -<meta name="Generator" content="makeinfo"> -<link href="index.html" rel="start" title="Top"> -<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents"> -<link href="Init-System.html" rel="up" title="Init System"> -<link href="Kernel-Command-Line.html" rel="next" title="Kernel Command Line"> -<link href="Init-System.html" rel="prev" title="Init System"> -<style type="text/css"> -<!-- -a.summary-letter {text-decoration: none} -blockquote.indentedblock {margin-right: 0em} -div.display {margin-left: 3.2em} -div.example {margin-left: 3.2em} -div.lisp {margin-left: 3.2em} -kbd {font-style: oblique} -pre.display {font-family: inherit} -pre.format {font-family: inherit} -pre.menu-comment {font-family: serif} -pre.menu-preformatted {font-family: serif} -span.nolinebreak {white-space: nowrap} -span.roman {font-family: initial; font-weight: normal} -span.sansserif {font-family: sans-serif; font-weight: normal} -ul.no-bullet {list-style: none} ---> -</style> - - -</head> - -<body lang="en"> -<span id="Configuring-Init"></span><div class="header"> -<p> -Next: <a href="Changing-Init-Program.html" accesskey="n" rel="next">Changing Init Program</a>, Up: <a href="Init-System.html" accesskey="u" rel="up">Init System</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> -</div> -<hr> -<span id="Configuring-Init-1"></span><h3 class="section">2.1 Configuring Init</h3> - -<p>There are three ways you can change the behaviour of the init system. Those are: -</p> -<ul> -<li> Kernel Command Line -</li><li> ‘<samp>/etc/init/rc.conf</samp>’ file -</li><li> Init Hooks -</li></ul> - -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="Kernel-Command-Line.html" accesskey="1">Kernel Command Line</a></td><td> </td><td align="left" valign="top">Configure init through the boot parameters -</td></tr> -<tr><td align="left" valign="top">• <a href="_002fetc_002finit_002frcconf-file.html" accesskey="2">‘<samp>/etc/init/rc.conf</samp>’ file</a></td><td> </td><td align="left" valign="top">Configure init through the configuration file -</td></tr> -<tr><td align="left" valign="top">• <a href="Init-Hooks.html" accesskey="3">Init Hooks</a></td><td> </td><td align="left" valign="top">Configure init through hooks -</td></tr> -</table> - - - - -</body> -</html> diff --git a/src/docs/Configuring-hostname.html b/src/docs/Configuring-hostname.html deleted file mode 100644 index f4d4bee..0000000 --- a/src/docs/Configuring-hostname.html +++ /dev/null @@ -1,68 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> -<html> -<!-- Copyright (C) 2020 Cem Keylan - -Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.3 or -any later version published by the Free Software Foundation; with no -Invariant Sections, with no Front-Cover Texts and no Back-Cover Texts. -A copy of the license is included in the section entitled "GNU Free -Documentation License." - --> -<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> -<title>Configuring hostname (Carbs Linux User Manual)</title> - -<meta name="description" content="Configuring hostname (Carbs Linux User Manual)"> -<meta name="keywords" content="Configuring hostname (Carbs Linux User Manual)"> -<meta name="resource-type" content="document"> -<meta name="distribution" content="global"> -<meta name="Generator" content="makeinfo"> -<link href="index.html" rel="start" title="Top"> -<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents"> -<link href="System-Configuration.html" rel="up" title="System Configuration"> -<link href="Hosts-file.html" rel="next" title="Hosts file"> -<link href="System-Configuration.html" rel="prev" title="System Configuration"> -<style type="text/css"> -<!-- -a.summary-letter {text-decoration: none} -blockquote.indentedblock {margin-right: 0em} -div.display {margin-left: 3.2em} -div.example {margin-left: 3.2em} -div.lisp {margin-left: 3.2em} -kbd {font-style: oblique} -pre.display {font-family: inherit} -pre.format {font-family: inherit} -pre.menu-comment {font-family: serif} -pre.menu-preformatted {font-family: serif} -span.nolinebreak {white-space: nowrap} -span.roman {font-family: initial; font-weight: normal} -span.sansserif {font-family: sans-serif; font-weight: normal} -ul.no-bullet {list-style: none} ---> -</style> - - -</head> - -<body lang="en"> -<span id="Configuring-hostname"></span><div class="header"> -<p> -Next: <a href="Hosts-file.html" accesskey="n" rel="next">Hosts file</a>, Up: <a href="System-Configuration.html" accesskey="u" rel="up">System Configuration</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> -</div> -<hr> -<span id="Configuring-hostname-1"></span><h4 class="subsection">1.3.1 Configuring hostname</h4> - -<p>You might want to add a hostname, especially in a networked environment. Your -hostname will default to ’carbslinux’ unless you set this. -</p> -<div class="example"> -<pre class="example">echo your-hostname > /etc/hostname -</pre></div> - - - - -</body> -</html> diff --git a/src/docs/Essential-Software.html b/src/docs/Essential-Software.html deleted file mode 100644 index 3910e9b..0000000 --- a/src/docs/Essential-Software.html +++ /dev/null @@ -1,120 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> -<html> -<!-- Copyright (C) 2020 Cem Keylan - -Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.3 or -any later version published by the Free Software Foundation; with no -Invariant Sections, with no Front-Cover Texts and no Back-Cover Texts. -A copy of the license is included in the section entitled "GNU Free -Documentation License." - --> -<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> -<title>Essential Software (Carbs Linux User Manual)</title> - -<meta name="description" content="Essential Software (Carbs Linux User Manual)"> -<meta name="keywords" content="Essential Software (Carbs Linux User Manual)"> -<meta name="resource-type" content="document"> -<meta name="distribution" content="global"> -<meta name="Generator" content="makeinfo"> -<link href="index.html" rel="start" title="Top"> -<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents"> -<link href="Chroot.html" rel="up" title="Chroot"> -<link href="Obtaining-the-documentation.html" rel="next" title="Obtaining the documentation"> -<link href="Installing-packages.html" rel="prev" title="Installing packages"> -<style type="text/css"> -<!-- -a.summary-letter {text-decoration: none} -blockquote.indentedblock {margin-right: 0em} -div.display {margin-left: 3.2em} -div.example {margin-left: 3.2em} -div.lisp {margin-left: 3.2em} -kbd {font-style: oblique} -pre.display {font-family: inherit} -pre.format {font-family: inherit} -pre.menu-comment {font-family: serif} -pre.menu-preformatted {font-family: serif} -span.nolinebreak {white-space: nowrap} -span.roman {font-family: initial; font-weight: normal} -span.sansserif {font-family: sans-serif; font-weight: normal} -ul.no-bullet {list-style: none} ---> -</style> - - -</head> - -<body lang="en"> -<span id="Essential-Software"></span><div class="header"> -<p> -Next: <a href="Obtaining-the-documentation.html" accesskey="n" rel="next">Obtaining the documentation</a>, Previous: <a href="Installing-packages.html" accesskey="p" rel="prev">Installing packages</a>, Up: <a href="Chroot.html" accesskey="u" rel="up">Chroot</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> -</div> -<hr> -<span id="Essential-Software-1"></span><h4 class="subsection">1.2.4 Essential Software</h4> - -<p>Here is a list of software that you might want to have on your system. -</p> -<p><strong>BOOTLOADERS</strong> -</p> -<ul> -<li> efibootmgr -</li><li> grub -</li></ul> - -<p><strong>FILESYSTEMS</strong> -</p> -<ul> -<li> e2fsprogs -</li><li> dosfstools -</li><li> ntfs-3g -</li></ul> - -<p><strong>NETWORKING</strong> -</p> -<ul> -<li> dhcpcd -</li><li> wpa<em>_supplicant</em> -</li></ul> - -<p><strong>TEXT EDITORS</strong> -</p> -<ul> -<li> nano -</li><li> vim -</li><li> neatvi -</li><li> emacs -</li><li> emacs-nox (terminal-only version of emacs) -</li></ul> - -<p><strong>USER SHELLS</strong> -</p> -<ul> -<li> bash -</li><li> zsh -</li><li> oksh -</li><li> rc -</li></ul> - -<p><strong>POSIX BASE UTILITIES</strong> -</p> -<ul> -<li> busybox -</li><li> sbase -</li><li> coreutils -</li></ul> - -<p><strong>DOCUMENTATION</strong> -</p> -<ul> -<li> carbs-docs -</li><li> man-pages -</li><li> man-pages-posix -</li></ul> - - - - -</body> -</html> diff --git a/src/docs/Extracting-the-tarball.html b/src/docs/Extracting-the-tarball.html deleted file mode 100644 index 8659608..0000000 --- a/src/docs/Extracting-the-tarball.html +++ /dev/null @@ -1,70 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> -<html> -<!-- Copyright (C) 2020 Cem Keylan - -Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.3 or -any later version published by the Free Software Foundation; with no -Invariant Sections, with no Front-Cover Texts and no Back-Cover Texts. -A copy of the license is included in the section entitled "GNU Free -Documentation License." - --> -<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> -<title>Extracting the tarball (Carbs Linux User Manual)</title> - -<meta name="description" content="Extracting the tarball (Carbs Linux User Manual)"> -<meta name="keywords" content="Extracting the tarball (Carbs Linux User Manual)"> -<meta name="resource-type" content="document"> -<meta name="distribution" content="global"> -<meta name="Generator" content="makeinfo"> -<link href="index.html" rel="start" title="Top"> -<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents"> -<link href="Preparing-Environment.html" rel="up" title="Preparing Environment"> -<link href="Obtain-the-chroot-helper.html" rel="next" title="Obtain the chroot helper"> -<link href="Signature-verification.html" rel="prev" title="Signature verification"> -<style type="text/css"> -<!-- -a.summary-letter {text-decoration: none} -blockquote.indentedblock {margin-right: 0em} -div.display {margin-left: 3.2em} -div.example {margin-left: 3.2em} -div.lisp {margin-left: 3.2em} -kbd {font-style: oblique} -pre.display {font-family: inherit} -pre.format {font-family: inherit} -pre.menu-comment {font-family: serif} -pre.menu-preformatted {font-family: serif} -span.nolinebreak {white-space: nowrap} -span.roman {font-family: initial; font-weight: normal} -span.sansserif {font-family: sans-serif; font-weight: normal} -ul.no-bullet {list-style: none} ---> -</style> - - -</head> - -<body lang="en"> -<span id="Extracting-the-tarball"></span><div class="header"> -<p> -Next: <a href="Obtain-the-chroot-helper.html" accesskey="n" rel="next">Obtain the chroot helper</a>, Previous: <a href="Signature-verification.html" accesskey="p" rel="prev">Signature verification</a>, Up: <a href="Preparing-Environment.html" accesskey="u" rel="up">Preparing Environment</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> -</div> -<hr> -<span id="Extracting-the-tarball-1"></span><h4 class="subsection">1.1.3 Extracting the tarball</h4> - -<p>You will need to extract the tarball to your desired location. For partitioning, -you can follow <a href="https://wiki.archlinux.org/index.php/Partitioning">this guide</a>. This will assume that you will be mounting your root -partition to ‘<samp>/mnt</samp>’. -</p> -<div class="example"> -<pre class="example">mount /dev/sdx1 /mnt -tar xf carbs-rootfs.tar.xz -C /mnt -</pre></div> - - - - -</body> -</html> diff --git a/src/docs/Fstab.html b/src/docs/Fstab.html deleted file mode 100644 index d4573ec..0000000 --- a/src/docs/Fstab.html +++ /dev/null @@ -1,70 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> -<html> -<!-- Copyright (C) 2020 Cem Keylan - -Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.3 or -any later version published by the Free Software Foundation; with no -Invariant Sections, with no Front-Cover Texts and no Back-Cover Texts. -A copy of the license is included in the section entitled "GNU Free -Documentation License." - --> -<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> -<title>Fstab (Carbs Linux User Manual)</title> - -<meta name="description" content="Fstab (Carbs Linux User Manual)"> -<meta name="keywords" content="Fstab (Carbs Linux User Manual)"> -<meta name="resource-type" content="document"> -<meta name="distribution" content="global"> -<meta name="Generator" content="makeinfo"> -<link href="index.html" rel="start" title="Top"> -<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents"> -<link href="Making-your-system-bootable.html" rel="up" title="Making your system bootable"> -<link href="Post_002dinstallation.html" rel="next" title="Post-installation"> -<link href="Init-scripts.html" rel="prev" title="Init scripts"> -<style type="text/css"> -<!-- -a.summary-letter {text-decoration: none} -blockquote.indentedblock {margin-right: 0em} -div.display {margin-left: 3.2em} -div.example {margin-left: 3.2em} -div.lisp {margin-left: 3.2em} -kbd {font-style: oblique} -pre.display {font-family: inherit} -pre.format {font-family: inherit} -pre.menu-comment {font-family: serif} -pre.menu-preformatted {font-family: serif} -span.nolinebreak {white-space: nowrap} -span.roman {font-family: initial; font-weight: normal} -span.sansserif {font-family: sans-serif; font-weight: normal} -ul.no-bullet {list-style: none} ---> -</style> - - -</head> - -<body lang="en"> -<span id="Fstab"></span><div class="header"> -<p> -Previous: <a href="Init-scripts.html" accesskey="p" rel="prev">Init scripts</a>, Up: <a href="Making-your-system-bootable.html" accesskey="u" rel="up">Making your system bootable</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> -</div> -<hr> -<span id="Fstab-1"></span><h4 class="subsection">1.5.3 Fstab</h4> - -<p>You can now manually edit your fstab entry, or you can use the genfstab tool. -If you want to use the tool, exit the chroot and run the following: -</p> -<div class="example"> -<pre class="example">wget https://github.com/cemkeylan/genfstab/raw/master/genfstab -chmod +x genfstab -./genfstab -U /mnt >> /mnt/etc/fstab -</pre></div> - - - - -</body> -</html> diff --git a/src/docs/GNU-Free-Documentation-License.html b/src/docs/GNU-Free-Documentation-License.html deleted file mode 100644 index 4fb6747..0000000 --- a/src/docs/GNU-Free-Documentation-License.html +++ /dev/null @@ -1,549 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> -<html> -<!-- Copyright (C) 2020 Cem Keylan - -Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.3 or -any later version published by the Free Software Foundation; with no -Invariant Sections, with no Front-Cover Texts and no Back-Cover Texts. -A copy of the license is included in the section entitled "GNU Free -Documentation License." - --> -<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> -<title>GNU Free Documentation License (Carbs Linux User Manual)</title> - -<meta name="description" content="GNU Free Documentation License (Carbs Linux User Manual)"> -<meta name="keywords" content="GNU Free Documentation License (Carbs Linux User Manual)"> -<meta name="resource-type" content="document"> -<meta name="distribution" content="global"> -<meta name="Generator" content="makeinfo"> -<link href="index.html" rel="start" title="Top"> -<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents"> -<link href="index.html" rel="up" title="Top"> -<link href="Repository-Conventions.html" rel="prev" title="Repository Conventions"> -<style type="text/css"> -<!-- -a.summary-letter {text-decoration: none} -blockquote.indentedblock {margin-right: 0em} -div.display {margin-left: 3.2em} -div.example {margin-left: 3.2em} -div.lisp {margin-left: 3.2em} -kbd {font-style: oblique} -pre.display {font-family: inherit} -pre.format {font-family: inherit} -pre.menu-comment {font-family: serif} -pre.menu-preformatted {font-family: serif} -span.nolinebreak {white-space: nowrap} -span.roman {font-family: initial; font-weight: normal} -span.sansserif {font-family: sans-serif; font-weight: normal} -ul.no-bullet {list-style: none} ---> -</style> - - -</head> - -<body lang="en"> -<span id="GNU-Free-Documentation-License"></span><div class="header"> -<p> -Previous: <a href="Contribution-Guidelines.html" accesskey="p" rel="prev">Contribution Guidelines</a>, Up: <a href="index.html" accesskey="u" rel="up">Top</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> -</div> -<hr> -<span id="GNU-Free-Documentation-License-1"></span><h2 class="appendix">Appendix A GNU Free Documentation License</h2> - -<div align="center">Version 1.3, 3 November 2008 -</div> -<div class="display"> -<pre class="display">Copyright © 2000, 2001, 2002, 2007, 2008 Free Software Foundation, Inc. -<a href="http://fsf.org/">http://fsf.org/</a> - -Everyone is permitted to copy and distribute verbatim copies -of this license document, but changing it is not allowed. -</pre></div> - -<ol start="0"> -<li> PREAMBLE - -<p>The purpose of this License is to make a manual, textbook, or other -functional and useful document <em>free</em> -in the sense of freedom: to assure everyone the effective freedom -to copy and redistribute it, with or without modifying it, either -commercially or noncommercially. Secondarily, this License -preserves for the author and publisher a way to get credit for -their work, while not being considered responsible for -modifications made by others. -</p> -<p>This License is a kind of "copyleft", which means that derivative -works of the document must themselves be free in the same sense. -It complements the GNU General Public License, which is a copyleft -license designed for free software. -</p> -<p>We have designed this License in order to use it for manuals for -free software, because free software needs free documentation: -a free program should come with manuals providing the same freedoms -that the software does. But this License is not limited to -software manuals; it can be used for any textual work, regardless -of subject matter or whether it is published as a printed book. We -recommend this License principally for works whose purpose is -instruction or reference. -</p> -</li><li> APPLICABILITY AND DEFINITIONS - -<p>This License applies to any manual or other work, in any medium, -that contains a notice placed by the copyright holder saying it can -be distributed under the terms of this License. Such a notice -grants a world-wide, royalty-free license, unlimited in duration, -to use that work under the conditions stated herein. The -"Document", below, refers to any such manual or work. Any member -of the public is a licensee, and is addressed as "you". You accept -the license if you copy, modify or distribute the work in a way -requiring permission under copyright law. -</p> -<p>A "Modified Version" of the Document means any work containing the -Document or a portion of it, either copied verbatim, or with -modifications and/or translated into another language. -</p> -<p>A "Secondary Section" is a named appendix or a front-matter section -of the Document that deals exclusively with the relationship of the -publishers or authors of the Document to the Document’s overall -subject (or to related matters) and contains nothing that could -fall directly within that overall subject. (Thus, if the Document -is in part a textbook of mathematics, a Secondary Section may not -explain any mathematics.) The relationship could be a matter of -historical connection with the subject or with related matters, or -of legal, commercial, philosophical, ethical or political position -regarding them. -</p> -<p>The "Invariant Sections" are certain Secondary Sections whose -titles are designated, as being those of Invariant Sections, in the -notice that says that the Document is released under this License. -If a section does not fit the above definition of Secondary then it -is not allowed to be designated as Invariant. The Document may -contain zero Invariant Sections. If the Document does not identify -any Invariant Sections then there are none. -</p> -<p>The "Cover Texts" are certain short passages of text that are -listed, as Front-Cover Texts or Back-Cover Texts, in the notice -that says that the Document is released under this License. -A Front-Cover Text may be at most 5 words, and a Back-Cover Text -may be at most 25 words. -</p> -<p>A "Transparent" copy of the Document means a machine-readable copy, -represented in a format whose specification is available to the -general public, that is suitable for revising the document -straightforwardly with generic text editors or (for images composed -of pixels) generic paint programs or (for drawings) some widely -available drawing editor, and that is suitable for input to text -formatters or for automatic translation to a variety of formats -suitable for input to text formatters. A copy made in an otherwise -Transparent file format whose markup, or absence of markup, has -been arranged to thwart or discourage subsequent modification by -readers is not Transparent. An image format is not Transparent if -used for any substantial amount of text. A copy that is not -"Transparent" is called "Opaque". -</p> -<p>Examples of suitable formats for Transparent copies include plain -ASCII without markup, Texinfo input format, LaTeX input format, -SGML or XML using a publicly available DTD, and standard-conforming -simple HTML, PostScript or PDF designed for human modification. -Examples of transparent image formats include PNG, XCF and JPG. -Opaque formats include proprietary formats that can be read and -edited only by proprietary word processors, SGML or XML for which -the DTD and/or processing tools are not generally available, and -the machine-generated HTML, PostScript or PDF produced by some word -processors for output purposes only. -</p> -<p>The "Title Page" means, for a printed book, the title page itself, -plus such following pages as are needed to hold, legibly, the -material this License requires to appear in the title page. For -works in formats which do not have any title page as such, "Title -Page" means the text near the most prominent appearance of the -work’s title, preceding the beginning of the body of the text. -</p> -<p>The "publisher" means any person or entity that distributes copies -of the Document to the public. -</p> -<p>A section "Entitled XYZ" means a named subunit of the Document -whose title either is precisely XYZ or contains XYZ in parentheses -following text that translates XYZ in another language. (Here XYZ -stands for a specific section name mentioned below, such as -"Acknowledgements", "Dedications", "Endorsements", or "History".) -To "Preserve the Title" of such a section when you modify the -Document means that it remains a section "Entitled XYZ" according -to this definition. -</p> -<p>The Document may include Warranty Disclaimers next to the notice -which states that this License applies to the Document. These -Warranty Disclaimers are considered to be included by reference in -this License, but only as regards disclaiming warranties: any other -implication that these Warranty Disclaimers may have is void and -has no effect on the meaning of this License. -</p> -</li><li> VERBATIM COPYING - -<p>You may copy and distribute the Document in any medium, either -commercially or noncommercially, provided that this License, the -copyright notices, and the license notice saying this License -applies to the Document are reproduced in all copies, and that you -add no other conditions whatsoever to those of this License. You -may not use technical measures to obstruct or control the reading -or further copying of the copies you make or distribute. However, -you may accept compensation in exchange for copies. If you -distribute a large enough number of copies you must also follow the -conditions in section 3. -</p> -<p>You may also lend copies, under the same conditions stated above, -and you may publicly display copies. -</p> -</li><li> COPYING IN QUANTITY - -<p>If you publish printed copies (or copies in media that commonly -have printed covers) of the Document, numbering more than 100, and -the Document’s license notice requires Cover Texts, you must -enclose the copies in covers that carry, clearly and legibly, all -these Cover Texts: Front-Cover Texts on the front cover, and -Back-Cover Texts on the back cover. Both covers must also clearly -and legibly identify you as the publisher of these copies. The -front cover must present the full title with all words of the title -equally prominent and visible. You may add other material on the -covers in addition. Copying with changes limited to the covers, as -long as they preserve the title of the Document and satisfy these -conditions, can be treated as verbatim copying in other respects. -</p> -<p>If the required texts for either cover are too voluminous to fit -legibly, you should put the first ones listed (as many as fit -reasonably) on the actual cover, and continue the rest onto -adjacent pages. -</p> -<p>If you publish or distribute Opaque copies of the Document -numbering more than 100, you must either include a machine-readable -Transparent copy along with each Opaque copy, or state in or with -each Opaque copy a computer-network location from which the general -network-using public has access to download using public-standard -network protocols a complete Transparent copy of the Document, free -of added material. If you use the latter option, you must take -reasonably prudent steps, when you begin distribution of Opaque -copies in quantity, to ensure that this Transparent copy will -remain thus accessible at the stated location until at least one -year after the last time you distribute an Opaque copy (directly or -through your agents or retailers) of that edition to the public. -</p> -<p>It is requested, but not required, that you contact the authors of -the Document well before redistributing any large number of copies, -to give them a chance to provide you with an updated version of the -Document. -</p> -</li><li> MODIFICATIONS - -<p>You may copy and distribute a Modified Version of the Document -under the conditions of sections 2 and 3 above, provided that you -release the Modified Version under precisely this License, with the -Modified Version filling the role of the Document, thus licensing -distribution and modification of the Modified Version to whoever -possesses a copy of it. In addition, you must do these things in -the Modified Version: -</p> -<ol type="A" start="1"> -<li> Use in the Title Page (and on the covers, if any) a title -distinct from that of the Document, and from those of previous -versions (which should, if there were any, be listed in the -History section of the Document). You may use the same title as -a previous version if the original publisher of that version -gives permission. - -</li><li> List on the Title Page, as authors, one or more persons or -entities responsible for authorship of the modifications in the -Modified Version, together with at least five of the principal -authors of the Document (all of its principal authors, if it has -fewer than five), unless they release you from this requirement. - -</li><li> State on the Title page the name of the publisher of the -Modified Version, as the publisher. - -</li><li> Preserve all the copyright notices of the Document. - -</li><li> Add an appropriate copyright notice for your modifications -adjacent to the other copyright notices. - -</li><li> Include, immediately after the copyright notices, a license -notice giving the public permission to use the Modified Version -under the terms of this License, in the form shown in the -Addendum below. - -</li><li> Preserve in that license notice the full lists of Invariant -Sections and required Cover Texts given in the Document’s -license notice. - -</li><li> Include an unaltered copy of this License. - -</li><li> Preserve the section Entitled "History", Preserve its Title, and -add to it an item stating at least the title, year, new authors, -and publisher of the Modified Version as given on the Title -Page. If there is no section Entitled "History" in the Document, -create one stating the title, year, authors, and publisher of -the Document as given on its Title Page, then add an item -describing the Modified Version as stated in the previous -sentence. - -</li><li> Preserve the network location, if any, given in the Document -for public access to a Transparent copy of the Document, and -likewise the network locations given in the Document for -previous versions it was based on. These may be placed in the -"History" section. You may omit a network location for a work -that was published at least four years before the Document -itself, or if the original publisher of the version it refers -to gives permission. - -</li><li> For any section Entitled "Acknowledgements" or "Dedications", -Preserve the Title of the section, and preserve in the section -all the substance and tone of each of the contributor -acknowledgements and/or dedications given therein. - -</li><li> Preserve all the Invariant Sections of the Document, unaltered -in their text and in their titles. Section numbers or the -equivalent are not considered part of the section titles. - -</li><li> Delete any section Entitled "Endorsements". Such a section may -not be included in the Modified Version. - -</li><li> Do not retitle any existing section to be Entitled -"Endorsements" or to conflict in title with any Invariant -Section. - -</li><li> Preserve any Warranty Disclaimers. -</li></ol> - -<p>If the Modified Version includes new front-matter sections or -appendices that qualify as Secondary Sections and contain no material -copied from the Document, you may at your option designate some or all -of these sections as invariant. To do this, add their titles to the -list of Invariant Sections in the Modified Version’s license notice. -These titles must be distinct from any other section titles. -</p> -<p>You may add a section Entitled "Endorsements", provided it contains -nothing but endorsements of your Modified Version by various -parties—for example, statements of peer review or that the text has -been approved by an organization as the authoritative definition of a -standard. -</p> -<p>You may add a passage of up to five words as a Front-Cover Text, and a -passage of up to 25 words as a Back-Cover Text, to the end of the list -of Cover Texts in the Modified Version. Only one passage of -Front-Cover Text and one of Back-Cover Text may be added by (or -through arrangements made by) any one entity. If the Document already -includes a cover text for the same cover, previously added by you or -by arrangement made by the same entity you are acting on behalf of, -you may not add another; but you may replace the old one, on explicit -permission from the previous publisher that added the old one. -</p> -<p>The author(s) and publisher(s) of the Document do not by this License -give permission to use their names for publicity for or to assert or -imply endorsement of any Modified Version. -</p> -</li><li> COMBINING DOCUMENTS - -<p>You may combine the Document with other documents released under -this License, under the terms defined in section 4 above for -modified versions, provided that you include in the combination all -of the Invariant Sections of all of the original documents, -unmodified, and list them all as Invariant Sections of your -combined work in its license notice, and that you preserve all -their Warranty Disclaimers. -</p> -<p>The combined work need only contain one copy of this License, and -multiple identical Invariant Sections may be replaced with a single -copy. If there are multiple Invariant Sections with the same name -but different contents, make the title of each such section unique -by adding at the end of it, in parentheses, the name of the -original author or publisher of that section if known, or else -a unique number. Make the same adjustment to the section titles in -the list of Invariant Sections in the license notice of the -combined work. -</p> -<p>In the combination, you must combine any sections Entitled -"History" in the various original documents, forming one section -Entitled "History"; likewise combine any sections Entitled -"Acknowledgements", and any sections Entitled "Dedications". You -must delete all sections Entitled "Endorsements." -</p> -</li><li> COLLECTIONS OF DOCUMENTS - -<p>You may make a collection consisting of the Document and other -documents released under this License, and replace the individual -copies of this License in the various documents with a single copy -that is included in the collection, provided that you follow the -rules of this License for verbatim copying of each of the documents -in all other respects. -</p> -<p>You may extract a single document from such a collection, and -distribute it individually under this License, provided you insert -a copy of this License into the extracted document, and follow this -License in all other respects regarding verbatim copying of that -document. -</p> -</li><li> AGGREGATION WITH INDEPENDENT WORKS - -<p>A compilation of the Document or its derivatives with other -separate and independent documents or works, in or on a volume of -a storage or distribution medium, is called an "aggregate" if the -copyright resulting from the compilation is not used to limit the -legal rights of the compilation’s users beyond what the individual -works permit. When the Document is included in an aggregate, this -License does not apply to the other works in the aggregate which -are not themselves derivative works of the Document. -</p> -<p>If the Cover Text requirement of section 3 is applicable to these -copies of the Document, then if the Document is less than one half -of the entire aggregate, the Document’s Cover Texts may be placed -on covers that bracket the Document within the aggregate, or the -electronic equivalent of covers if the Document is in electronic -form. Otherwise they must appear on printed covers that bracket -the whole aggregate. -</p> -</li><li> TRANSLATION - -<p>Translation is considered a kind of modification, so you may -distribute translations of the Document under the terms of -section 4. Replacing Invariant Sections with translations requires -special permission from their copyright holders, but you may -include translations of some or all Invariant Sections in addition -to the original versions of these Invariant Sections. You may -include a translation of this License, and all the license notices -in the Document, and any Warranty Disclaimers, provided that you -also include the original English version of this License and the -original versions of those notices and disclaimers. In case of -a disagreement between the translation and the original version of -this License or a notice or disclaimer, the original version will -prevail. -</p> -<p>If a section in the Document is Entitled "Acknowledgements", -"Dedications", or "History", the requirement (section 4) to -Preserve its Title (section 1) will typically require changing the -actual title. -</p> -</li><li> TERMINATION - -<p>You may not copy, modify, sublicense, or distribute the Document -except as expressly provided under this License. Any attempt -otherwise to copy, modify, sublicense, or distribute it is void, -and will automatically terminate your rights under this License. -</p> -<p>However, if you cease all violation of this License, then your -license from a particular copyright holder is reinstated (a) -provisionally, unless and until the copyright holder explicitly and -finally terminates your license, and (b) permanently, if the -copyright holder fails to notify you of the violation by some -reasonable means prior to 60 days after the cessation. -</p> -<p>Moreover, your license from a particular copyright holder is -reinstated permanently if the copyright holder notifies you of the -violation by some reasonable means, this is the first time you have -received notice of violation of this License (for any work) from -that copyright holder, and you cure the violation prior to 30 days -after your receipt of the notice. -</p> -<p>Termination of your rights under this section does not terminate -the licenses of parties who have received copies or rights from you -under this License. If your rights have been terminated and not -permanently reinstated, receipt of a copy of some or all of the -same material does not give you any rights to use it. -</p> -</li><li> FUTURE REVISIONS OF THIS LICENSE - -<p>The Free Software Foundation may publish new, revised versions of -the GNU Free Documentation License from time to time. Such new -versions will be similar in spirit to the present version, but may -differ in detail to address new problems or concerns. See -<a href="http://www.gnu.org/copyleft/">http://www.gnu.org/copyleft/</a>. -</p> -<p>Each version of the License is given a distinguishing version -number. If the Document specifies that a particular numbered -version of this License "or any later version" applies to it, you -have the option of following the terms and conditions either of -that specified version or of any later version that has been -published (not as a draft) by the Free Software Foundation. If -the Document does not specify a version number of this License, -you may choose any version ever published (not as a draft) by the -Free Software Foundation. If the Document specifies that a proxy -can decide which future versions of this License can be used, that -proxy’s public statement of acceptance of a version permanently -authorizes you to choose that version for the Document. -</p> -</li><li> RELICENSING - -<p>"Massive Multiauthor Collaboration Site" (or "MMC Site") means any -World Wide Web server that publishes copyrightable works and also -provides prominent facilities for anybody to edit those works. -A public wiki that anybody can edit is an example of such -a server. A "Massive Multiauthor Collaboration" (or "MMC") -contained in the site means any set of copyrightable works thus -published on the MMC site. -</p> -<p>"CC-BY-SA" means the Creative Commons Attribution-Share Alike 3.0 -license published by Creative Commons Corporation, -a not-for-profit corporation with a principal place of business in -San Francisco, California, as well as future copyleft versions of -that license published by that same organization. -</p> -<p>"Incorporate" means to publish or republish a Document, in whole -or in part, as part of another Document. -</p> -<p>An MMC is "eligible for relicensing" if it is licensed under this -License, and if all works that were first published under this -License somewhere other than this MMC, and subsequently -incorporated in whole or in part into the MMC, (1) had no cover -texts or invariant sections, and (2) were thus incorporated prior -to November 1, 2008. -</p> -<p>The operator of an MMC Site may republish an MMC contained in the -site under CC-BY-SA on the same site at any time before August 1, -2009, provided the MMC is eligible for relicensing. -</p></li></ol> - - -<span id="ADDENDUM-How-to-use-this-License-for-your-documents"></span><span id="ADDENDUM_003a-How-to-use-this-License-for-your-documents"></span><h3 class="appendixsec">A.1 ADDENDUM: How to use this License for your documents</h3> - -<p>To use this License in a document you have written, include a copy of -the License in the document and put the following copyright and -license notices just after the title page: -</p> -<div class="example"> -<pre class="example">Copyright (C) YEAR YOUR NAME. -Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.3 -or any later version published by the Free Software Foundation; -with no Invariant Sections, no Front-Cover Texts, and no Back-Cover -Texts. A copy of the license is included in the section entitled ``GNU -Free Documentation License''. -</pre></div> - -<p>If you have Invariant Sections, Front-Cover Texts and Back-Cover Texts, -replace the "with…Texts." line with this: -</p> -<div class="example"> -<pre class="example">with the Invariant Sections being LIST THEIR TITLES, with -the Front-Cover Texts being LIST, and with the Back-Cover Texts -being LIST. -</pre></div> - -<p>If you have Invariant Sections without Cover Texts, or some other -combination of the three, merge those two alternatives to suit the -situation. -</p> -<p>If your document contains nontrivial examples of program code, we -recommend releasing these examples in parallel under your choice of -free software license, such as the GNU General Public License, to -permit their use in free software. -</p> -<hr> -<div class="header"> -<p> -Previous: <a href="Contribution-Guidelines.html" accesskey="p" rel="prev">Contribution Guidelines</a>, Up: <a href="index.html" accesskey="u" rel="up">Top</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> -</div> - - - -</body> -</html> diff --git a/src/docs/Init-scripts.html b/src/docs/Init-scripts.html deleted file mode 100644 index bd5a32a..0000000 --- a/src/docs/Init-scripts.html +++ /dev/null @@ -1,68 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> -<html> -<!-- Copyright (C) 2020 Cem Keylan - -Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.3 or -any later version published by the Free Software Foundation; with no -Invariant Sections, with no Front-Cover Texts and no Back-Cover Texts. -A copy of the license is included in the section entitled "GNU Free -Documentation License." - --> -<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> -<title>Init scripts (Carbs Linux User Manual)</title> - -<meta name="description" content="Init scripts (Carbs Linux User Manual)"> -<meta name="keywords" content="Init scripts (Carbs Linux User Manual)"> -<meta name="resource-type" content="document"> -<meta name="distribution" content="global"> -<meta name="Generator" content="makeinfo"> -<link href="index.html" rel="start" title="Top"> -<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents"> -<link href="Making-your-system-bootable.html" rel="up" title="Making your system bootable"> -<link href="Fstab.html" rel="next" title="Fstab"> -<link href="Bootloader.html" rel="prev" title="Bootloader"> -<style type="text/css"> -<!-- -a.summary-letter {text-decoration: none} -blockquote.indentedblock {margin-right: 0em} -div.display {margin-left: 3.2em} -div.example {margin-left: 3.2em} -div.lisp {margin-left: 3.2em} -kbd {font-style: oblique} -pre.display {font-family: inherit} -pre.format {font-family: inherit} -pre.menu-comment {font-family: serif} -pre.menu-preformatted {font-family: serif} -span.nolinebreak {white-space: nowrap} -span.roman {font-family: initial; font-weight: normal} -span.sansserif {font-family: sans-serif; font-weight: normal} -ul.no-bullet {list-style: none} ---> -</style> - - -</head> - -<body lang="en"> -<span id="Init-scripts"></span><div class="header"> -<p> -Next: <a href="Fstab.html" accesskey="n" rel="next">Fstab</a>, Previous: <a href="Bootloader.html" accesskey="p" rel="prev">Bootloader</a>, Up: <a href="Making-your-system-bootable.html" accesskey="u" rel="up">Making your system bootable</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> -</div> -<hr> -<span id="Init-scripts-1"></span><h4 class="subsection">1.5.2 Init scripts</h4> - -<p>Only thing left to do is installing the init-scripts, and now you are almost -ready to boot your system! -</p> -<div class="example"> -<pre class="example">cpt b carbs-init && cpt i carbs-init -</pre></div> - - - - -</body> -</html> diff --git a/src/docs/Installing-packages.html b/src/docs/Installing-packages.html deleted file mode 100644 index 2a2e342..0000000 --- a/src/docs/Installing-packages.html +++ /dev/null @@ -1,71 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> -<html> -<!-- Copyright (C) 2020 Cem Keylan - -Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.3 or -any later version published by the Free Software Foundation; with no -Invariant Sections, with no Front-Cover Texts and no Back-Cover Texts. -A copy of the license is included in the section entitled "GNU Free -Documentation License." - --> -<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> -<title>Installing packages (Carbs Linux User Manual)</title> - -<meta name="description" content="Installing packages (Carbs Linux User Manual)"> -<meta name="keywords" content="Installing packages (Carbs Linux User Manual)"> -<meta name="resource-type" content="document"> -<meta name="distribution" content="global"> -<meta name="Generator" content="makeinfo"> -<link href="index.html" rel="start" title="Top"> -<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents"> -<link href="Chroot.html" rel="up" title="Chroot"> -<link href="Essential-Software.html" rel="next" title="Essential Software"> -<link href="Updating-packages.html" rel="prev" title="Updating packages"> -<style type="text/css"> -<!-- -a.summary-letter {text-decoration: none} -blockquote.indentedblock {margin-right: 0em} -div.display {margin-left: 3.2em} -div.example {margin-left: 3.2em} -div.lisp {margin-left: 3.2em} -kbd {font-style: oblique} -pre.display {font-family: inherit} -pre.format {font-family: inherit} -pre.menu-comment {font-family: serif} -pre.menu-preformatted {font-family: serif} -span.nolinebreak {white-space: nowrap} -span.roman {font-family: initial; font-weight: normal} -span.sansserif {font-family: sans-serif; font-weight: normal} -ul.no-bullet {list-style: none} ---> -</style> - - -</head> - -<body lang="en"> -<span id="Installing-packages"></span><div class="header"> -<p> -Next: <a href="Essential-Software.html" accesskey="n" rel="next">Essential Software</a>, Previous: <a href="Updating-packages.html" accesskey="p" rel="prev">Updating packages</a>, Up: <a href="Chroot.html" accesskey="u" rel="up">Chroot</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> -</div> -<hr> -<span id="Installing-packages-1"></span><h4 class="subsection">1.2.3 Installing packages</h4> - -<p>Since you are operating on a really small base, you might need to build and -install new programs to extend the functionality of your system. In order to -build and install packages new packages in Carbs, you need to execute the -following. "Package" is not actually a package and is given as an example. -</p> -<div class="example"> -<pre class="example">cpt-build package -cpt-install package -</pre></div> - - - - -</body> -</html> diff --git a/src/docs/KISS-repositories.html b/src/docs/KISS-repositories.html deleted file mode 100644 index 3824e9e..0000000 --- a/src/docs/KISS-repositories.html +++ /dev/null @@ -1,65 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> -<html> -<!-- Copyright (C) 2020 Cem Keylan - -Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.3 or -any later version published by the Free Software Foundation; with no -Invariant Sections, with no Front-Cover Texts and no Back-Cover Texts. -A copy of the license is included in the section entitled "GNU Free -Documentation License." - --> -<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> -<title>KISS repositories (Carbs Linux User Manual)</title> - -<meta name="description" content="KISS repositories (Carbs Linux User Manual)"> -<meta name="keywords" content="KISS repositories (Carbs Linux User Manual)"> -<meta name="resource-type" content="document"> -<meta name="distribution" content="global"> -<meta name="Generator" content="makeinfo"> -<link href="index.html" rel="start" title="Top"> -<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents"> -<link href="Post_002dinstallation.html" rel="up" title="Post-installation"> -<link href="Init-System.html" rel="next" title="Init System"> -<link href="Post_002dinstallation.html" rel="prev" title="Post-installation"> -<style type="text/css"> -<!-- -a.summary-letter {text-decoration: none} -blockquote.indentedblock {margin-right: 0em} -div.display {margin-left: 3.2em} -div.example {margin-left: 3.2em} -div.lisp {margin-left: 3.2em} -kbd {font-style: oblique} -pre.display {font-family: inherit} -pre.format {font-family: inherit} -pre.menu-comment {font-family: serif} -pre.menu-preformatted {font-family: serif} -span.nolinebreak {white-space: nowrap} -span.roman {font-family: initial; font-weight: normal} -span.sansserif {font-family: sans-serif; font-weight: normal} -ul.no-bullet {list-style: none} ---> -</style> - - -</head> - -<body lang="en"> -<span id="KISS-repositories"></span><div class="header"> -<p> -Up: <a href="Post_002dinstallation.html" accesskey="u" rel="up">Post-installation</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> -</div> -<hr> -<span id="KISS-repositories-1"></span><h4 class="subsection">1.6.1 KISS repositories</h4> - -<p>While not 100% compatible with cpt, you can use kiss repositories in your -system the same way you are using the distribution repositories. Here is an -example for the KISS Linux Community repository. -</p> - - - -</body> -</html> diff --git a/src/docs/Kernel-Command-Line.html b/src/docs/Kernel-Command-Line.html deleted file mode 100644 index a099dc8..0000000 --- a/src/docs/Kernel-Command-Line.html +++ /dev/null @@ -1,83 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> -<html> -<!-- Copyright (C) 2020 Cem Keylan - -Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.3 or -any later version published by the Free Software Foundation; with no -Invariant Sections, with no Front-Cover Texts and no Back-Cover Texts. -A copy of the license is included in the section entitled "GNU Free -Documentation License." - --> -<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> -<title>Kernel Command Line (Carbs Linux User Manual)</title> - -<meta name="description" content="Kernel Command Line (Carbs Linux User Manual)"> -<meta name="keywords" content="Kernel Command Line (Carbs Linux User Manual)"> -<meta name="resource-type" content="document"> -<meta name="distribution" content="global"> -<meta name="Generator" content="makeinfo"> -<link href="index.html" rel="start" title="Top"> -<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents"> -<link href="Configuring-Init.html" rel="up" title="Configuring Init"> -<link href="_002fetc_002finit_002frcconf-file.html" rel="next" title="/etc/init/rcconf file"> -<link href="Configuring-Init.html" rel="prev" title="Configuring Init"> -<style type="text/css"> -<!-- -a.summary-letter {text-decoration: none} -blockquote.indentedblock {margin-right: 0em} -div.display {margin-left: 3.2em} -div.example {margin-left: 3.2em} -div.lisp {margin-left: 3.2em} -kbd {font-style: oblique} -pre.display {font-family: inherit} -pre.format {font-family: inherit} -pre.menu-comment {font-family: serif} -pre.menu-preformatted {font-family: serif} -span.nolinebreak {white-space: nowrap} -span.roman {font-family: initial; font-weight: normal} -span.sansserif {font-family: sans-serif; font-weight: normal} -ul.no-bullet {list-style: none} ---> -</style> - - -</head> - -<body lang="en"> -<span id="Kernel-Command-Line"></span><div class="header"> -<p> -Next: <a href="_002fetc_002finit_002frcconf-file.html" accesskey="n" rel="next">‘<samp>/etc/init/rcconf</samp>’ file</a>, Up: <a href="Configuring-Init.html" accesskey="u" rel="up">Configuring Init</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> -</div> -<hr> -<span id="Kernel-Command-Line-1"></span><h4 class="subsection">2.1.1 Kernel Command Line</h4> - -<p>On GRUB, you can edit the kernel command line parameters, which will be parsed -as variables on the init system. Not all of the parameters will be acted upon, -but all of them will be set as variables on the init script. For example an -example command line, and how it is interpreted. -</p> -<div class="example"> -<pre class="example">BOOT_IMAGE=/boot/vmlinuz root=/dev/sda2 rw loglevel=3 quiet -</pre></div> - -<p>This command line will be parsed to set the following variables: -</p> -<div class="example"> -<pre class="example">BOOT_IMAGE=/boot/vmlinuz -root=/dev/sda2 -rw=1 -loglevel=3 -quiet=1 -</pre></div> - -<p>Some of these variables, such as ‘<samp>rw=/=ro</samp>’, ‘<samp>loglevel</samp>’, and ‘<samp>quiet</samp>’, will be -used by the init system to change the behaviour of the startup. -</p> - - - -</body> -</html> diff --git a/src/docs/Kernel.html b/src/docs/Kernel.html deleted file mode 100644 index 10f3945..0000000 --- a/src/docs/Kernel.html +++ /dev/null @@ -1,74 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> -<html> -<!-- Copyright (C) 2020 Cem Keylan - -Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.3 or -any later version published by the Free Software Foundation; with no -Invariant Sections, with no Front-Cover Texts and no Back-Cover Texts. -A copy of the license is included in the section entitled "GNU Free -Documentation License." - --> -<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> -<title>Kernel (Carbs Linux User Manual)</title> - -<meta name="description" content="Kernel (Carbs Linux User Manual)"> -<meta name="keywords" content="Kernel (Carbs Linux User Manual)"> -<meta name="resource-type" content="document"> -<meta name="distribution" content="global"> -<meta name="Generator" content="makeinfo"> -<link href="index.html" rel="start" title="Top"> -<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents"> -<link href="Installation.html" rel="up" title="Installation"> -<link href="Obtaining-the-kernel-sources.html" rel="next" title="Obtaining the kernel sources"> -<link href="Hosts-file.html" rel="prev" title="Hosts file"> -<style type="text/css"> -<!-- -a.summary-letter {text-decoration: none} -blockquote.indentedblock {margin-right: 0em} -div.display {margin-left: 3.2em} -div.example {margin-left: 3.2em} -div.lisp {margin-left: 3.2em} -kbd {font-style: oblique} -pre.display {font-family: inherit} -pre.format {font-family: inherit} -pre.menu-comment {font-family: serif} -pre.menu-preformatted {font-family: serif} -span.nolinebreak {white-space: nowrap} -span.roman {font-family: initial; font-weight: normal} -span.sansserif {font-family: sans-serif; font-weight: normal} -ul.no-bullet {list-style: none} ---> -</style> - - -</head> - -<body lang="en"> -<span id="Kernel"></span><div class="header"> -<p> -Next: <a href="Making-your-system-bootable.html" accesskey="n" rel="next">Making your system bootable</a>, Previous: <a href="System-Configuration.html" accesskey="p" rel="prev">System Configuration</a>, Up: <a href="Installation.html" accesskey="u" rel="up">Installation</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> -</div> -<hr> -<span id="Kernel-1"></span><h3 class="section">1.4 Kernel</h3> - -<p>Kernel isn’t managed under the main repositories, even though you could package -one for your personal use. Here is an <a href="https://github.com/cemkeylan/kiss-repository/tree/master/personal/linux">example kernel package</a>, which you will -need to reconfigure for your specific setup if you want to make use of it. -</p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="Obtaining-the-kernel-sources.html" accesskey="1">Obtaining the kernel sources</a></td><td> </td><td align="left" valign="top">Downloading the Linux source code -</td></tr> -<tr><td align="left" valign="top">• <a href="Kernel-dependencies.html" accesskey="2">Kernel dependencies</a></td><td> </td><td align="left" valign="top">Requirements for building the kernel -</td></tr> -<tr><td align="left" valign="top">• <a href="Building-the-kernel.html" accesskey="3">Building the kernel</a></td><td> </td><td align="left" valign="top">Configure and compile the kernel -</td></tr> -</table> - - - - -</body> -</html> diff --git a/src/docs/Making-your-system-bootable.html b/src/docs/Making-your-system-bootable.html deleted file mode 100644 index 2e3a759..0000000 --- a/src/docs/Making-your-system-bootable.html +++ /dev/null @@ -1,74 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> -<html> -<!-- Copyright (C) 2020 Cem Keylan - -Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.3 or -any later version published by the Free Software Foundation; with no -Invariant Sections, with no Front-Cover Texts and no Back-Cover Texts. -A copy of the license is included in the section entitled "GNU Free -Documentation License." - --> -<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> -<title>Making your system bootable (Carbs Linux User Manual)</title> - -<meta name="description" content="Making your system bootable (Carbs Linux User Manual)"> -<meta name="keywords" content="Making your system bootable (Carbs Linux User Manual)"> -<meta name="resource-type" content="document"> -<meta name="distribution" content="global"> -<meta name="Generator" content="makeinfo"> -<link href="index.html" rel="start" title="Top"> -<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents"> -<link href="Installation.html" rel="up" title="Installation"> -<link href="Bootloader.html" rel="next" title="Bootloader"> -<link href="Building-the-kernel.html" rel="prev" title="Building the kernel"> -<style type="text/css"> -<!-- -a.summary-letter {text-decoration: none} -blockquote.indentedblock {margin-right: 0em} -div.display {margin-left: 3.2em} -div.example {margin-left: 3.2em} -div.lisp {margin-left: 3.2em} -kbd {font-style: oblique} -pre.display {font-family: inherit} -pre.format {font-family: inherit} -pre.menu-comment {font-family: serif} -pre.menu-preformatted {font-family: serif} -span.nolinebreak {white-space: nowrap} -span.roman {font-family: initial; font-weight: normal} -span.sansserif {font-family: sans-serif; font-weight: normal} -ul.no-bullet {list-style: none} ---> -</style> - - -</head> - -<body lang="en"> -<span id="Making-your-system-bootable"></span><div class="header"> -<p> -Next: <a href="Post_002dinstallation.html" accesskey="n" rel="next">Post-installation</a>, Previous: <a href="Kernel.html" accesskey="p" rel="prev">Kernel</a>, Up: <a href="Installation.html" accesskey="u" rel="up">Installation</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> -</div> -<hr> -<span id="Making-your-system-bootable-1"></span><h3 class="section">1.5 Making your system bootable</h3> - -<p>In order to be able to boot your fresh system, wou will need an init-daemon, -init-scripts and a bootloader. The init daemon is already provided by busybox, -but you can optionally change it. -</p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="Bootloader.html" accesskey="1">Bootloader</a></td><td> </td><td align="left" valign="top">Install a bootloader for your system -</td></tr> -<tr><td align="left" valign="top">• <a href="Init-scripts.html" accesskey="2">Init scripts</a></td><td> </td><td align="left" valign="top">Install init scripts for your system -</td></tr> -<tr><td align="left" valign="top">• <a href="Fstab.html" accesskey="3">Fstab</a></td><td> </td><td align="left" valign="top">Generating fstab -</td></tr> -</table> - - - - -</body> -</html> diff --git a/src/docs/Obtaining-the-documentation.html b/src/docs/Obtaining-the-documentation.html deleted file mode 100644 index 03739b5..0000000 --- a/src/docs/Obtaining-the-documentation.html +++ /dev/null @@ -1,77 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> -<html> -<!-- Copyright (C) 2020 Cem Keylan - -Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.3 or -any later version published by the Free Software Foundation; with no -Invariant Sections, with no Front-Cover Texts and no Back-Cover Texts. -A copy of the license is included in the section entitled "GNU Free -Documentation License." - --> -<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> -<title>Obtaining the documentation (Carbs Linux User Manual)</title> - -<meta name="description" content="Obtaining the documentation (Carbs Linux User Manual)"> -<meta name="keywords" content="Obtaining the documentation (Carbs Linux User Manual)"> -<meta name="resource-type" content="document"> -<meta name="distribution" content="global"> -<meta name="Generator" content="makeinfo"> -<link href="index.html" rel="start" title="Top"> -<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents"> -<link href="Chroot.html" rel="up" title="Chroot"> -<link href="System-Configuration.html" rel="next" title="System Configuration"> -<link href="Essential-Software.html" rel="prev" title="Essential Software"> -<style type="text/css"> -<!-- -a.summary-letter {text-decoration: none} -blockquote.indentedblock {margin-right: 0em} -div.display {margin-left: 3.2em} -div.example {margin-left: 3.2em} -div.lisp {margin-left: 3.2em} -kbd {font-style: oblique} -pre.display {font-family: inherit} -pre.format {font-family: inherit} -pre.menu-comment {font-family: serif} -pre.menu-preformatted {font-family: serif} -span.nolinebreak {white-space: nowrap} -span.roman {font-family: initial; font-weight: normal} -span.sansserif {font-family: sans-serif; font-weight: normal} -ul.no-bullet {list-style: none} ---> -</style> - - -</head> - -<body lang="en"> -<span id="Obtaining-the-documentation"></span><div class="header"> -<p> -Previous: <a href="Essential-Software.html" accesskey="p" rel="prev">Essential Software</a>, Up: <a href="Chroot.html" accesskey="u" rel="up">Chroot</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> -</div> -<hr> -<span id="Obtaining-the-documentation-1"></span><h4 class="subsection">1.2.5 Obtaining the documentation</h4> - -<p>All the documentation for Carbs Linux can be found on a single info manual to be -viewed offline. You can obtain texinfo or the info (standalone) package in order -to view the documentation. -</p> -<div class="example"> -<pre class="example"># Install the documentation. -cpt b carbs-docs && cpt i carbs-docs - -# Install either texinfo or the info package. We will be installing standalone info -# as it doesn't need perl. -cpt b info && cpt i info - -# You can then run info and navigate through the documentation. -info carbslinux -</pre></div> - - - - -</body> -</html> diff --git a/src/docs/Preparing-Environment.html b/src/docs/Preparing-Environment.html deleted file mode 100644 index 89fc029..0000000 --- a/src/docs/Preparing-Environment.html +++ /dev/null @@ -1,88 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> -<html> -<!-- Copyright (C) 2020 Cem Keylan - -Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.3 or -any later version published by the Free Software Foundation; with no -Invariant Sections, with no Front-Cover Texts and no Back-Cover Texts. -A copy of the license is included in the section entitled "GNU Free -Documentation License." - --> -<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> -<title>Preparing Environment (Carbs Linux User Manual)</title> - -<meta name="description" content="Preparing Environment (Carbs Linux User Manual)"> -<meta name="keywords" content="Preparing Environment (Carbs Linux User Manual)"> -<meta name="resource-type" content="document"> -<meta name="distribution" content="global"> -<meta name="Generator" content="makeinfo"> -<link href="index.html" rel="start" title="Top"> -<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents"> -<link href="Installation.html" rel="up" title="Installation"> -<link href="Download.html" rel="next" title="Download"> -<link href="Installation.html" rel="prev" title="Installation"> -<style type="text/css"> -<!-- -a.summary-letter {text-decoration: none} -blockquote.indentedblock {margin-right: 0em} -div.display {margin-left: 3.2em} -div.example {margin-left: 3.2em} -div.lisp {margin-left: 3.2em} -kbd {font-style: oblique} -pre.display {font-family: inherit} -pre.format {font-family: inherit} -pre.menu-comment {font-family: serif} -pre.menu-preformatted {font-family: serif} -span.nolinebreak {white-space: nowrap} -span.roman {font-family: initial; font-weight: normal} -span.sansserif {font-family: sans-serif; font-weight: normal} -ul.no-bullet {list-style: none} ---> -</style> - - -</head> - -<body lang="en"> -<span id="Preparing-Environment"></span><div class="header"> -<p> -Next: <a href="Chroot.html" accesskey="n" rel="next">Chroot</a>, Up: <a href="Installation.html" accesskey="u" rel="up">Installation</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> -</div> -<hr> -<span id="Preparing-Environment-1"></span><h3 class="section">1.1 Preparing Environment</h3> - -<p>To install Carbs Linux, you will need a Live Linux ISO. For that purpose, you -can obtain a Gentoo or Void Linux live image. You can follow their instructions -to boot and setup your network. -</p> -<p>You will need the following programs in order to install Carbs Linux: -</p> -<ul> -<li> tar -</li><li> wget -</li><li> xz -</li><li> some form of base utilities (coreutils, sbase, busybox, etc.) -</li></ul> - -<p>Rest of these instructions will assume that you have set all of these up, and -will continue on that point. -</p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="Download.html" accesskey="1">Download</a></td><td> </td><td align="left" valign="top">Download the root filesystem tarball -</td></tr> -<tr><td align="left" valign="top">• <a href="Signature-verification.html" accesskey="2">Signature verification</a></td><td> </td><td align="left" valign="top">Verify the signature of the rootfs tarball -</td></tr> -<tr><td align="left" valign="top">• <a href="Extracting-the-tarball.html" accesskey="3">Extracting the tarball</a></td><td> </td><td align="left" valign="top">Extracting the root filesystem to the desired location -</td></tr> -<tr><td align="left" valign="top">• <a href="Obtain-the-chroot-helper.html" accesskey="4">Obtain the chroot helper</a></td><td> </td><td align="left" valign="top">Download the script to easily chroot into the new filesystem -</td></tr> -</table> - - - - -</body> -</html> diff --git a/src/docs/Setting-up-repositories.html b/src/docs/Setting-up-repositories.html deleted file mode 100644 index 44360ab..0000000 --- a/src/docs/Setting-up-repositories.html +++ /dev/null @@ -1,117 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> -<html> -<!-- Copyright (C) 2020 Cem Keylan - -Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.3 or -any later version published by the Free Software Foundation; with no -Invariant Sections, with no Front-Cover Texts and no Back-Cover Texts. -A copy of the license is included in the section entitled "GNU Free -Documentation License." - --> -<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> -<title>Setting up repositories (Carbs Linux User Manual)</title> - -<meta name="description" content="Setting up repositories (Carbs Linux User Manual)"> -<meta name="keywords" content="Setting up repositories (Carbs Linux User Manual)"> -<meta name="resource-type" content="document"> -<meta name="distribution" content="global"> -<meta name="Generator" content="makeinfo"> -<link href="index.html" rel="start" title="Top"> -<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents"> -<link href="Chroot.html" rel="up" title="Chroot"> -<link href="Updating-packages.html" rel="next" title="Updating packages"> -<link href="Chroot.html" rel="prev" title="Chroot"> -<style type="text/css"> -<!-- -a.summary-letter {text-decoration: none} -blockquote.indentedblock {margin-right: 0em} -div.display {margin-left: 3.2em} -div.example {margin-left: 3.2em} -div.lisp {margin-left: 3.2em} -kbd {font-style: oblique} -pre.display {font-family: inherit} -pre.format {font-family: inherit} -pre.menu-comment {font-family: serif} -pre.menu-preformatted {font-family: serif} -span.nolinebreak {white-space: nowrap} -span.roman {font-family: initial; font-weight: normal} -span.sansserif {font-family: sans-serif; font-weight: normal} -ul.no-bullet {list-style: none} ---> -</style> - - -</head> - -<body lang="en"> -<span id="Setting-up-repositories"></span><div class="header"> -<p> -Next: <a href="Updating-packages.html" accesskey="n" rel="next">Updating packages</a>, Up: <a href="Chroot.html" accesskey="u" rel="up">Chroot</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> -</div> -<hr> -<span id="Setting-up-repositories-1"></span><h4 class="subsection">1.2.1 Setting up repositories</h4> - -<p>Newest tarballs do not come with repositories, so you will need to manually -obtain them, and set your ‘<samp>CPT_PATH</samp>’ environment variable. Carbs Linux -repositories can either be obtained by ‘<samp>git</samp>’ or ‘<samp>rsync</samp>’. While rsync -repositories are overall faster and smaller, git offers the whole history of the -repository and a means to manipulate your repository as you like it. If you want -to obtain the git repository, you will need to install ‘<samp>git</samp>’ itself. -</p> -<p>The following guide will assume that you put the repositories into ‘<samp>~/repos/</samp>’ -directory, but you can put the repositories into any directory you want. So go -ahead and create that directory: -</p> -<div class="example"> -<pre class="example">mkdir -p $HOME/repos -</pre></div> - -<ol> -<li> Obtaining from git - - -<p>Carbs Linux git repositories can be found both from the main server and GitHub -(mirror). Here are both their repository links. You can clone any of them. -</p> -<ul> -<li> git://git.carbslinux.org/repository -</li><li> <a href="https://github.com/carbslinux/repository">https://github.com/carbslinux/repository</a> -</li></ul> - -<div class="example"> -<pre class="example">git clone git://git.carbslinux.org/repository $HOME/repos/carbs -</pre></div> - -</li><li> Obtaining from rsync - - -<p>Carbs Linux rsync repositories live in rsync://carbslinux.org/repo. In -order to obtain it, run the following: -</p> -<div class="example"> -<pre class="example">rsync -avc rsync://carbslinux.org/repo $HOME/repos/carbs -</pre></div> - -</li><li> Making the package manager use the repositories - - -<p>In your shell’s configuration file, or in your ‘<samp>~/.profile</samp>’ file, add the -following lines: -</p> -<div class="example"> -<pre class="example">CPT_PATH=$HOME/repos/carbs/core -CPT_PATH=$CPT_PATH:$HOME/repos/carbs/extra -CPT_PATH=$CPT_PATH:$HOME/repos/carbs/xorg -CPT_PATH=$CPT_PATH:$HOME/repos/carbs/community -export CPT_PATH -</pre></div> -</li></ol> - - - - -</body> -</html> diff --git a/src/docs/Signature-verification.html b/src/docs/Signature-verification.html deleted file mode 100644 index 8dccbe3..0000000 --- a/src/docs/Signature-verification.html +++ /dev/null @@ -1,70 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> -<html> -<!-- Copyright (C) 2020 Cem Keylan - -Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.3 or -any later version published by the Free Software Foundation; with no -Invariant Sections, with no Front-Cover Texts and no Back-Cover Texts. -A copy of the license is included in the section entitled "GNU Free -Documentation License." - --> -<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> -<title>Signature verification (Carbs Linux User Manual)</title> - -<meta name="description" content="Signature verification (Carbs Linux User Manual)"> -<meta name="keywords" content="Signature verification (Carbs Linux User Manual)"> -<meta name="resource-type" content="document"> -<meta name="distribution" content="global"> -<meta name="Generator" content="makeinfo"> -<link href="index.html" rel="start" title="Top"> -<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents"> -<link href="Preparing-Environment.html" rel="up" title="Preparing Environment"> -<link href="Extracting-the-tarball.html" rel="next" title="Extracting the tarball"> -<link href="Download.html" rel="prev" title="Download"> -<style type="text/css"> -<!-- -a.summary-letter {text-decoration: none} -blockquote.indentedblock {margin-right: 0em} -div.display {margin-left: 3.2em} -div.example {margin-left: 3.2em} -div.lisp {margin-left: 3.2em} -kbd {font-style: oblique} -pre.display {font-family: inherit} -pre.format {font-family: inherit} -pre.menu-comment {font-family: serif} -pre.menu-preformatted {font-family: serif} -span.nolinebreak {white-space: nowrap} -span.roman {font-family: initial; font-weight: normal} -span.sansserif {font-family: sans-serif; font-weight: normal} -ul.no-bullet {list-style: none} ---> -</style> - - -</head> - -<body lang="en"> -<span id="Signature-verification"></span><div class="header"> -<p> -Next: <a href="Extracting-the-tarball.html" accesskey="n" rel="next">Extracting the tarball</a>, Previous: <a href="Download.html" accesskey="p" rel="prev">Download</a>, Up: <a href="Preparing-Environment.html" accesskey="u" rel="up">Preparing Environment</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> -</div> -<hr> -<span id="Signature-verification-1"></span><h4 class="subsection">1.1.2 Signature verification</h4> - -<p>It is highly recommended to verify the signature of the tarball. You will need -GPG for this. -</p> -<div class="example"> -<pre class="example">wget $URL/carbs-rootfs.tar.xz.sig -gpg --recv-keys FF484BDFEFCEF8FF -gpg --verify carbs-rootfs.tar.xz.sig -</pre></div> - - - - -</body> -</html> diff --git a/src/docs/Updating-packages.html b/src/docs/Updating-packages.html deleted file mode 100644 index 0c65553..0000000 --- a/src/docs/Updating-packages.html +++ /dev/null @@ -1,69 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> -<html> -<!-- Copyright (C) 2020 Cem Keylan - -Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.3 or -any later version published by the Free Software Foundation; with no -Invariant Sections, with no Front-Cover Texts and no Back-Cover Texts. -A copy of the license is included in the section entitled "GNU Free -Documentation License." - --> -<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> -<title>Updating packages (Carbs Linux User Manual)</title> - -<meta name="description" content="Updating packages (Carbs Linux User Manual)"> -<meta name="keywords" content="Updating packages (Carbs Linux User Manual)"> -<meta name="resource-type" content="document"> -<meta name="distribution" content="global"> -<meta name="Generator" content="makeinfo"> -<link href="index.html" rel="start" title="Top"> -<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents"> -<link href="Chroot.html" rel="up" title="Chroot"> -<link href="Installing-packages.html" rel="next" title="Installing packages"> -<link href="Setting-up-repositories.html" rel="prev" title="Setting up repositories"> -<style type="text/css"> -<!-- -a.summary-letter {text-decoration: none} -blockquote.indentedblock {margin-right: 0em} -div.display {margin-left: 3.2em} -div.example {margin-left: 3.2em} -div.lisp {margin-left: 3.2em} -kbd {font-style: oblique} -pre.display {font-family: inherit} -pre.format {font-family: inherit} -pre.menu-comment {font-family: serif} -pre.menu-preformatted {font-family: serif} -span.nolinebreak {white-space: nowrap} -span.roman {font-family: initial; font-weight: normal} -span.sansserif {font-family: sans-serif; font-weight: normal} -ul.no-bullet {list-style: none} ---> -</style> - - -</head> - -<body lang="en"> -<span id="Updating-packages"></span><div class="header"> -<p> -Next: <a href="Installing-packages.html" accesskey="n" rel="next">Installing packages</a>, Previous: <a href="Setting-up-repositories.html" accesskey="p" rel="prev">Setting up repositories</a>, Up: <a href="Chroot.html" accesskey="u" rel="up">Chroot</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> -</div> -<hr> -<span id="Updating-packages-1"></span><h4 class="subsection">1.2.2 Updating packages</h4> - -<p>It is good practice to make sure your system is up to date, especially before -building new packages. If there is an update for the package manager you will -need to update twice. -</p> -<div class="example"> -<pre class="example">cpt-update && cpt-update -</pre></div> - - - - -</body> -</html> diff --git a/src/docs/index.html b/src/docs/index.html deleted file mode 100644 index 68cef39..0000000 --- a/src/docs/index.html +++ /dev/null @@ -1,282 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> -<html> -<!-- Copyright (C) 2020 Cem Keylan - -Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.3 or -any later version published by the Free Software Foundation; with no -Invariant Sections, with no Front-Cover Texts and no Back-Cover Texts. -A copy of the license is included in the section entitled "GNU Free -Documentation License." - --> -<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> -<title>Top (Carbs Linux User Manual)</title> - -<meta name="description" content="Top (Carbs Linux User Manual)"> -<meta name="keywords" content="Top (Carbs Linux User Manual)"> -<meta name="resource-type" content="document"> -<meta name="distribution" content="global"> -<meta name="Generator" content="makeinfo"> -<link href="#Top" rel="start" title="Top"> -<link href="#SEC_Contents" rel="contents" title="Table of Contents"> -<link href="Installation.html" rel="next" title="Installation"> -<style type="text/css"> -<!-- -a.summary-letter {text-decoration: none} -blockquote.indentedblock {margin-right: 0em} -div.display {margin-left: 3.2em} -div.example {margin-left: 3.2em} -div.lisp {margin-left: 3.2em} -kbd {font-style: oblique} -pre.display {font-family: inherit} -pre.format {font-family: inherit} -pre.menu-comment {font-family: serif} -pre.menu-preformatted {font-family: serif} -span.nolinebreak {white-space: nowrap} -span.roman {font-family: initial; font-weight: normal} -span.sansserif {font-family: sans-serif; font-weight: normal} -ul.no-bullet {list-style: none} ---> -</style> - - -</head> - -<body lang="en"> -<h1 class="settitle" align="center">Carbs Linux User Manual</h1> - - - - -<span id="SEC_Contents"></span> -<h2 class="contents-heading">Table of Contents</h2> - -<div class="contents"> - -<ul class="no-bullet"> - <li><a id="toc-Installation-1" href="Installation.html#Installation">1 Installation</a> - <ul class="no-bullet"> - <li><a id="toc-Preparing-Environment-1" href="Preparing-Environment.html#Preparing-Environment">1.1 Preparing Environment</a> - <ul class="no-bullet"> - <li><a id="toc-Download-1" href="Download.html#Download">1.1.1 Download</a></li> - <li><a id="toc-Signature-verification-1" href="Signature-verification.html#Signature-verification">1.1.2 Signature verification</a></li> - <li><a id="toc-Extracting-the-tarball-1" href="Extracting-the-tarball.html#Extracting-the-tarball">1.1.3 Extracting the tarball</a></li> - <li><a id="toc-Obtain-the-chroot-helper-1" href="Obtain-the-chroot-helper.html#Obtain-the-chroot-helper">1.1.4 Obtain the chroot helper</a></li> - </ul></li> - <li><a id="toc-Chroot-1" href="Chroot.html#Chroot">1.2 Chroot</a> - <ul class="no-bullet"> - <li><a id="toc-Setting-up-repositories-1" href="Setting-up-repositories.html#Setting-up-repositories">1.2.1 Setting up repositories</a></li> - <li><a id="toc-Updating-packages-1" href="Updating-packages.html#Updating-packages">1.2.2 Updating packages</a></li> - <li><a id="toc-Installing-packages-1" href="Installing-packages.html#Installing-packages">1.2.3 Installing packages</a></li> - <li><a id="toc-Essential-Software-1" href="Essential-Software.html#Essential-Software">1.2.4 Essential Software</a></li> - <li><a id="toc-Obtaining-the-documentation-1" href="Obtaining-the-documentation.html#Obtaining-the-documentation">1.2.5 Obtaining the documentation</a></li> - </ul></li> - <li><a id="toc-System-Configuration-1" href="System-Configuration.html#System-Configuration">1.3 System Configuration</a> - <ul class="no-bullet"> - <li><a id="toc-Configuring-hostname-1" href="Configuring-hostname.html#Configuring-hostname">1.3.1 Configuring hostname</a></li> - <li><a id="toc-Hosts-file-1" href="Hosts-file.html#Hosts-file">1.3.2 Hosts file</a></li> - </ul></li> - <li><a id="toc-Kernel-1" href="Kernel.html#Kernel">1.4 Kernel</a> - <ul class="no-bullet"> - <li><a id="toc-Obtaining-the-kernel-sources-1" href="Obtaining-the-kernel-sources.html#Obtaining-the-kernel-sources">1.4.1 Obtaining the kernel sources</a></li> - <li><a id="toc-Kernel-dependencies-1" href="Kernel-dependencies.html#Kernel-dependencies">1.4.2 Kernel dependencies</a></li> - <li><a id="toc-Building-the-kernel-1" href="Building-the-kernel.html#Building-the-kernel">1.4.3 Building the kernel</a></li> - </ul></li> - <li><a id="toc-Making-your-system-bootable-1" href="Making-your-system-bootable.html#Making-your-system-bootable">1.5 Making your system bootable</a> - <ul class="no-bullet"> - <li><a id="toc-Bootloader-1" href="Bootloader.html#Bootloader">1.5.1 Bootloader</a></li> - <li><a id="toc-Init-scripts-1" href="Init-scripts.html#Init-scripts">1.5.2 Init scripts</a></li> - <li><a id="toc-Fstab-1" href="Fstab.html#Fstab">1.5.3 Fstab</a></li> - </ul></li> - <li><a id="toc-Post_002dinstallation-1" href="Post_002dinstallation.html#Post_002dinstallation">1.6 Post-installation</a> - <ul class="no-bullet"> - <li><a id="toc-KISS-repositories-1" href="KISS-repositories.html#KISS-repositories">1.6.1 KISS repositories</a></li> - </ul></li> - </ul></li> - <li><a id="toc-Init-System-1" href="Init-System.html#Init-System">2 Init System</a> - <ul class="no-bullet"> - <li><a id="toc-Configuring-Init-1" href="Configuring-Init.html#Configuring-Init">2.1 Configuring Init</a> - <ul class="no-bullet"> - <li><a id="toc-Kernel-Command-Line-1" href="Kernel-Command-Line.html#Kernel-Command-Line">2.1.1 Kernel Command Line</a></li> - <li><a id="toc-_002fetc_002finit_002frc_002econf-file" href="_002fetc_002finit_002frcconf-file.html#g_t_002fetc_002finit_002frcconf-file">2.1.2 ‘<samp>/etc/init/rc.conf</samp>’ file</a></li> - <li><a id="toc-Init-Hooks-1" href="Init-Hooks.html#Init-Hooks">2.1.3 Init Hooks</a></li> - </ul></li> - <li><a id="toc-Changing-Init-Program-1" href="Changing-Init-Program.html#Changing-Init-Program">2.2 Changing Init Program</a> - <ul class="no-bullet"> - <li><a id="toc-Rebooting-after-changing-init-1" href="Rebooting-after-changing-init.html#Rebooting-after-changing-init">2.2.1 Rebooting after changing init</a></li> - </ul></li> - </ul></li> - <li><a id="toc-Contribution-Guidelines-1" href="Contribution-Guidelines.html#Contribution-Guidelines">3 Contribution Guidelines</a> - <ul class="no-bullet"> - <li><a id="toc-Conventions-1" href="Conventions.html#Conventions">3.1 Conventions</a> - <ul class="no-bullet"> - <li><a id="toc-Shell-Conventions-1" href="Shell-Conventions.html#Shell-Conventions">3.1.1 Shell Conventions</a></li> - <li><a id="toc-Repository-Conventions-1" href="Repository-Conventions.html#Repository-Conventions">3.1.2 Repository Conventions</a></li> - </ul></li> - </ul></li> - <li><a id="toc-GNU-Free-Documentation-License-1" href="GNU-Free-Documentation-License.html#GNU-Free-Documentation-License">Appendix A GNU Free Documentation License</a> - <ul class="no-bullet"> - <li><a id="toc-ADDENDUM_003a-How-to-use-this-License-for-your-documents" href="GNU-Free-Documentation-License.html#ADDENDUM_003a-How-to-use-this-License-for-your-documents">A.1 ADDENDUM: How to use this License for your documents</a></li> - </ul></li> -</ul> -</div> - - -<span id="Top"></span><div class="header"> -<p> -Next: <a href="Installation.html" accesskey="n" rel="next">Installation</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> -</div> -<hr> -<span id="Carbs-Linux-User-Manual"></span><h1 class="top">Carbs Linux User Manual</h1> - -<p>This is the full documentation of <a href="https://carbslinux.org">Carbs Linux</a>, from the details of the -distribution, installation, to the package manager. It is not yet complete. -</p> - -<p>This documentation is also available in the distribution by the -<code>carbs-docs</code> package, which can be read by either running -<code>info carbslinux</code> or reading <samp>/usr/share/doc/carbslinux.txt</samp> with your -favorite pager. You can install either the <code>info</code> or <code>texinfo</code> -for doing the first. -</p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="Installation.html" accesskey="1">Installation</a></td><td> </td><td align="left" valign="top">Installing Carbs Linux -</td></tr> -<tr><td align="left" valign="top">• <a href="Init-System.html" accesskey="2">Init System</a></td><td> </td><td align="left" valign="top">Configure the init system -</td></tr> -<tr><td align="left" valign="top">• <a href="Contribution-Guidelines.html" accesskey="3">Contribution Guidelines</a></td><td> </td><td align="left" valign="top">Contribute to Carbs Linux -</td></tr> -<tr><td align="left" valign="top">• <a href="GNU-Free-Documentation-License.html" accesskey="4">GNU Free Documentation License</a></td><td> </td><td align="left" valign="top">Your rights -</td></tr> -<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> - -</pre></th></tr><tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">— The Detailed Node Listing — - -Installation - -</pre></th></tr><tr><td align="left" valign="top">• <a href="Preparing-Environment.html" accesskey="5">Preparing Environment</a></td><td> </td><td align="left" valign="top">Getting ready to chroot -</td></tr> -<tr><td align="left" valign="top">• <a href="Chroot.html" accesskey="6">Chroot</a></td><td> </td><td align="left" valign="top">Going inside your new system -</td></tr> -<tr><td align="left" valign="top">• <a href="System-Configuration.html" accesskey="7">System Configuration</a></td><td> </td><td align="left" valign="top">Customizing your system for personal use -</td></tr> -<tr><td align="left" valign="top">• <a href="Kernel.html" accesskey="8">Kernel</a></td><td> </td><td align="left" valign="top">Compiling your own kernel -</td></tr> -<tr><td align="left" valign="top">• <a href="Making-your-system-bootable.html" accesskey="9">Making your system bootable</a></td><td> </td><td align="left" valign="top">Installing bootloader and boot scripts -</td></tr> -<tr><td align="left" valign="top">• <a href="Post_002dinstallation.html">Post-installation</a></td><td> </td><td align="left" valign="top">Post-installation tasks -</td></tr> -<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> - -Preparing Environment - -</pre></th></tr><tr><td align="left" valign="top">• <a href="Download.html">Download</a></td><td> </td><td align="left" valign="top">Download the root filesystem tarball -</td></tr> -<tr><td align="left" valign="top">• <a href="Signature-verification.html">Signature verification</a></td><td> </td><td align="left" valign="top">Verify the signature of the rootfs tarball -</td></tr> -<tr><td align="left" valign="top">• <a href="Extracting-the-tarball.html">Extracting the tarball</a></td><td> </td><td align="left" valign="top">Extracting the root filesystem to the desired location -</td></tr> -<tr><td align="left" valign="top">• <a href="Obtain-the-chroot-helper.html">Obtain the chroot helper</a></td><td> </td><td align="left" valign="top">Download the script to easily chroot into the new filesystem -</td></tr> -<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> - -Chroot - -</pre></th></tr><tr><td align="left" valign="top">• <a href="Setting-up-repositories.html">Setting up repositories</a></td><td> </td><td align="left" valign="top">Basic setup for obtaining repositories -</td></tr> -<tr><td align="left" valign="top">• <a href="Updating-packages.html">Updating packages</a></td><td> </td><td align="left" valign="top">Update your system -</td></tr> -<tr><td align="left" valign="top">• <a href="Installing-packages.html">Installing packages</a></td><td> </td><td align="left" valign="top">Install new software on your system -</td></tr> -<tr><td align="left" valign="top">• <a href="Essential-Software.html">Essential Software</a></td><td> </td><td align="left" valign="top">Software you might want to include on your system -</td></tr> -<tr><td align="left" valign="top">• <a href="Obtaining-the-documentation.html">Obtaining the documentation</a></td><td> </td><td align="left" valign="top">Install documentation for offline use (optional) -</td></tr> -<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> - -System Configuration - -</pre></th></tr><tr><td align="left" valign="top">• <a href="Configuring-hostname.html">Configuring hostname</a></td><td> </td><td align="left" valign="top">Setting up system hostname (recommended) -</td></tr> -<tr><td align="left" valign="top">• <a href="Hosts-file.html">Hosts file</a></td><td> </td><td align="left" valign="top">Setting up hosts file for networking (optional) -</td></tr> -<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> - -Kernel - -</pre></th></tr><tr><td align="left" valign="top">• <a href="Obtaining-the-kernel-sources.html">Obtaining the kernel sources</a></td><td> </td><td align="left" valign="top">Downloading the Linux source code -</td></tr> -<tr><td align="left" valign="top">• <a href="Kernel-dependencies.html">Kernel dependencies</a></td><td> </td><td align="left" valign="top">Requirements for building the kernel -</td></tr> -<tr><td align="left" valign="top">• <a href="Building-the-kernel.html">Building the kernel</a></td><td> </td><td align="left" valign="top">Configure and compile the kernel -</td></tr> -<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> - -Making your system bootable - -</pre></th></tr><tr><td align="left" valign="top">• <a href="Bootloader.html">Bootloader</a></td><td> </td><td align="left" valign="top">Install a bootloader for your system -</td></tr> -<tr><td align="left" valign="top">• <a href="Init-scripts.html">Init scripts</a></td><td> </td><td align="left" valign="top">Install init scripts for your system -</td></tr> -<tr><td align="left" valign="top">• <a href="Fstab.html">Fstab</a></td><td> </td><td align="left" valign="top">Generating fstab -</td></tr> -<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> - -Post-installation - -</pre></th></tr><tr><td align="left" valign="top">• <a href="KISS-repositories.html">KISS repositories</a></td><td> </td><td align="left" valign="top">Acquire kiss repositories -</td></tr> -<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> - -Init System - -</pre></th></tr><tr><td align="left" valign="top">• <a href="Configuring-Init.html">Configuring Init</a></td><td> </td><td align="left" valign="top">Ways to configure the init system -</td></tr> -<tr><td align="left" valign="top">• <a href="Changing-Init-Program.html">Changing Init Program</a></td><td> </td><td align="left" valign="top">Replace the default busybox init with something new -</td></tr> -<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> - -Configuring Init - -</pre></th></tr><tr><td align="left" valign="top">• <a href="Kernel-Command-Line.html">Kernel Command Line</a></td><td> </td><td align="left" valign="top">Configure init through the boot parameters -</td></tr> -<tr><td align="left" valign="top">• <a href="_002fetc_002finit_002frcconf-file.html">‘<samp>/etc/init/rc.conf</samp>’ file</a></td><td> </td><td align="left" valign="top">Configure init through the configuration file -</td></tr> -<tr><td align="left" valign="top">• <a href="Init-Hooks.html">Init Hooks</a></td><td> </td><td align="left" valign="top">Configure init through hooks -</td></tr> -<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> - -Changing Init Program - -</pre></th></tr><tr><td align="left" valign="top">• <a href="Rebooting-after-changing-init.html">Rebooting after changing init</a></td><td> </td><td align="left" valign="top">Ways to reboot after replacing the init system -</td></tr> -<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> - -Contribution Guidelines - -</pre></th></tr><tr><td align="left" valign="top">• <a href="Conventions.html">Conventions</a></td><td> </td><td align="left" valign="top">Conventions of the distribution -</td></tr> -<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> - -Conventions - -</pre></th></tr><tr><td align="left" valign="top">• <a href="Shell-Conventions.html">Shell Conventions</a></td><td> </td><td align="left" valign="top">Conventions for shell scripts -</td></tr> -<tr><td align="left" valign="top">• <a href="Repository-Conventions.html">Repository Conventions</a></td><td> </td><td align="left" valign="top">Conventions for repository build scripts -</td></tr> -<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> - -</pre></th></tr></table> - -<hr> -<div class="header"> -<p> -Next: <a href="Installation.html" accesskey="n" rel="next">Installation</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> -</div> - - - -</body> -</html> diff --git a/src/docs/install.html b/src/docs/install.html deleted file mode 100644 index 176aacd..0000000 --- a/src/docs/install.html +++ /dev/null @@ -1,822 +0,0 @@ -<?xml version="1.0" encoding="utf-8"?> -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" -"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> -<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"> -<head> -<!-- 2020-12-26 Sat 03:17 --> -<meta http-equiv="Content-Type" content="text/html;charset=utf-8" /> -<meta name="viewport" content="width=device-width, initial-scale=1" /> -<title>Carbs Linux Installation Guide</title> -<meta name="generator" content="Org mode" /> -<meta name="author" content="Cem Keylan" /> -<style type="text/css"> - <!--/*--><![CDATA[/*><!--*/ - .title { text-align: center; - margin-bottom: .2em; } - .subtitle { text-align: center; - font-size: medium; - font-weight: bold; - margin-top:0; } - .todo { font-family: monospace; color: red; } - .done { font-family: monospace; color: green; } - .priority { font-family: monospace; color: orange; } - .tag { background-color: #eee; font-family: monospace; - padding: 2px; font-size: 80%; font-weight: normal; } - .timestamp { color: #bebebe; } - .timestamp-kwd { color: #5f9ea0; } - .org-right { margin-left: auto; margin-right: 0px; text-align: right; } - .org-left { margin-left: 0px; margin-right: auto; text-align: left; } - .org-center { margin-left: auto; margin-right: auto; text-align: center; } - .underline { text-decoration: underline; } - #postamble p, #preamble p { font-size: 90%; margin: .2em; } - p.verse { margin-left: 3%; } - pre { - border: 1px solid #ccc; - box-shadow: 3px 3px 3px #eee; - padding: 8pt; - font-family: monospace; - overflow: auto; - margin: 1.2em; - } - pre.src { - position: relative; - overflow: visible; - padding-top: 1.2em; - } - pre.src:before { - display: none; - position: absolute; - background-color: white; - top: -10px; - right: 10px; - padding: 3px; - border: 1px solid black; - } - pre.src:hover:before { display: inline;} - /* Languages per Org manual */ - pre.src-asymptote:before { content: 'Asymptote'; } - pre.src-awk:before { content: 'Awk'; } - pre.src-C:before { content: 'C'; } - /* pre.src-C++ doesn't work in CSS */ - pre.src-clojure:before { content: 'Clojure'; } - pre.src-css:before { content: 'CSS'; } - pre.src-D:before { content: 'D'; } - pre.src-ditaa:before { content: 'ditaa'; } - pre.src-dot:before { content: 'Graphviz'; } - pre.src-calc:before { content: 'Emacs Calc'; } - pre.src-emacs-lisp:before { content: 'Emacs Lisp'; } - pre.src-fortran:before { content: 'Fortran'; } - pre.src-gnuplot:before { content: 'gnuplot'; } - pre.src-haskell:before { content: 'Haskell'; } - pre.src-hledger:before { content: 'hledger'; } - pre.src-java:before { content: 'Java'; } - pre.src-js:before { content: 'Javascript'; } - pre.src-latex:before { content: 'LaTeX'; } - pre.src-ledger:before { content: 'Ledger'; } - pre.src-lisp:before { content: 'Lisp'; } - pre.src-lilypond:before { content: 'Lilypond'; } - pre.src-lua:before { content: 'Lua'; } - pre.src-matlab:before { content: 'MATLAB'; } - pre.src-mscgen:before { content: 'Mscgen'; } - pre.src-ocaml:before { content: 'Objective Caml'; } - pre.src-octave:before { content: 'Octave'; } - pre.src-org:before { content: 'Org mode'; } - pre.src-oz:before { content: 'OZ'; } - pre.src-plantuml:before { content: 'Plantuml'; } - pre.src-processing:before { content: 'Processing.js'; } - pre.src-python:before { content: 'Python'; } - pre.src-R:before { content: 'R'; } - pre.src-ruby:before { content: 'Ruby'; } - pre.src-sass:before { content: 'Sass'; } - pre.src-scheme:before { content: 'Scheme'; } - pre.src-screen:before { content: 'Gnu Screen'; } - pre.src-sed:before { content: 'Sed'; } - pre.src-sh:before { content: 'shell'; } - pre.src-sql:before { content: 'SQL'; } - pre.src-sqlite:before { content: 'SQLite'; } - /* additional languages in org.el's org-babel-load-languages alist */ - pre.src-forth:before { content: 'Forth'; } - pre.src-io:before { content: 'IO'; } - pre.src-J:before { content: 'J'; } - pre.src-makefile:before { content: 'Makefile'; } - pre.src-maxima:before { content: 'Maxima'; } - pre.src-perl:before { content: 'Perl'; } - pre.src-picolisp:before { content: 'Pico Lisp'; } - pre.src-scala:before { content: 'Scala'; } - pre.src-shell:before { content: 'Shell Script'; } - pre.src-ebnf2ps:before { content: 'ebfn2ps'; } - /* additional language identifiers per "defun org-babel-execute" - in ob-*.el */ - pre.src-cpp:before { content: 'C++'; } - pre.src-abc:before { content: 'ABC'; } - pre.src-coq:before { content: 'Coq'; } - pre.src-groovy:before { content: 'Groovy'; } - /* additional language identifiers from org-babel-shell-names in - ob-shell.el: ob-shell is the only babel language using a lambda to put - the execution function name together. */ - pre.src-bash:before { content: 'bash'; } - pre.src-csh:before { content: 'csh'; } - pre.src-ash:before { content: 'ash'; } - pre.src-dash:before { content: 'dash'; } - pre.src-ksh:before { content: 'ksh'; } - pre.src-mksh:before { content: 'mksh'; } - pre.src-posh:before { content: 'posh'; } - /* Additional Emacs modes also supported by the LaTeX listings package */ - pre.src-ada:before { content: 'Ada'; } - pre.src-asm:before { content: 'Assembler'; } - pre.src-caml:before { content: 'Caml'; } - pre.src-delphi:before { content: 'Delphi'; } - pre.src-html:before { content: 'HTML'; } - pre.src-idl:before { content: 'IDL'; } - pre.src-mercury:before { content: 'Mercury'; } - pre.src-metapost:before { content: 'MetaPost'; } - pre.src-modula-2:before { content: 'Modula-2'; } - pre.src-pascal:before { content: 'Pascal'; } - pre.src-ps:before { content: 'PostScript'; } - pre.src-prolog:before { content: 'Prolog'; } - pre.src-simula:before { content: 'Simula'; } - pre.src-tcl:before { content: 'tcl'; } - pre.src-tex:before { content: 'TeX'; } - pre.src-plain-tex:before { content: 'Plain TeX'; } - pre.src-verilog:before { content: 'Verilog'; } - pre.src-vhdl:before { content: 'VHDL'; } - pre.src-xml:before { content: 'XML'; } - pre.src-nxml:before { content: 'XML'; } - /* add a generic configuration mode; LaTeX export needs an additional - (add-to-list 'org-latex-listings-langs '(conf " ")) in .emacs */ - pre.src-conf:before { content: 'Configuration File'; } - - table { border-collapse:collapse; } - caption.t-above { caption-side: top; } - caption.t-bottom { caption-side: bottom; } - td, th { vertical-align:top; } - th.org-right { text-align: center; } - th.org-left { text-align: center; } - th.org-center { text-align: center; } - td.org-right { text-align: right; } - td.org-left { text-align: left; } - td.org-center { text-align: center; } - dt { font-weight: bold; } - .footpara { display: inline; } - .footdef { margin-bottom: 1em; } - .figure { padding: 1em; } - .figure p { text-align: center; } - .equation-container { - display: table; - text-align: center; - width: 100%; - } - .equation { - vertical-align: middle; - } - .equation-label { - display: table-cell; - text-align: right; - vertical-align: middle; - } - .inlinetask { - padding: 10px; - border: 2px solid gray; - margin: 10px; - background: #ffffcc; - } - #org-div-home-and-up - { text-align: right; font-size: 70%; white-space: nowrap; } - textarea { overflow-x: auto; } - .linenr { font-size: smaller } - .code-highlighted { background-color: #ffff00; } - .org-info-js_info-navigation { border-style: none; } - #org-info-js_console-label - { font-size: 10px; font-weight: bold; white-space: nowrap; } - .org-info-js_search-highlight - { background-color: #ffff00; color: #000000; font-weight: bold; } - .org-svg { width: 90%; } - /*]]>*/--> -</style> -</head> -<body> -<div id="content"> -<h1 class="title">Carbs Linux Installation Guide</h1> -<div id="table-of-contents"> -<h2>Table of Contents</h2> -<div id="text-table-of-contents"> -<ul> -<li><a href="#orgf69e554">1. Preparing Environment</a> -<ul> -<li><a href="#org95a0e69">1.1. Download</a></li> -<li><a href="#org8e36ac6">1.2. Signature verification</a></li> -<li><a href="#orgea2754a">1.3. Extracting the tarball</a></li> -<li><a href="#org04cd78e">1.4. Obtain the chroot helper</a></li> -</ul> -</li> -<li><a href="#org75ac2b4">2. Chroot</a> -<ul> -<li><a href="#org8778be8">2.1. Setting up repositories</a> -<ul> -<li><a href="#orga965761">2.1.1. Obtaining from git</a></li> -<li><a href="#orgb7bea54">2.1.2. Obtaining from rsync</a></li> -<li><a href="#orgb72886d">2.1.3. Making the package manager use the repositories</a></li> -</ul> -</li> -<li><a href="#org2a9ee98">2.2. Updating packages</a></li> -<li><a href="#orgf04d2d5">2.3. Installing packages</a></li> -<li><a href="#orgb80a3a8">2.4. Essential Software</a></li> -<li><a href="#org1e0d5e0">2.5. Obtaining the documentation</a></li> -</ul> -</li> -<li><a href="#orgd61a283">3. System Configuration</a> -<ul> -<li><a href="#orgc097724">3.1. Configuring hostname</a></li> -<li><a href="#org88a7ef3">3.2. Hosts file</a></li> -</ul> -</li> -<li><a href="#org92806b4">4. Kernel</a> -<ul> -<li><a href="#orgb246a4d">4.1. Obtaining the kernel sources</a></li> -<li><a href="#orgf9a076f">4.2. Kernel dependencies</a></li> -<li><a href="#orga3c74bc">4.3. Building the kernel</a></li> -</ul> -</li> -<li><a href="#orgb176eb1">5. Making your system bootable</a> -<ul> -<li><a href="#org31a5fde">5.1. Bootloader</a> -<ul> -<li><a href="#org43ed898">5.1.1. GRUB BIOS installation</a></li> -<li><a href="#orgf826efe">5.1.2. GRUB UEFI installation</a></li> -</ul> -</li> -<li><a href="#org2d43b5f">5.2. Init scripts</a></li> -<li><a href="#orgfe8161b">5.3. Fstab</a></li> -</ul> -</li> -<li><a href="#org917e2c8">6. Post-installation</a> -<ul> -<li><a href="#org96641ac">6.1. KISS repositories</a></li> -</ul> -</li> -</ul> -</div> -</div> -<p> -These are the step-by-step instructions for installing Carbs Linux. It can be -acquired as plain-text to be viewed offline with a pager from -<a href="https://carbslinux.org/docs/install.txt">https://carbslinux.org/docs/install.txt</a>. -</p> - -<div id="outline-container-orgf69e554" class="outline-2"> -<h2 id="orgf69e554"><span class="section-number-2">1</span> Preparing Environment</h2> -<div class="outline-text-2" id="text-1"> -<p> -To install Carbs Linux, you will need a Live Linux ISO. For that purpose, you -can obtain a Gentoo or Void Linux live image. You can follow their instructions -to boot and setup your network. -</p> - -<p> -You will need the following programs in order to install Carbs Linux: -</p> - -<ul class="org-ul"> -<li>tar</li> -<li>wget</li> -<li>xz</li> -<li>some form of base utilities (coreutils, sbase, busybox, etc.)</li> -</ul> - -<p> -Rest of these instructions will assume that you have set all of these up, and -will continue on that point. -</p> -</div> - -<div id="outline-container-org95a0e69" class="outline-3"> -<h3 id="org95a0e69"><span class="section-number-3">1.1</span> Download</h3> -<div class="outline-text-3" id="text-1-1"> -<p> -First, we need to download the rootfs tarball. You can do the following in order -to obtain the rootfs. If you are using an i686 machine, replace the <code>x86_64</code> -with <code>i686</code>. We are setting this in a URL variable so that we don't have to -write it every time. -</p> - -<div class="org-src-container"> -<pre class="src src-sh">wget $<span style="color: #8e44ad;">URL</span>/carbs-rootfs.tar.xz.sha256 -sha256sum -c carbs-rootfs.tar.xz.sha256 -</pre> -</div> -</div> -</div> - -<div id="outline-container-org8e36ac6" class="outline-3"> -<h3 id="org8e36ac6"><span class="section-number-3">1.2</span> Signature verification</h3> -<div class="outline-text-3" id="text-1-2"> -<p> -It is highly recommended to verify the signature of the tarball. You will need -GPG for this. -</p> - -<div class="org-src-container"> -<pre class="src src-sh">wget $<span style="color: #8e44ad;">URL</span>/carbs-rootfs.tar.xz.sig -gpg --recv-keys FF484BDFEFCEF8FF -gpg --verify carbs-rootfs.tar.xz.sig -</pre> -</div> -</div> -</div> - -<div id="outline-container-orgea2754a" class="outline-3"> -<h3 id="orgea2754a"><span class="section-number-3">1.3</span> Extracting the tarball</h3> -<div class="outline-text-3" id="text-1-3"> -<p> -You will need to extract the tarball to your desired location. For partitioning, -you can follow <a href="https://wiki.archlinux.org/index.php/Partitioning">this guide</a>. This will assume that you will be mounting your root -partition to <code>/mnt</code>. -</p> - -<div class="org-src-container"> -<pre class="src src-sh">mount /dev/sdx1 /mnt -tar xf carbs-rootfs.tar.xz -C /mnt -</pre> -</div> -</div> -</div> - -<div id="outline-container-org04cd78e" class="outline-3"> -<h3 id="org04cd78e"><span class="section-number-3">1.4</span> Obtain the chroot helper</h3> -<div class="outline-text-3" id="text-1-4"> -<p> -You can obtain the <code>cpt-chroot</code> script in order to do a simple chroot into your -new root filesystem. -</p> - -<div class="org-src-container"> -<pre class="src src-sh">wget https://dl.carbslinux.org/distfiles/cpt-chroot -chmod a+x cpt-chroot -</pre> -</div> -</div> -</div> -</div> - -<div id="outline-container-org75ac2b4" class="outline-2"> -<h2 id="org75ac2b4"><span class="section-number-2">2</span> Chroot</h2> -<div class="outline-text-2" id="text-2"> -<p> -Chroot into Carbs Linux! -</p> - -<div class="org-src-container"> -<pre class="src src-sh">./cpt-chroot /mnt -</pre> -</div> -</div> - -<div id="outline-container-org8778be8" class="outline-3"> -<h3 id="org8778be8"><span class="section-number-3">2.1</span> Setting up repositories</h3> -<div class="outline-text-3" id="text-2-1"> -<p> -Newest tarballs do not come with repositories, so you will need to manually -obtain them, and set your <code>CPT_PATH</code> environment variable. Carbs Linux -repositories can either be obtained by <code>git</code> or <code>rsync</code>. While rsync -repositories are overall faster and smaller, git offers the whole history of the -repository and a means to manipulate your repository as you like it. If you want -to obtain the git repository, you will need to install <code>git</code> itself. -</p> - -<p> -The following guide will assume that you put the repositories into <code>~/repos/</code> -directory, but you can put the repositories into any directory you want. So go -ahead and create that directory: -</p> - -<div class="org-src-container"> -<pre class="src src-sh">mkdir -p $<span style="color: #8e44ad;">HOME</span>/repos -</pre> -</div> -</div> - -<div id="outline-container-orga965761" class="outline-4"> -<h4 id="orga965761"><span class="section-number-4">2.1.1</span> Obtaining from git</h4> -<div class="outline-text-4" id="text-2-1-1"> -<p> -Carbs Linux git repositories can be found both from the main server and GitHub -(mirror). Here are both their repository links. You can clone any of them. -</p> - -<ul class="org-ul"> -<li>git://git.carbslinux.org/repository</li> -<li><a href="https://github.com/carbslinux/repository">https://github.com/carbslinux/repository</a></li> -</ul> - -<div class="org-src-container"> -<pre class="src src-sh">git clone git://git.carbslinux.org/repository $<span style="color: #8e44ad;">HOME</span>/repos/carbs -</pre> -</div> -</div> -</div> - -<div id="outline-container-orgb7bea54" class="outline-4"> -<h4 id="orgb7bea54"><span class="section-number-4">2.1.2</span> Obtaining from rsync</h4> -<div class="outline-text-4" id="text-2-1-2"> -<p> -Carbs Linux rsync repositories live in rsync://carbslinux.org/repo. In -order to obtain it, run the following: -</p> - -<div class="org-src-container"> -<pre class="src src-sh">rsync -avc rsync://carbslinux.org/repo $<span style="color: #8e44ad;">HOME</span>/repos/carbs -</pre> -</div> -</div> -</div> - -<div id="outline-container-orgb72886d" class="outline-4"> -<h4 id="orgb72886d"><span class="section-number-4">2.1.3</span> Making the package manager use the repositories</h4> -<div class="outline-text-4" id="text-2-1-3"> -<p> -In your shell's configuration file, or in your <code>~/.profile</code> file, add the -following lines: -</p> - -<div class="org-src-container"> -<pre class="src src-sh"><span style="color: #8e44ad;">CPT_PATH</span>=$<span style="color: #8e44ad;">HOME</span>/repos/carbs/core -<span style="color: #8e44ad;">CPT_PATH</span>=$<span style="color: #8e44ad;">CPT_PATH</span>:$<span style="color: #8e44ad;">HOME</span>/repos/carbs/extra -<span style="color: #8e44ad;">CPT_PATH</span>=$<span style="color: #8e44ad;">CPT_PATH</span>:$<span style="color: #8e44ad;">HOME</span>/repos/carbs/xorg -<span style="color: #8e44ad;">CPT_PATH</span>=$<span style="color: #8e44ad;">CPT_PATH</span>:$<span style="color: #8e44ad;">HOME</span>/repos/carbs/community -<span style="color: #16a085;">export</span> CPT_PATH -</pre> -</div> -</div> -</div> -</div> - -<div id="outline-container-org2a9ee98" class="outline-3"> -<h3 id="org2a9ee98"><span class="section-number-3">2.2</span> Updating packages</h3> -<div class="outline-text-3" id="text-2-2"> -<p> -It is good practice to make sure your system is up to date, especially before -building new packages. If there is an update for the package manager you will -need to update twice. -</p> - -<div class="org-src-container"> -<pre class="src src-sh">cpt-update && cpt-update -</pre> -</div> -</div> -</div> - -<div id="outline-container-orgf04d2d5" class="outline-3"> -<h3 id="orgf04d2d5"><span class="section-number-3">2.3</span> Installing packages</h3> -<div class="outline-text-3" id="text-2-3"> -<p> -Since you are operating on a really small base, you might need to build and -install new programs to extend the functionality of your system. In order to -build and install packages new packages in Carbs, you need to execute the -following. "Package" is not actually a package and is given as an example. -</p> - -<div class="org-src-container"> -<pre class="src src-sh">cpt-build package -cpt-install package -</pre> -</div> -</div> -</div> - -<div id="outline-container-orgb80a3a8" class="outline-3"> -<h3 id="orgb80a3a8"><span class="section-number-3">2.4</span> Essential Software</h3> -<div class="outline-text-3" id="text-2-4"> -<p> -Here is a list of software that you might want to have on your system. -</p> - -<p> -<b>BOOTLOADERS</b> -</p> - -<ul class="org-ul"> -<li>efibootmgr</li> -<li>grub</li> -</ul> - -<p> -<b>FILESYSTEMS</b> -</p> - -<ul class="org-ul"> -<li>e2fsprogs</li> -<li>dosfstools</li> -<li>ntfs-3g</li> -</ul> - -<p> -<b>NETWORKING</b> -</p> - -<ul class="org-ul"> -<li>dhcpcd</li> -<li>wpa<sub>supplicant</sub></li> -</ul> - -<p> -<b>TEXT EDITORS</b> -</p> - -<ul class="org-ul"> -<li>nano</li> -<li>vim</li> -<li>neatvi</li> -<li>emacs</li> -<li>emacs-nox (terminal-only version of emacs)</li> -</ul> - -<p> -<b>USER SHELLS</b> -</p> - -<ul class="org-ul"> -<li>bash</li> -<li>zsh</li> -<li>oksh</li> -<li>rc</li> -</ul> - -<p> -<b>POSIX BASE UTILITIES</b> -</p> - -<ul class="org-ul"> -<li>busybox</li> -<li>sbase</li> -<li>coreutils</li> -</ul> - -<p> -<b>DOCUMENTATION</b> -</p> - -<ul class="org-ul"> -<li>carbs-docs</li> -<li>man-pages</li> -<li>man-pages-posix</li> -</ul> -</div> -</div> - -<div id="outline-container-org1e0d5e0" class="outline-3"> -<h3 id="org1e0d5e0"><span class="section-number-3">2.5</span> Obtaining the documentation</h3> -<div class="outline-text-3" id="text-2-5"> -<p> -All the documentation for Carbs Linux can be found on a single info manual to be -viewed offline. You can obtain texinfo or the info (standalone) package in order -to view the documentation. -</p> - -<div class="org-src-container"> -<pre class="src src-sh"><span style="color: #95a5a6;"># </span><span style="color: #7f8c8d;">Install the documentation.</span> -cpt b carbs-docs && cpt i carbs-docs - -<span style="color: #95a5a6;"># </span><span style="color: #7f8c8d;">Install either texinfo or the info package. We will be installing standalone info</span> -<span style="color: #95a5a6;"># </span><span style="color: #7f8c8d;">as it doesn't need perl.</span> -cpt b info && cpt i info - -<span style="color: #95a5a6;"># </span><span style="color: #7f8c8d;">You can then run info and navigate through the documentation.</span> -info carbslinux -</pre> -</div> -</div> -</div> -</div> - -<div id="outline-container-orgd61a283" class="outline-2"> -<h2 id="orgd61a283"><span class="section-number-2">3</span> System Configuration</h2> -<div class="outline-text-2" id="text-3"> -<p> -After you have finished installing some extra packages, you can configure your -system to your liking. -</p> -</div> - -<div id="outline-container-orgc097724" class="outline-3"> -<h3 id="orgc097724"><span class="section-number-3">3.1</span> Configuring hostname</h3> -<div class="outline-text-3" id="text-3-1"> -<p> -You might want to add a hostname, especially in a networked environment. Your -hostname will default to 'carbslinux' unless you set this. -</p> - -<div class="org-src-container"> -<pre class="src src-sh"><span style="color: #16a085;">echo</span> your-hostname > /etc/hostname -</pre> -</div> -</div> -</div> - -<div id="outline-container-org88a7ef3" class="outline-3"> -<h3 id="org88a7ef3"><span class="section-number-3">3.2</span> Hosts file</h3> -<div class="outline-text-3" id="text-3-2"> -<p> -You can edit your /etc/hosts file, which is the static lookup table for host -names. By default, there are two entries for localhost which are OKAY. You can -replace the 'localhost' part of these entries to your hostname. -</p> - -<pre class="example"> -127.0.0.1 localhost.localdomain localhost -::1 localhost.localdomain localhost ip6-localhost -</pre> -</div> -</div> -</div> - -<div id="outline-container-org92806b4" class="outline-2"> -<h2 id="org92806b4"><span class="section-number-2">4</span> Kernel</h2> -<div class="outline-text-2" id="text-4"> -<p> -Kernel isn't managed under the main repositories, even though you could package -one for your personal use. Here is an <a href="https://github.com/cemkeylan/kiss-repository/tree/master/personal/linux">example kernel package</a>, which you will -need to reconfigure for your specific setup if you want to make use of it. -</p> -</div> - -<div id="outline-container-orgb246a4d" class="outline-3"> -<h3 id="orgb246a4d"><span class="section-number-3">4.1</span> Obtaining the kernel sources</h3> -<div class="outline-text-3" id="text-4-1"> -<p> -You can visit the <a href="https://kernel.org">https://kernel.org</a> website to choose a kernel that you want -to install. Though only the latest stable and longterm (LTS) versions are -supported. -</p> - -<div class="org-src-container"> -<pre class="src src-sh"><span style="color: #95a5a6;"># </span><span style="color: #7f8c8d;">Download the kernel and extract it</span> -wget https://cdn.kernel.org/pub/linux/kernel/v5.x/linux-5.9.1.tar.xz -tar xf linux-5.9.1.tar.xz - -<span style="color: #95a5a6;"># </span><span style="color: #7f8c8d;">Change directory into the kernel sources</span> -<span style="color: #16a085;">cd</span> linux-5.9.1 -</pre> -</div> -</div> -</div> - -<div id="outline-container-orgf9a076f" class="outline-3"> -<h3 id="orgf9a076f"><span class="section-number-3">4.2</span> Kernel dependencies</h3> -<div class="outline-text-3" id="text-4-2"> -<p> -In order to compile the kernel you will need to install some dependencies. You -will need <code>libelf</code> to compile the kernel. If you want to configure using the -menu interface you will also need <code>ncurses</code>. -</p> - -<div class="org-src-container"> -<pre class="src src-sh"><span style="color: #95a5a6;"># </span><span style="color: #7f8c8d;">The package manager asks to install if you are building more than one package,</span> -<span style="color: #95a5a6;"># </span><span style="color: #7f8c8d;">so no need to run 'cpt i ...'</span> -cpt b libelf ncurses -</pre> -</div> - -<p> -In the vanilla kernel sources, you need perl to compile the kernel, but it can -be easily patched out. You will need to apply the following patch. Patch was -written by <a href="https://github.com/E5ten">E5ten</a>. You will need to obtain and apply the patch in the kernel -source directory. -</p> - -<div class="org-src-container"> -<pre class="src src-sh">wget https://dl.carbslinux.org/distfiles/kernel-no-perl.patch -patch -p1 < kernel-no-perl.patch -</pre> -</div> -</div> -</div> - -<div id="outline-container-orga3c74bc" class="outline-3"> -<h3 id="orga3c74bc"><span class="section-number-3">4.3</span> Building the kernel</h3> -<div class="outline-text-3" id="text-4-3"> -<p> -Next step is configuring and building the kernel. You can check Gentoo's -<a href="https://wiki.gentoo.org/wiki/Kernel/Configuration">kernel configuration guide</a> to learn more about the matter. Overall, Gentoo Wiki -is a good place to learn about configuration according to your hardware. The -following will assume a monolithic kernel. -</p> - -<div class="org-src-container"> -<pre class="src src-sh">make menuconfig -make -install -Dm755 $(make -s image_name) /boot/vmlinuz-linux -</pre> -</div> -</div> -</div> -</div> - -<div id="outline-container-orgb176eb1" class="outline-2"> -<h2 id="orgb176eb1"><span class="section-number-2">5</span> Making your system bootable</h2> -<div class="outline-text-2" id="text-5"> -<p> -In order to be able to boot your fresh system, wou will need an init-daemon, -init-scripts and a bootloader. The init daemon is already provided by busybox, -but you can optionally change it. -</p> -</div> - -<div id="outline-container-org31a5fde" class="outline-3"> -<h3 id="org31a5fde"><span class="section-number-3">5.1</span> Bootloader</h3> -<div class="outline-text-3" id="text-5-1"> -<p> -In the main repository, there is efibootmgr and grub to serve as bootloaders. -efibootmgr can be used as a standalone bootloader, or can be used to install -grub in a UEFI environment. efibootmgr is needed unless you are using a device -without UEFI support (or you really want to use BIOS for a reason). -</p> -</div> - -<div id="outline-container-org43ed898" class="outline-4"> -<h4 id="org43ed898"><span class="section-number-4">5.1.1</span> GRUB BIOS installation</h4> -<div class="outline-text-4" id="text-5-1-1"> -<div class="org-src-container"> -<pre class="src src-sh">cpt b grub && cpt i grub -grub-install --target=i386-pc /dev/sdX -grub-mkconfig -o /boot/grub/grub.cfg -</pre> -</div> -</div> -</div> - -<div id="outline-container-orgf826efe" class="outline-4"> -<h4 id="orgf826efe"><span class="section-number-4">5.1.2</span> GRUB UEFI installation</h4> -<div class="outline-text-4" id="text-5-1-2"> -<div class="org-src-container"> -<pre class="src src-sh">cpt b efibootmgr && cpt i efibootmgr -cpt b grub && cpt i grub - -grub-install --target=x86_64-efi <span style="color: #0a74b9;">\</span> - --efi-directory=esp <span style="color: #0a74b9;">\</span> - --bootloader-id=CarbsLinux - -grub-mkconfig -o /boot/grub/grub.cfg -</pre> -</div> -</div> -</div> -</div> - -<div id="outline-container-org2d43b5f" class="outline-3"> -<h3 id="org2d43b5f"><span class="section-number-3">5.2</span> Init scripts</h3> -<div class="outline-text-3" id="text-5-2"> -<p> -Only thing left to do is installing the init-scripts, and now you are almost -ready to boot your system! -</p> - -<div class="org-src-container"> -<pre class="src src-sh">cpt b carbs-init && cpt i carbs-init -</pre> -</div> -</div> -</div> - -<div id="outline-container-orgfe8161b" class="outline-3"> -<h3 id="orgfe8161b"><span class="section-number-3">5.3</span> Fstab</h3> -<div class="outline-text-3" id="text-5-3"> -<p> -You can now manually edit your fstab entry, or you can use the genfstab tool. -If you want to use the tool, exit the chroot and run the following: -</p> - -<div class="org-src-container"> -<pre class="src src-sh">wget https://github.com/cemkeylan/genfstab/raw/master/genfstab -chmod +x genfstab -./genfstab -U /mnt >> /mnt/etc/fstab -</pre> -</div> -</div> -</div> -</div> - -<div id="outline-container-org917e2c8" class="outline-2"> -<h2 id="org917e2c8"><span class="section-number-2">6</span> Post-installation</h2> -<div class="outline-text-2" id="text-6"> -<p> -The base installation is now complete, you can now fine tune your system -according to your needs. Rest of these instructions are completely optional. -You can check the rest of the documentation to learn more about the system. -</p> -</div> - -<div id="outline-container-org96641ac" class="outline-3"> -<h3 id="org96641ac"><span class="section-number-3">6.1</span> KISS repositories</h3> -<div class="outline-text-3" id="text-6-1"> -<p> -While not 100% compatible with cpt, you can use kiss repositories in your -system the same way you are using the distribution repositories. Here is an -example for the KISS Linux Community repository. -</p> -</div> -</div> -</div> -</div> -</body> -</html> diff --git a/src/download.org b/src/download.org new file mode 100644 index 0000000..ef6fb44 --- /dev/null +++ b/src/download.org @@ -0,0 +1,14 @@ +#+TITLE: Download Carbs Linux + +Below are the latest tarballs for the =x86_64= and =i686= architectures. You can +visit [[https://dl.carbslinux.org/releases]] for all downloads. Follow the +[[file:install.org][Installation guide]] to learn more about verifying the releases, and the required +steps for installing the system. + +* x86-64 + +[[https://dl.carbslinux.org/releases/x86_64/carbs-rootfs.tar.xz][carbs-rootfs.tar.xz]] | [[https://dl.carbslinux.org/releases/x86_64/carbs-rootfs.tar.xz.sha256][SHA256SUM]] | [[https://dl.carbslinux.org/releases/x86_64/carbs-rootfs.tar.xz.sig][Signature]] + +* i686 + +[[https://dl.carbslinux.org/releases/i686/carbs-rootfs.tar.xz][carbs-rootfs.tar.xz]] | [[https://dl.carbslinux.org/releases/i686/carbs-rootfs.tar.xz.sha256][SHA256SUM]] | [[https://dl.carbslinux.org/releases/i686/carbs-rootfs.tar.xz.sig][Signature]] diff --git a/src/index.md b/src/index.md deleted file mode 100644 index 9c3fa4d..0000000 --- a/src/index.md +++ /dev/null @@ -1,97 +0,0 @@ -Carbs Linux is an in-development Linux® distribution with a suckless mindset. -The base system consists of only the necessary programs to create a Linux -distribution. - -Package Manager --------------------------------------------------------------------------------- - -Carbs Linux uses its own package manager [Carbs Packaging Tools], a POSIX shell -package manager forked from KISS with the tool-based approach of xbps. - - -Small base --------------------------------------------------------------------------------- - -By default, Carbs Linux comes with busybox for coreutils, bearssl for its -crypto library, musl libc, and other basic utilities that are required for -building new software. The majority of the base packages are statically linked. - - -Multiple Init Support --------------------------------------------------------------------------------- - -Carbs Linux has support for multiple init systems and service supervisors. In -the main repository are - -- `sinit` -- `busybox-init` (SysVinit clone) -- `runit-init` - -for init systems, and - -- `sysmgr` -- `busybox-runit` -- `runit` - -for service supervisors. The [carbs-init] package is the collection of init -scripts that ensure the interoperability of these init and service systems, and -make it easier for the user to switch to their preferred combinations of system -supervision. - -Nothing holds you back, however, from ditching any of these and packaging some -other system supervision technique along with your own init scripts. - - -[carbs-init]: https://github.com/CarbsLinux/repository/tree/master/core/carbs-init -[Carbs Packaging Tools]: https://github.com/CarbsLinux/cpt - -Links --------------------------------------------------------------------------------- - -* IRC - `#carbslinux` on freenode -* Reddit - [/r/carbslinux] -* [Mailing Lists] - -[/r/carbslinux]: http://reddit.com/r/carbslinux -[Mailing Lists]: /mailing-lists.html - -News --------------------------------------------------------------------------------- - -[RSS Feed](/news.xml) | [See all news](/news.html) - -Sep 16 2020 --------------------------------------------------------------------------------- - -The libressl "revert" was reverted. System update will replace libressl -dependencies with bearssl. You may choose to keep or remove bearssl after the -update. - -Sep 03 2020 --------------------------------------------------------------------------------- - -The default TLS provider has been reverted to 'libressl'. System update will -replace bearssl dependencies with libressl. You may choose to keep or remove -bearssl after the update. - -Jul 27 2020 --------------------------------------------------------------------------------- - -Carbs Linux's fork of the `kiss` package manager has been renamed to -`Carbs Packaging Tools` due to huge amount of changes. Your latest `kiss` -update will handle the bootstrapping. You will need to rename your `KISS-*` -variables to `CPT-*` - -Jun 17 2020 --------------------------------------------------------------------------------- - -A new rootfs tarball including the changes to the core is released and can be -found on the downloads page. - -May 26 2020 --------------------------------------------------------------------------------- - -An initial version for binary package management is released. -It can be found on the [GitHub page]. - -[GitHub page]: https://github.com/CarbsLinux/kiss-bin diff --git a/src/index.org b/src/index.org new file mode 100644 index 0000000..df5a98f --- /dev/null +++ b/src/index.org @@ -0,0 +1,56 @@ +#+TITLE: Carbs Linux +#+DESCRIPTION: a simple Linux distribution +#+OPTIONS: title:nil + +Carbs Linux is a source-based Linux\reg distribution that aims to be simple, +flexible and extensible while staying as pragmatic and practical as possible. +The system can consist of as much or as little as its user can intend to. + +* Package Manager + +Carbs Linux uses its own package manager [[https://github.com/CarbsLinux/cpt][Carbs Packaging Tools]], a POSIX shell +package manager forked from KISS with the tool-based approach of xbps. + + +* Small base + +By default, Carbs Linux comes with busybox for coreutils, bearssl for its +crypto library, musl libc, and other basic utilities that are required for +building new software. The majority of the base packages are statically linked. + + +* Multiple Init Support + +Carbs Linux has support for multiple init systems and service supervisors. In +the main repository are + +- =sinit= +- =busybox-init= (SysVinit clone) +- =runit-init= + +for init systems, and + +- =sysmgr= +- =busybox-runit= +- =runit= + +for service supervisors. The [[https://github.com/CarbsLinux/repository/tree/master/core/carbs-init][carbs-init]] package is the collection of init +scripts that ensure the interoperability of these init and service systems, and +make it easier for the user to switch to their preferred combinations of system +supervision. + +Nothing holds you back, however, from ditching any of these and packaging some +other system supervision technique along with your own init scripts. + + +* Links + +- IRC - =#carbslinux= on freenode +- Reddit - [[https://reddit.com/r/carbslinux][r/carbslinux]] +- [[file:mailing-lists.org][Mailing Lists]] + +* News + +[[file:./news.xml][RSS Feed]] | [[file:./news][See all news]] + +#+INCLUDE: ../news/latest-news.org :minlevel 2 diff --git a/src/install.org b/src/install.org new file mode 100644 index 0000000..410a02b --- /dev/null +++ b/src/install.org @@ -0,0 +1,4 @@ +#+TITLE: Installation Guide +#+OPTIONS: num:t + +#+INCLUDE: "../texidocs/carbslinux.org::*Installation" :only-contents t diff --git a/src/mailing-lists.md b/src/mailing-lists.md deleted file mode 100644 index baa97a7..0000000 --- a/src/mailing-lists.md +++ /dev/null @@ -1,12 +0,0 @@ -Mailing Lists -================================================================================ - -We have mailing lists set up at [sourcehut]. You can subscribe to the mailing -list by sending an empty mail to - - ~carbslinux/dev+subscribe@lists.sr.ht - -You can also see the [archives]. - -[sourcehut]: https://sr.ht -[archives]: https://lists.sr.ht/~carbslinux/dev diff --git a/src/mailing-lists.org b/src/mailing-lists.org new file mode 100644 index 0000000..b9009e1 --- /dev/null +++ b/src/mailing-lists.org @@ -0,0 +1,6 @@ +#+TITLE: Mailing Lists + +We have mailing lists set up at [[https://sr.ht][SourceHut]]. You can subscribe to the mailing +list by sending an empty mail to [[mailto:~carbslinux/dev+subscribe@lists.sr.ht][~carbslinux/dev+subscribe@lists.sr.ht]]. + +You can also see the [[https://lists.sr.ht/~carbslinux/dev][archives]]. diff --git a/src/news.md b/src/news.md deleted file mode 100644 index 67d1788..0000000 --- a/src/news.md +++ /dev/null @@ -1,259 +0,0 @@ -Sep 16 2020 --------------------------------------------------------------------------------- - -The libressl "revert" was reverted. System update will replace libressl -dependencies with bearssl. You may choose to keep or remove bearssl after the -update. - -Sep 03 2020 --------------------------------------------------------------------------------- - -The default TLS provider has been reverted to 'libressl'. System update will -replace bearssl dependencies with libressl. You may choose to keep or remove -bearssl after the update. - -Jul 27 2020 --------------------------------------------------------------------------------- - -Carbs Linux's fork of the `kiss` package manager has been renamed to -`Carbs Packaging Tools` due to huge amount of changes. Your latest `kiss` -update will handle the bootstrapping. You will need to rename your `KISS-*` -variables to `CPT-*` - -Jun 17 2020 --------------------------------------------------------------------------------- - -A new rootfs tarball including the changes to the core is released and can be -found on the downloads page. - -May 26 2020 --------------------------------------------------------------------------------- - -An initial version for binary package management is released. -It can be found on the [GitHub page]. - -[GitHub page]: https://github.com/CarbsLinux/kiss-bin - -May 19 2020 --------------------------------------------------------------------------------- - -A rootfs tarball targeting the i686 architecture has -been released. It can be found on the [downloads page] - -[downloads page]: https://dl.carbslinux.org/releases/i686 - -May 10 2020 --------------------------------------------------------------------------------- - -A GCC 10.1.0 change causes a kernel panic for kernels built -with GCC 10.1. This issue can be resolved by applying this -[patch] to your kernel sources. - -[patch]: https://git.kernel.org/pub/scm/linux/kernel/git/tip/tip.git/patch/?id=f670269a42bfdd2c83a1118cc3d1b475547eac22 - -Apr 27 2020 --------------------------------------------------------------------------------- - -A new rootfs tarball has been released! You can -see it on <https://dl.carbslinux.org/releases>! - -**EDIT:** A new bug fix release has been made. - -Apr 10 2020 --------------------------------------------------------------------------------- - -IRC channel can now be accessed from `#carbslinux` at freenode! - -Apr 06 2020 --------------------------------------------------------------------------------- - -A new rootfs tarball has been released. See the -[downloads](https://dl.carbslinux.org) page - -Apr 05 2020 --------------------------------------------------------------------------------- - -Carbs Linux repositories will be hosted only on Github. Commits will be -pushed there, and not the repository. You have until -May 4, 2020 Monday to switch your remotes to <https://github.com/CarbsLinux/repository>. -The git repository will continue to be served until then (without additional -commits). - -You can switch your remote by executing the following command on your -repository directory. - - git remote set-url origin https://github.com/CarbsLinux/repository - - -Feb 18 2020 --------------------------------------------------------------------------------- - -A new tarball is released. It can be found on <https://dl.carbslinux.org>. - -**edit:** I have removed the tarball because of a bootstrapping issue. -I will be re-adding it later today. - -**edit 2:** I have added a tarball (20200219) to reflect my recent -changes on Busybox. - - -Feb 14 2020 --------------------------------------------------------------------------------- - -**IMPORTANT!** Carbs-init update to be released on 17th of February -will require manual intervention. I am holding this update back so -people can see it before they update their system (even though the -update will show the same message as this). The rationale for the -update is explained below the intervention. - - # There is an explanation for each init - # You only need to follow the instructions - # for your own init-system - - ## busybox-init - # If you did not edit your inittab simply - # move inittab.new to inittab - -> mv /etc/inittab.new /etc/inittab - - # If you did edit your inittab you can use - # a simple sed command to remove the necessary lines - -> sed -i '/getty/d;/runsvdir/d' /etc/inittab - - - ## runit - # same as busybox-init, if you did not edit - # /etc/runit/2 move 2.new to 2 - -> mv /etc/runit/2.new /etc/runit/2 - - # else - -> vim /etc/runit/2 - # open your 2 file and remove the for loop containing - # getty commands. If you are using runit, it is recommended - # to comment out /etc/init/runit.boot - - ## sinit/minit - # If you did not edit your {sinit-,}launch-services.boot - # you can simply remove it. - -> rm -f /etc/init/launch-services.boot /etc/init/sinit-launch-services.boot - - # This should leave you without any issues, and you can safely reboot. - -Carbs-init update is to make sure init systems do not clash, and do -not have to use different files. This is a sensible update both for -the user user and for the maintainer side. - -To give an example, before this update busybox-init was managing getty -through `inittab`, runit was managing through `/etc/runit/2`, and -minit/sinit were launching from `/etc/init/launch-services.boot`. This -is a configuration nightmare for everyone, and since I am maintaining -and constantly testing those init providers, a huge nightmare for me. -This is a Quality of Life update. - - -Feb 13 2020 --------------------------------------------------------------------------------- - -Runit is now released on the core repository! You can now replace -busybox-init with runit-init. You can also replace the busybox runit -utilities with the actual runit. This will reduce the dependency on -busybox greatly. - -Jan 28 2020 --------------------------------------------------------------------------------- - -Web Server is now on a Carbs Linux server. It is not complete yet, -but I will be adding a little more for the intended functionality. -Downtimes can be expected. - -UPDATE: ssl is now working. - -UPDATE2: downloads are back again. - - -Jan 22 2020 --------------------------------------------------------------------------------- - -Expect downtime on Jan 24 2020 22:00 UTC as I will be migrating -this web server to my Carbs Linux server! - - -Jan 15 2020 --------------------------------------------------------------------------------- - -sinit has been taken to `core`, and is now officially supported - - -Jan 13 2020 --------------------------------------------------------------------------------- - -**Busybox update reqires manual intervention** - -The new busybox package conflicts with the pre-update busybox-init. That's why -you should rebuild and install `busybox-init` before doing the update. - - # Do a kiss update first (but don't actually update it yet), or manually pull the git repository - $ kiss u # Cancel this operation after it asks for you to confirm the update - - # Install the busybox-init package - $ kiss b busybox-init && kiss i busybox-init - - # Continue your update as you normally would. - $ kiss u - -I have moved runit and logging utilities from the busybox-init package to the busybox -package, which is the cause of these conflicts. - -Jan 10 2020 --------------------------------------------------------------------------------- - -carbs-rootfs-20200110.tar.xz was [released](//dl.carbslinux.org/releases) - - -Jan 09 2020 --------------------------------------------------------------------------------- - -Happy new year, everyone! I am back after some long silence. I was unable to commit for a -while, but I have pulled some new updates from the KISS repository, added some of my own. -This week I will be changing/adding some things. - -Important things are, - -* Carbs-init was updated to 0.3. -* I will be adding an implementation of suckless.org's [sinit](//core.suckless.org/sinit) as `carbs-sinit` -* Carbs Repository was added to [repology.org](//repology.org/repository/carbs) -* A new rootfs tarball will be coming up tomorrow. - - -Dec 18 2019 --------------------------------------------------------------------------------- - -carbs-rootfs-20191218.tar.xz was [released](//dl.carbslinux.org/releases) - - -Dec 17 2019 --------------------------------------------------------------------------------- - -Installation instruction are now complete. A review would be greatly appreciated! - - -Dec 15 2019 --------------------------------------------------------------------------------- - -Carbs Linux Wiki is now available to be edited and updated by the users go -to the [wiki](//carbslinux.org/wiki) to obtain more information. - -**February 2020 EDIT:** Changed link for wiki - - -Dec 12 2019 --------------------------------------------------------------------------------- - -Busybox and Busybox-init has been seperated into two different packages. -This is for adding standalone runit/runit-init to the repositories. - - -Dec 10 2019 --------------------------------------------------------------------------------- - -First alpha release was made. See the [downloads page](//dl.carbslinux.org/releases). - diff --git a/src/news.xml b/src/news.xml deleted file mode 100644 index 0db7bba..0000000 --- a/src/news.xml +++ /dev/null @@ -1,360 +0,0 @@ -<?xml version="1.0" encoding="UTF-8"?> -<rss version="2.0" - xmlns:atom="http://www.w3.org/2005/Atom" - xmlns:dc="http://purl.org/dc/elements/1.1/" - xmlns:sy="http://purl.org/rss/1.0/modules/syndication/" -> - <channel> - <title>Carbs Linux</title> - <description>a simple linux distribution</description> - <link>https://carbslinux.org</link> - <atom:link href="https://carbslinux.org/news.xml" rel="self" type="application/rss+xml" /> - <lastBuildDate>Thu Jan 07 2021 11:00</lastBuildDate> -<item> -<title>Sep 16 2020</title> -<pubDate>Wed, 16 Sep 2020</pubDate> -<dc:creator>Cem Keylan</dc:creator> -<link>https://carbslinux.org/index.html</link> -<description><h2>Sep 16 2020</h2> - -<p>The libressl &ldquo;revert&rdquo; was reverted. System update will replace libressl -dependencies with bearssl. You may choose to keep or remove bearssl after the -update.</p></description> -</item> -<item> -<title>Sep 03 2020</title> -<pubDate>Thu, 03 Sep 2020</pubDate> -<dc:creator>Cem Keylan</dc:creator> -<link>https://carbslinux.org/index.html</link> -<description><h2>Sep 03 2020</h2> - -<p>The default TLS provider has been reverted to &lsquo;libressl&rsquo;. System update will -replace bearssl dependencies with libressl. You may choose to keep or remove -bearssl after the update.</p></description> -</item> -<item> -<title>Jul 27 2020</title> -<pubDate>Mon, 27 Jul 2020</pubDate> -<dc:creator>Cem Keylan</dc:creator> -<link>https://carbslinux.org/index.html</link> -<description><h2>Jul 27 2020</h2> - -<p>Carbs Linux&rsquo;s fork of the <code>kiss</code> package manager has been renamed to -<code>Carbs Packaging Tools</code> due to huge amount of changes. Your latest <code>kiss</code> -update will handle the bootstrapping. You will need to rename your <code>KISS-*</code> -variables to <code>CPT-*</code></p></description> -</item> -<item> -<title>Jun 17 2020</title> -<pubDate>Wed, 17 Jun 2020</pubDate> -<dc:creator>Cem Keylan</dc:creator> -<link>https://carbslinux.org/index.html</link> -<description><h2>Jun 17 2020</h2> - -<p>A new rootfs tarball including the changes to the core is released and can be -found on the downloads page.</p></description> -</item> -<item> -<title>May 26 2020</title> -<pubDate>Tue, 26 May 2020</pubDate> -<dc:creator>Cem Keylan</dc:creator> -<link>https://carbslinux.org/index.html</link> -<description><h2>May 26 2020</h2> - -<p>An initial version for binary package management is released. -It can be found on the <a href="https://github.com/CarbsLinux/kiss-bin">GitHub page</a>.</p></description> -</item> -<item> -<title>May 19 2020</title> -<pubDate>Tue, 19 May 2020</pubDate> -<dc:creator>Cem Keylan</dc:creator> -<link>https://carbslinux.org/index.html</link> -<description><h2>May 19 2020</h2> - -<p>A rootfs tarball targeting the i686 architecture has -been released. It can be found on the <a href="https://dl.carbslinux.org/releases/i686">downloads page</a></p></description> -</item> -<item> -<title>May 10 2020</title> -<pubDate>Sun, 10 May 2020</pubDate> -<dc:creator>Cem Keylan</dc:creator> -<link>https://carbslinux.org/index.html</link> -<description><h2>May 10 2020</h2> - -<p>A GCC 10.1.0 change causes a kernel panic for kernels built -with GCC 10.1. This issue can be resolved by applying this -<a href="https://git.kernel.org/pub/scm/linux/kernel/git/tip/tip.git/patch/?id=f670269a42bfdd2c83a1118cc3d1b475547eac22">patch</a> to your kernel sources.</p></description> -</item> -<item> -<title>Apr 27 2020</title> -<pubDate>Mon, 27 Apr 2020</pubDate> -<dc:creator>Cem Keylan</dc:creator> -<link>https://carbslinux.org/index.html</link> -<description><h2>Apr 27 2020</h2> - -<p>A new rootfs tarball has been released! You can -see it on <a href="https://dl.carbslinux.org/releases">https://dl.carbslinux.org/releases</a>!</p> - -<p><strong>EDIT:</strong> A new bug fix release has been made.</p></description> -</item> -<item> -<title>Apr 10 2020</title> -<pubDate>Fri, 10 Apr 2020</pubDate> -<dc:creator>Cem Keylan</dc:creator> -<link>https://carbslinux.org/index.html</link> -<description><h2>Apr 10 2020</h2> - -<p>IRC channel can now be accessed from <code>#carbslinux</code> at freenode!</p></description> -</item> -<item> -<title>Apr 06 2020</title> -<pubDate>Mon, 06 Apr 2020</pubDate> -<dc:creator>Cem Keylan</dc:creator> -<link>https://carbslinux.org/index.html</link> -<description><h2>Apr 06 2020</h2> - -<p>A new rootfs tarball has been released. See the -<a href="https://dl.carbslinux.org">downloads</a> page</p></description> -</item> -<item> -<title>Apr 05 2020</title> -<pubDate>Sun, 05 Apr 2020</pubDate> -<dc:creator>Cem Keylan</dc:creator> -<link>https://carbslinux.org/index.html</link> -<description><h2>Apr 05 2020</h2> - -<p>Carbs Linux repositories will be hosted only on Github. Commits will be -pushed there, and not the repository. You have until -May 4, 2020 Monday to switch your remotes to <a href="https://github.com/CarbsLinux/repository">https://github.com/CarbsLinux/repository</a>. -The git repository will continue to be served until then (without additional -commits).</p> - -<p>You can switch your remote by executing the following command on your -repository directory.</p> - -<pre><code>git remote set-url origin https://github.com/CarbsLinux/repository -</code></pre></description> -</item> -<item> -<title>Feb 18 2020</title> -<pubDate>Tue, 18 Feb 2020</pubDate> -<dc:creator>Cem Keylan</dc:creator> -<link>https://carbslinux.org/index.html</link> -<description><h2>Feb 18 2020</h2> - -<p>A new tarball is released. It can be found on <a href="https://dl.carbslinux.org">https://dl.carbslinux.org</a>.</p> - -<p><strong>edit:</strong> I have removed the tarball because of a bootstrapping issue. -I will be re-adding it later today.</p> - -<p><strong>edit 2:</strong> I have added a tarball (20200219) to reflect my recent -changes on Busybox.</p></description> -</item> -<item> -<title>Feb 14 2020</title> -<pubDate>Fri, 14 Feb 2020</pubDate> -<dc:creator>Cem Keylan</dc:creator> -<link>https://carbslinux.org/index.html</link> -<description><h2>Feb 14 2020</h2> - -<p><strong>IMPORTANT!</strong> Carbs-init update to be released on 17th of February -will require manual intervention. I am holding this update back so -people can see it before they update their system (even though the -update will show the same message as this). The rationale for the -update is explained below the intervention.</p> - -<pre><code># There is an explanation for each init -# You only need to follow the instructions -# for your own init-system - -## busybox-init -# If you did not edit your inittab simply -# move inittab.new to inittab --&gt; mv /etc/inittab.new /etc/inittab - -# If you did edit your inittab you can use -# a simple sed command to remove the necessary lines --&gt; sed -i '/getty/d;/runsvdir/d' /etc/inittab - - -## runit -# same as busybox-init, if you did not edit -# /etc/runit/2 move 2.new to 2 --&gt; mv /etc/runit/2.new /etc/runit/2 - -# else --&gt; vim /etc/runit/2 -# open your 2 file and remove the for loop containing -# getty commands. If you are using runit, it is recommended -# to comment out /etc/init/runit.boot - -## sinit/minit -# If you did not edit your {sinit-,}launch-services.boot -# you can simply remove it. --&gt; rm -f /etc/init/launch-services.boot /etc/init/sinit-launch-services.boot - -# This should leave you without any issues, and you can safely reboot. -</code></pre> - -<p>Carbs-init update is to make sure init systems do not clash, and do -not have to use different files. This is a sensible update both for -the user user and for the maintainer side.</p> - -<p>To give an example, before this update busybox-init was managing getty -through <code>inittab</code>, runit was managing through <code>/etc/runit/2</code>, and -minit/sinit were launching from <code>/etc/init/launch-services.boot</code>. This -is a configuration nightmare for everyone, and since I am maintaining -and constantly testing those init providers, a huge nightmare for me. -This is a Quality of Life update.</p></description> -</item> -<item> -<title>Feb 13 2020</title> -<pubDate>Thu, 13 Feb 2020</pubDate> -<dc:creator>Cem Keylan</dc:creator> -<link>https://carbslinux.org/index.html</link> -<description><h2>Feb 13 2020</h2> - -<p>Runit is now released on the core repository! You can now replace -busybox-init with runit-init. You can also replace the busybox runit -utilities with the actual runit. This will reduce the dependency on -busybox greatly.</p></description> -</item> -<item> -<title>Jan 28 2020</title> -<pubDate>Tue, 28 Jan 2020</pubDate> -<dc:creator>Cem Keylan</dc:creator> -<link>https://carbslinux.org/index.html</link> -<description><h2>Jan 28 2020</h2> - -<p>Web Server is now on a Carbs Linux server. It is not complete yet, -but I will be adding a little more for the intended functionality. -Downtimes can be expected.</p> - -<p>UPDATE: ssl is now working.</p> - -<p>UPDATE2: downloads are back again.</p></description> -</item> -<item> -<title>Jan 22 2020</title> -<pubDate>Wed, 22 Jan 2020</pubDate> -<dc:creator>Cem Keylan</dc:creator> -<link>https://carbslinux.org/index.html</link> -<description><h2>Jan 22 2020</h2> - -<p>Expect downtime on Jan 24 2020 22:00 UTC as I will be migrating -this web server to my Carbs Linux server!</p></description> -</item> -<item> -<title>Jan 15 2020</title> -<pubDate>Wed, 15 Jan 2020</pubDate> -<dc:creator>Cem Keylan</dc:creator> -<link>https://carbslinux.org/index.html</link> -<description><h2>Jan 15 2020</h2> - -<p>sinit has been taken to <code>core</code>, and is now officially supported</p></description> -</item> -<item> -<title>Jan 13 2020</title> -<pubDate>Mon, 13 Jan 2020</pubDate> -<dc:creator>Cem Keylan</dc:creator> -<link>https://carbslinux.org/index.html</link> -<description><h2>Jan 13 2020</h2> - -<p><strong>Busybox update reqires manual intervention</strong></p> - -<p>The new busybox package conflicts with the pre-update busybox-init. That&rsquo;s why -you should rebuild and install <code>busybox-init</code> before doing the update.</p> - -<pre><code># Do a kiss update first (but don't actually update it yet), or manually pull the git repository -$ kiss u # Cancel this operation after it asks for you to confirm the update - -# Install the busybox-init package -$ kiss b busybox-init &amp;&amp; kiss i busybox-init - -# Continue your update as you normally would. -$ kiss u -</code></pre> - -<p>I have moved runit and logging utilities from the busybox-init package to the busybox -package, which is the cause of these conflicts.</p></description> -</item> -<item> -<title>Jan 10 2020</title> -<pubDate>Fri, 10 Jan 2020</pubDate> -<dc:creator>Cem Keylan</dc:creator> -<link>https://carbslinux.org/index.html</link> -<description><h2>Jan 10 2020</h2> - -<p>carbs-rootfs-20200110.tar.xz was <a href="//dl.carbslinux.org/releases">released</a></p></description> -</item> -<item> -<title>Jan 09 2020</title> -<pubDate>Thu, 09 Jan 2020</pubDate> -<dc:creator>Cem Keylan</dc:creator> -<link>https://carbslinux.org/index.html</link> -<description><h2>Jan 09 2020</h2> - -<p>Happy new year, everyone! I am back after some long silence. I was unable to commit for a -while, but I have pulled some new updates from the KISS repository, added some of my own. -This week I will be changing/adding some things.</p> - -<p>Important things are,</p> - -<ul> -<li>Carbs-init was updated to 0.3.</li> -<li>I will be adding an implementation of suckless.org&rsquo;s <a href="//core.suckless.org/sinit">sinit</a> as <code>carbs-sinit</code></li> -<li>Carbs Repository was added to <a href="//repology.org/repository/carbs">repology.org</a></li> -<li>A new rootfs tarball will be coming up tomorrow.</li> -</ul></description> -</item> -<item> -<title>Dec 18 2019</title> -<pubDate>Wed, 18 Dec 2019</pubDate> -<dc:creator>Cem Keylan</dc:creator> -<link>https://carbslinux.org/index.html</link> -<description><h2>Dec 18 2019</h2> - -<p>carbs-rootfs-20191218.tar.xz was <a href="//dl.carbslinux.org/releases">released</a></p></description> -</item> -<item> -<title>Dec 17 2019</title> -<pubDate>Tue, 17 Dec 2019</pubDate> -<dc:creator>Cem Keylan</dc:creator> -<link>https://carbslinux.org/index.html</link> -<description><h2>Dec 17 2019</h2> - -<p>Installation instruction are now complete. A review would be greatly appreciated!</p></description> -</item> -<item> -<title>Dec 15 2019</title> -<pubDate>Sun, 15 Dec 2019</pubDate> -<dc:creator>Cem Keylan</dc:creator> -<link>https://carbslinux.org/index.html</link> -<description><h2>Dec 15 2019</h2> - -<p>Carbs Linux Wiki is now available to be edited and updated by the users go -to the <a href="//carbslinux.org/wiki">wiki</a> to obtain more information.</p> - -<p><strong>February 2020 EDIT:</strong> Changed link for wiki</p></description> -</item> -<item> -<title>Dec 12 2019</title> -<pubDate>Thu, 12 Dec 2019</pubDate> -<dc:creator>Cem Keylan</dc:creator> -<link>https://carbslinux.org/index.html</link> -<description><h2>Dec 12 2019</h2> - -<p>Busybox and Busybox-init has been seperated into two different packages. -This is for adding standalone runit/runit-init to the repositories.</p></description> -</item> -<item> -<title>Dec 10 2019</title> -<pubDate>Tue, 10 Dec 2019</pubDate> -<dc:creator>Cem Keylan</dc:creator> -<link>https://carbslinux.org/index.html</link> -<description><h2>Dec 10 2019</h2> - -<p>First alpha release was made. See the <a href="//dl.carbslinux.org/releases">downloads page</a>.</p></description> -</item> - </channel> -</rss> diff --git a/src/people.md b/src/people.md deleted file mode 100644 index 4d7c7af..0000000 --- a/src/people.md +++ /dev/null @@ -1,3 +0,0 @@ -People -====== -* Cem Keylan - Founder [cem@ckyln.com](mailto:cem@ckyln.com) diff --git a/src/people.org b/src/people.org new file mode 100644 index 0000000..e660080 --- /dev/null +++ b/src/people.org @@ -0,0 +1,3 @@ +* People + +- Cem Keylan - Founder [[mailto:cem@carbslinux.org][cem@carbslinux.org]] diff --git a/src/rss.xml b/src/rss.xml deleted file mode 100644 index e1f5cf2..0000000 --- a/src/rss.xml +++ /dev/null @@ -1,497 +0,0 @@ -<?xml version="1.0" encoding="UTF-8"?> -<rss version="2.0" - xmlns:atom="http://www.w3.org/2005/Atom" - xmlns:dc="http://purl.org/dc/elements/1.1/" - xmlns:sy="http://purl.org/rss/1.0/modules/syndication/" -> - <channel> - <title>Carbs Linux</title> - <description>a simple linux distribution</description> - <link>https://carbslinux.org</link> - <atom:link href="https://carbslinux.org/rss.xml" rel="self" type="application/rss+xml" /> - <lastBuildDate>Thu Jan 07 2021 11:00</lastBuildDate> -<item> -<title>First Year of Carbs Linux</title> -<pubDate>Thu, 10 Dec 2020</pubDate> -<dc:creator>Cem Keylan</dc:creator> -<link>https://carbslinux.org/blog/20201210.html</link> -<description><h1>First Year of Carbs Linux</h1> - -<p>December 10, 2020 marks the first year after the initial release of Carbs -Linux. When I forked the KISS Linux repository on the 9th of December, I was -fairly new to package management. Carbs Linux used to be almost identical to -KISS Linux. A lot has changed since then:</p> - -<ul> -<li>[2020 Jan 13] Replaced default init system to <code>sinit</code></li> -<li>[2020 Jan 15] Packaged <code>WebKit2GTK</code></li> -<li>[2020 May 17] Added <code>bearssl</code> on the testing repository</li> -<li>[2020 May 28] Added <code>rsync</code> repository support to kiss</li> -<li>[2020 Jun 03] Replaced <code>bison</code> with <code>byacc</code></li> -<li>[2020 Jun 11] Replaced <code>libressl</code> with <code>bearssl</code></li> -<li>[2020 Jun 24] Replaced <code>kiss</code> with <code>cpt</code></li> -</ul> - - -<p>I have really enjoyed maintaining and developing this distribution, and I want -to thank everyone who was involved in some way or another. While I have slowed -down in development due to college workload, I am still actively maintaining all -the packages on the repository. I do have some ideas that I am thinking of -implementing during the semester break. Hope to see you all in January.</p></description> -</item> -<item> -<title>August 2020 News Post</title> -<pubDate>Mon, 03 Aug 2020</pubDate> -<dc:creator>Cem Keylan</dc:creator> -<link>https://carbslinux.org/blog/20200803.html</link> -<description><h1>August 2020 News Post</h1> - -<p>We are having some stalls during this summer, as I am currently working on -university-related stuff. Nonetheless, there are some important changes that I -want to share in this month&rsquo;s post.</p> - -<h2>INDEX</h2> - -<ul> -<li><a href="#carbs-packaging-tools">Carbs Packaging Tools</a></li> -<li><a href="#docs">Docs</a></li> -<li><a href="#re-opening-the-carbs-linux-server">Re-opening the Carbs Linux server</a></li> -</ul> - - -<h2>Carbs Packaging Tools</h2> - -<p>This month I have reworked <code>kiss</code> into a new package manager, now renamed as -<code>cpt</code>. Updating <code>kiss</code> will now bootstrap the new package manager, so you don&rsquo;t -have to manually edit your system. If you don&rsquo;t like the idea of this, you can -look up the <code>post-install</code> script on <code>core/kiss</code> and apply the changes manually.</p> - -<p>You will also need to rename your KISS<em>* variables to CPT</em>*. So, KISS_PATH -becomes CPT_PATH.</p> - -<p>The rework changes the previous commands on the package manager into standalone -tools, and move the package manager functions to a library. This makes it easier -for a user to import functions and variables from the package manager, and -extend the package manager with their own intended way. Previously this required -ugly hacks and workarounds to use the package manager functions. I will be -making use of these changes to re-implement binary package management functions -as well.</p> - -<p>If you want to use the library on your script you can simply do this:</p> - -<pre><code>+--------------------------------------------------------------------------+ -| | -| #!/bin/sh | -| . cpt-lib | -| (...) | -| | -+--------------------------------------------------------------------------+ -</code></pre> - -<p>There are obviously some clean-up and simplifications needed in this new -tool-based package management method.</p> - -<h2>Docs</h2> - -<p>I have added documentation for the distribution, and finally updated the guide -for installation. It is now <em>almost</em> complete. These docs can be installed to -your system for online viewing. I will also add a documentation crawler similar -to how werc<a href="http://werc.cat-v.org">^1</a> works (but as an offline viewer). You can find <code>carbs-docs</code> from -the repository. Currently, the documentation lacks but I will be adding new -stuff. These will solely be distribution specific documentation and will not be -a wiki-like source. If anyone would like to contribute to a wiki-like -documentation source, I would happily re-open the distribution wiki. You can -find the source on https://github.com/CarbsLinux/docs</p> - -<h2>Re-opening the Carbs Linux server</h2> - -<p>Back in May, I had shutdown the Carbs Linux server due to financial issues, but -I am slowly reverting to the self-hosted model. Back then, the git repositories -were mirrored to GitHub, and the management was overall much more flexible. The -server used to run Carbs Linux as well (that was fun and horrifying at the same -time). Now, I will be relaunching the git server which will be the upstream -source before August 5. You can switch your remote, but GitHub will stay as a -remote nonetheless.</p> - -<p>EDIT: The git-server is up!</p></description> -</item> -<item> -<title>June Newspost</title> -<pubDate>Wed, 17 Jun 2020</pubDate> -<dc:creator>Cem Keylan</dc:creator> -<link>https://carbslinux.org/blog/20200617.html</link> -<description><h1>June Newspost</h1> - -<p>This will be an active month for Carbs as major changes to the base and the -package manager will be coming up.</p> - -<h2>Statically linking the base</h2> - -<p>For the past couple of weeks I have been trying to simplify the base and -statically link the core (mostly binaries rather than libraries). I usually see -some people extremely opposed to static linking as I also see the opposite on -people.</p> - -<p>I believe that binaries on the core should always be linked statically. This -ensures that an SONAME bump to <code>libObscure.so</code> will not break the core -functionality of your system, forcing you to use external resources to recover -from such an issue. As long as you can compile, use core utilities, edit text, -and access the web, you can solve any given issue on your system.</p> - -<p>However, I don&rsquo;t think that removing shared libraries is sensible either. Not -every piece of software out there is good quality enough to be statically -linked.</p> - -<h2>Major changes on the core repository</h2> - -<p>There have been drastic changes to the core repository and the base rootfs this -month (with more on the way). Right now changes are as follows.</p> - -<h3>Removed from Core</h3> - -<ul> -<li><code>git</code></li> -<li><code>libressl</code></li> -<li><code>grub</code></li> -<li><code>bison</code></li> -<li><code>dhcpcd</code></li> -<li><code>ubase</code></li> -</ul> - - -<h3>Added to Core</h3> - -<ul> -<li><code>bearssl</code>, as a <code>libressl</code> replacement</li> -<li><code>byacc</code>, as a <code>bison</code> replacement</li> -</ul> - - -<h3>Statically linked</h3> - -<ul> -<li><code>kiss</code></li> -<li><code>neatvi</code></li> -<li><code>mandoc</code></li> -<li><code>byacc</code></li> -<li><code>m4</code></li> -<li><code>e2fsprogs</code></li> -<li><code>make</code></li> -<li><code>pkgconf</code></li> -<li><code>sbase</code></li> -<li><code>libnl</code></li> -<li><code>wpa_supplicant</code></li> -<li><code>bearssl</code></li> -</ul> - - -<h2>Making the wiki available offline</h2> - -<p>Soon, all documentation regarding Carbs Linux will be avaialable to be installed -from the core repository in a <code>carbs-docs</code> package along with its own document -crawler. Currently, the documentation regarding the installation process is a -little outdated which will also receive some important updates.</p> - -<h2>ISO image for Carbs</h2> - -<p>I am thinking of releasing an ISO image in order to provide a standardized -environment for installation along with installation helper tools in the spirit -of <code>arch-install-scripts</code>. Let&rsquo;s see how that&rsquo;s going to play out.</p></description> -</item> -<item> -<title>kiss 2.0.0 and overall changes</title> -<pubDate>Thu, 28 May 2020</pubDate> -<dc:creator>Cem Keylan</dc:creator> -<link>https://carbslinux.org/blog/20200528.html</link> -<description><h1>kiss 2.0.0 and overall changes</h1> - -<p>Carbs Linux kiss version 2.0.0 has been released which introduces -rsync repositories.</p> - -<p>Git is no longer a mandatory dependency for the package manager, -every git source on the core repository has been replaced with -https sources (sbase, sinit), and rootfs tarballs will no longer -ship with git. Repositories in the upcoming tarball will be rsync -repositories.</p> - -<p>Git is now on the <code>extra</code> repository and is still (optionally) -used in the package manager.</p> - -<p>The idea behind this change is size reductions and increased -speed with rsync. As I said on the previous post, git repositories -get larger and larger over the time span. Currently my personal -copy of the git repository is around 77MB and I have forked KISS -Linux (as a shallow copy) around December. Obviously, I have commits -that I ommitted. I tend to create commits I dislike, which I change -with &lsquo;git reset &ndash;soft HEAD^&rsquo;, which doesn&rsquo;t actually remove the -commits, etc. A user will have a repository much smaller than mine.</p> - -<p>This is a precaution with the added bonuses of speed and dropping a -mandatory dependency.</p> - -<p>You can see the rest of the changelog <a href="https://github.com/CarbsLinux/kiss/blob/master/CHANGELOG.md">here</a>.</p> - -<h2>Binary Repositories</h2> - -<p>A few days ago, I have also published <a href="https://github.com/CarbsLinux/kiss-bin">kiss-bin</a>, a first version -for managing binary repositories. Currently, there are some caveats -that I&rsquo;ll be fixing along the way. I decided not to include this -in the package manager natively as managing the source based and -binary based packages together adds levels of complexity that we -do not want. Instead, this is an extension for kiss which sources -the package manager as a library. I hope to see it being adopted -by others interested on the matter as well.</p> - -<p>That&rsquo;s about it.</p> - -<p>Cheers, -Cem</p></description> -</item> -<item> -<title>The Relation of Carbs and KISS</title> -<pubDate>Fri, 08 May 2020</pubDate> -<dc:creator>Cem Keylan</dc:creator> -<link>https://carbslinux.org/blog/20200508.html</link> -<description><h1>The Relation of Carbs and KISS</h1> - -<p><strong>Date:</strong> May 08 2020</p> - -<p>Since I have forked KISS, I have received many questions -that can be summarized as &ldquo;Why?&rdquo;. I have realized that I -never truly answered this question. That&rsquo;s the reason I am -writing this post, to give some background on Carbs, and -some differences between KISS Linux and Carbs Linux for -anyone who may be wondering. Perhaps I could make this a -&ldquo;FAQ&rdquo; page later on.</p> - -<h2>History</h2> - -<p>I had the idea of creating my own Linux distribution since -the May of 2019. Back then, I had my own <a href="https://linuxfromscratch.org">Linux from Scratch</a> -build, and I wanted to slim it down my own way and replace -the software (with musl,sbase,etc.). The name Carbs Linux -was in my mind since then. I wanted to write my own package -manager, but I wasn&rsquo;t satisfied with anything I had built.</p> - -<p>I had written some incomplete package managers (all named <code>fat</code>) -and I quickly threw them into the trash can, where they -honestly belonged. I would want to share them with you for -laughs, but my hard-drive got wiped and I have a problem -of not doing an &ldquo;initial commit&rdquo; until a program I write -is in a usable state.</p> - -<p>I have obtained the &lsquo;carbslinux.org&rsquo; domain name in September -2019, but then life got on the way, and I stopped for a long -time.</p> - -<p>One day on Reddit, I saw Dylan&rsquo;s post on <a href="https://reddit.com/r/unixporn">r/unixporn</a> about -KISS, and I really thought that it was interesting. Here is -my <a href="https://www.reddit.com/r/unixporn/comments/ducd34/sowm_kiss_d/f7lua7x">comment</a> to Dylan on that post. I checked out the package -manager and the repository. The packaging system was extremely -clean and well-thought. I decided to give it a go and fork -KISS.</p> - -<h2>Differences between KISS and Carbs</h2> - -<p>Now, I still baffle when people ask me this question. My -intention was never to create a distribution with specific -differences between KISS. My intention was being my own -BDFL of a distribution I maintain. There are lots of -differences between the main repositories, but they are subtle -and not worth talking about. I personally never even installed -KISS Linux on my system. So Carbs, isn&rsquo;t something like a -downstream fork of KISS, it is just a distribution that was -initially based on KISS.</p> - -<p>I try to contribute as much as I can to KISS Linux. I think -that it is a brilliant distribution, and it was a great starting -point for Carbs. I am really grateful to Dylan and all the -other contributors.</p> - -<h2>What I&rsquo;m working on now</h2> - -<p>Currently I have a few projects that I&rsquo;m working on for Carbs. -These are,</p> - -<p>A BSD port for Carbs. For a while, I have been working on BSD -compatibility on my fork of the <a href="https://github.com/carbslinux/kiss">package manager</a>. I have tested, -without any more issues, on OpenBSD and FreeBSD. The biggest -issues remaining are choosing a vendor for BSD, packaging the -BSD source, and providing a minimal base (like busybox for BSD). -If you aren&rsquo;t familiar with BSD, it has a single source code -for all of the utilities (kernel, command line programs, etc.). -Contributions (even chipping in ideas) are very welcome.</p> - -<p>Adding binary package distribution support natively to the package -manager. Biggest issue in small/old computers are compile times. -This feature is for the bigger packages such as webkit, clang, -llvm that take a considerable amount of time. Some computers -with low memories cannot even compile firefox/webkit.</p> - -<p>Adding rsync repository support to the package manager. This -is not a current issue, but rather a futureproofing. As time -passes, distribution repositories grow larger. KISS and Carbs -are young distributions without this problem right now. But -in something like 5 years, this size will presumably increase -to hundreds of megabytes. At that point it will be pointless -to have the repository sources unless you specifically need them.</p> - -<h2>What&rsquo;s up with all the init/service daemons?</h2> - -<p>If you have ever checked the <a href="https://github.com/carbslinux/repository">repository</a>, you may have noticed -that there are lots of init/service related packages. I have had -my fair share of time with all of them, and it is an area that I -am really interested in. I have even written my own <a href="https://github.com/cemkeylan/shinit">init daemon</a> -and <a href="https://github.com/cemkeylan/sysmgr">service supervisor</a>. I maintain all those packages on KISS -Community Repository as well with the exception of busybox. Those -are, <code>busybox init/runit</code>, <code>runit</code>, <code>sinit</code>, and <code>sysmgr</code>. I would -definitely recommend checking out <code>shinit</code> and <code>sysmgr</code>.</p> - -<h2>Why I don&rsquo;t publicize Carbs</h2> - -<p>There are a couple of reasons I don&rsquo;t publicize Carbs a lot.</p> - -<p>KISS is the better alternative in terms of support and community. -I work on maintaining this distribution just as hard as Dylan, -but in the end, Carbs is based on his original hard work, and I -believe that he deserves the recognition more than I do.</p> - -<p>Since I cannot answer questions like &ldquo;What is the difference?&rdquo;, I -prefer staying as the silent sibling project of KISS Linux. Plus, -there is no point in dividing the newly-emerging community in half.</p> - -<p>That&rsquo;s not because I don&rsquo;t have ideas for the future of Carbs, I -do. I just think that I will deserve the recognition once those -above lists are checked.</p> - -<p>I think that&rsquo;s about it, if you have questions you can send me a -mail, ping me on IRC (my handle is <code>merakor</code>), and I will be happy -to answer. Maybe your question fits this post, and I can update it -to thoroughly give an explanation.</p> - -<p>Cheers, -Cem</p></description> -</item> -<item> -<title>Outsource Repository Concept</title> -<pubDate>Fri, 10 Apr 2020</pubDate> -<dc:creator>Cem Keylan</dc:creator> -<link>https://carbslinux.org/blog/20200410.html</link> -<description><h1>Outsource Repository Concept</h1> - -<p>In April 3rd, I have added submodule support for Carbs -Linux&rsquo;s fork of <code>kiss</code>. Now, from that sentence, it really -doesn&rsquo;t sound exciting at all. But in reality, it opens a -path to lots of creative output, and a better way to manage -multi-user repositories (such as KISS Community).</p> - -<p>When managing a repository of submodules, the repository -maintainer&rsquo;s only job is to deal with adding packages. -A package maintainer doesn&rsquo;t have to wait for the repository -maintainer to update their packages, as they are only making -the changes to their own repositories.</p> - -<p>This way, an end-user can also track from their preferred -maintainers, and do that with the tidyness of a single repository -in their <code>KISS_PATH</code>.</p> - -<p>Carbs Linux now has an outsource repository for some packages. -Firefox and its dependencies have been purged from the main repository, -but can be found on it.</p> - -<p><a href="https://github.com/CarbsLinux/outsource">https://github.com/CarbsLinux/outsource</a></p></description> -</item> -<item> -<title>Roadmap for Carbs</title> -<pubDate>Mon, 06 Apr 2020</pubDate> -<dc:creator>Cem Keylan</dc:creator> -<link>https://carbslinux.org/blog/20200406.html</link> -<description><h1>Roadmap for Carbs</h1> - -<p>It has been a busy week. There are lots of changes in -direction, and more to come. I want to talk a little -about all of them.</p> - -<h2>Carbs Linux Server Going Down</h2> - -<p>It became harder to maintain and pay for the server, and I will be -shutting it down in May. I am currently in the phase of -carrying over everything to <a href="https://github.com/CarbsLinux">Github</a>. The repository and the -website is served on Github now. I have also moved the <a href="https://github.com/CarbsLinux/wiki/wiki">Wiki</a> -to Github and anyone can edit it there. There are some outdated -posts that I will be fixing around this week.</p> - -<p>I am not quite sure where to store the downloads page now. But I -will be switching that to a new source as well. (Maybe Source Forge?)</p> - -<p>I feel a little sad for switching, but serving on Github is faster, -cheaper, and hassle-free.</p> - -<h2>Forking KISS</h2> - -<p>I had a personal fork of KISS, which I enjoyed thoroughly. I didn&rsquo;t -intend to make it the default when I started it, but it has matured -enough to be so. The package manager can now be found on <a href="https://github.com/CarbsLinux/kiss">this repository</a>. -See it for the added changes.</p> - -<p>This will be a change for the better, as I can develop the package -manager as it fits my views.</p> - -<h2>Small Changes on the Website</h2> - -<p>I have made some small changes on the website. The build is not dependent -on Plan9 utilities anymore. It was fun messing around with <code>rc</code> and <code>mk</code>, -but they are quite limited compared to POSIX shell.</p> - -<p>RSS feeds are finally working as intended, both for the <a href="https://carbslinux.org/news.xml">news</a> section, and -the <a href="https://carbslinux.org/rss.xml">blog</a> secion.</p> - -<p>You can see every page&rsquo;s <code>.txt</code> output at the end of the page by clicking -&lsquo;View Page Source&rsquo;. Meanwhile, I will be updating some pages to be a little -more &lsquo;human-readable&rsquo;.</p> - -<h2>Outsources Repository</h2> - -<p>I have opened an <code>outsource</code> repository, which I will be pushing this week. -I will add a new post when I am ready to push it. I think it will be interesting, -it will also make more sense about the changes I have added to the package -manager. The now empty repository, can be found <a href="https://github.com/CarbsLinux/outsource">here</a>!</p> - -<h2>New Tarball</h2> - -<p>Finally, I have released a new tarball today, which can be obtained from the -<a href="https://dl.carbslinux.org/releases">downloads page</a>.</p> - -<p>I am planning to add more of these update posts as I&rsquo;m feeling better about -the website structure overall.</p> - -<p>- Cem</p></description> -</item> -<item> -<title>Switching to New Website</title> -<pubDate>Tue, 28 Jan 2020</pubDate> -<dc:creator>Cem Keylan</dc:creator> -<link>https://carbslinux.org/blog/20200128.html</link> -<description><h1>Switching to New Website</h1> - -<p><strong>Date:</strong> Jan 28 2020</p> - -<p>In case you haven&rsquo;t seen it before, this website -was powered by <a href="http://werc.cat-v.org">werc</a>. And -even though I liked it really much, it was too -powerful for a small website like this.</p> - -<p>So I have decided to reimplement this website with -my own static generation scripts. The source will -probably be on <a href="https://carbslinux.org/git/website/log.html">https://carbslinux.org/git/website/log.html</a> -when I decide to publish the website.</p> - -<p>The generation requires Plan9 programs, although -I have used them just for my enthusiasm. I have built -the site with a combination of mk (instead of make), rc, -and POSIX sh. I am not yet exactly familiar with rc, -but I will replace the shell scripts when I feel like -I can.</p></description> -</item> - </channel> -</rss> diff --git a/src/style.css b/src/style.css deleted file mode 100644 index 74eebb9..0000000 --- a/src/style.css +++ /dev/null @@ -1,117 +0,0 @@ -/* Cem Keylan (C) 2019-2020 */ - -:root { - --color0: #0A1E2B; - --color1: #5C5B6F; - --color2: #9B506D; - --color3: #C34266; - --color4: #7B9BB7; - --color5: #BF6790; - --color6: #6a9faf; - --color7: #A676D2; - --color8: #8b8288; - --color9: #5C5B6F; - --color10: #9B506D; - --color11: #C34266; - --color12: #4E708D; - --color13: #BF6790; - --color14: #528899; - --color15: #c7bac3; - --fg: #0a1e2b; - --bg: #ffffff; - --altbg: #bf6790; - --link: #bf6790; - --linkalt: #4e708d; -} - - -html { - background-color: var(--bg); - font-family: monospace; - font-size: 16px; - color: var(--fg); - padding-bottom: 100px; - -webkit-text-size-adjust: 100%; - -ms-text-size-adjust: 100%; - -ms-overflow-style: scrollbar; - -webkit-tap-highlight-color: transparent; -} -.header { - text-align: center; -} -.header strong{ - color: var(--color5) -} -.header a{ - text-decoration: none; - text-align: center; - color: var(--fg); - margin-left: 10px; - margin-right: 10px; -} -.header a:hover{ - text-decoration: none; - text-align: center; - color: var(--linkalt); - margin-left: 10px; - margin-right: 10px; -} -.border { - padding-top: 1%; - border-bottom: solid 2px; - color: var(--fg); -} -a { - text-decoration: none; - font-weight: bold; - color: var(--link); -} -a:hover { - text-decoration: underline; - font-weight: bold; - color: var(--linkalt); -} -.post-title { - text-align: center; -} -ul li::before { - color: var(--color4); -} -body { - width: 80%; - max-width: 1050px; - margin-left: auto; - margin-right: auto; - margin-top: 20px; - overflow: none; - overflow-y: scroll; - padding-right: 10px; - padding-left: 10px; - color: var(--fg); -} -code { - color: var(--fg); - content: "> "; -} -p,tr,td,table { color: var(--fg); } -h1 { - color: var(--color7); - font-weight: bolder; -} -h2 { - color: var(--color4); - font-weight: bold; -} -h3 { - color: var(--fg); - font-weight: bold; -} -.footer { - text-align: center; -} - -pre { margin-left: 2em; } -blockquote { - border-left: 1px solid var(--color6); - font-style: italic; -} diff --git a/style b/style new file mode 160000 +Subproject dc3edbc26c28205b5ccf697ff3ef2acd001e1a5 diff --git a/templates/blog-index b/templates/blog-index deleted file mode 100644 index b00877c..0000000 --- a/templates/blog-index +++ /dev/null @@ -1,8 +0,0 @@ -Blog Index -================================================================================ - -This is the Carbs Linux Blog Index. You can find every post here. [RSS Feed] - -[RSS Feed]: /rss.xml - - diff --git a/templates/blog.org b/templates/blog.org new file mode 100644 index 0000000..4f8cb2d --- /dev/null +++ b/templates/blog.org @@ -0,0 +1,3 @@ +#+TITLE: Blog Index + +This is the Carbs Linux blog index. You can find every post here. [[file:../rss.xml][RSS Feed]] diff --git a/templates/postamble.html b/templates/postamble.html new file mode 100644 index 0000000..bbb22c2 --- /dev/null +++ b/templates/postamble.html @@ -0,0 +1,4 @@ +<footer> + <p>Linux® is a registered trademark of Linus Torvalds</p> + <p>Copyright © 2019-2021 Cem Keylan</p> +</footer> diff --git a/templates/preamble.html b/templates/preamble.html new file mode 100644 index 0000000..e9f3578 --- /dev/null +++ b/templates/preamble.html @@ -0,0 +1,14 @@ +<nav id="navbar"> + <a href="/" class=navbartitle>Carbs Linux</a> + + <label for="hamburger">☰</label> + <input type="checkbox" id="hamburger" /> + <ul id=navbarlist> + <li><a href="/" title="Home Page">Home</a></li> + <li><a href="//git.carbslinux.org" title="Git Repository">Git</a></li> + <li><a href="/download.html" title="Download Carbs Linux">Download</a></li> + <li><a href="/blog" title="Blog Posts">Blog</a></li> + <li><a href="/install.html" title="Installation Instructions">Installation</a></li> + <li><a href="/docs.html" title="Documentation">Docs</a></li> + </ul> +</nav> diff --git a/templates/rss.xml b/templates/rss.xml deleted file mode 100644 index cb45b89..0000000 --- a/templates/rss.xml +++ /dev/null @@ -1,15 +0,0 @@ -<?xml version="1.0" encoding="UTF-8"?> -<rss version="2.0" - xmlns:atom="http://www.w3.org/2005/Atom" - xmlns:dc="http://purl.org/dc/elements/1.1/" - xmlns:sy="http://purl.org/rss/1.0/modules/syndication/" -> - <channel> - <title>Carbs Linux</title> - <description>a simple linux distribution</description> - <link>https://carbslinux.org</link> - <atom:link href="https://carbslinux.org/{{ SRC }}" rel="self" type="application/rss+xml" /> - <lastBuildDate>{{ DATE }}</lastBuildDate> - {{ CONTENT }} - </channel> -</rss> diff --git a/templates/template.html b/templates/template.html deleted file mode 100644 index f79569c..0000000 --- a/templates/template.html +++ /dev/null @@ -1,28 +0,0 @@ -<!DOCTYPE HTML> -<html lan=en> - <head> - <title>{{ TITLE }}</title> - <link rel="stylesheet" href="/style.css"> - <meta charset="utf-8"> - <meta name="Description" content="Carbs Linux - a simple linux distribution"> - <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no"> - </head> - <body> - <p class=header><strong>Carbs Linux - a simple linux distribution</strong></p> - <div class="header"> - <nav> - <a href='/'>index</a> - <a href="//git.carbslinux.org">git</a> - <a href='//dl.carbslinux.org'>downloads</a> - <a href='/blog'>blog</a> - <a href='/docs/install.html'>installation</a> - <a href='/docs'>user manual</a> - </nav> - </div><div class="border"></div> - {{ CONTENT }} - <a href="{{ SRC }}">View Page Source</a> - <div class="border"></div> - <p class=footer>Linux® is a registered trademark of Linus Torvalds</p> - <p class=footer>Copyright © 2019-2021 Cem Keylan</p> - </body> -</html> diff --git a/texidocs b/texidocs -Subproject 4bb8046231dd10eec27aff6a409e9f428ad5ac7 +Subproject 5c695d67f68d2c8d921b77fd881ba121c142f6f |