Commit graph

92 commits

Author SHA1 Message Date
Naïm Favier a0e7ffe7aa
docs: use $ prompts for nix-channel commands
Channels should be added for the normal user, not for root, because the
home-manager configuration is not supposed to be evaluated as root.

Fixes https://github.com/nix-community/home-manager/issues/2985
2022-06-18 20:59:51 +02:00
Naïm Camille Favier 64ab7d6e8d
Prepare inclusion in nixos-search (#2971)
* Add flake.lock and clean up flake.nix

Add a lockfile to work around https://github.com/NixOS/nix/issues/6541
(and because it's a good idea anyway).

Also use flake-utils, and restrict ourselves to the five platforms
supported by nixpkgs. Otherwise, the IFD for nmd fails on weird
platforms. This fixes `nix flake check`.

Remove the redundant `apps` output, see https://github.com/nix-community/home-manager/pull/2442#issuecomment-1133670487

* nixos,nix-darwin: factor out into a common module

* nixos,nix-darwin: make `home-managers.users` shallowly visible

Make sure the option is included in the NixOS/nix-darwin manual (but the
HM submodule options aren't).

Also add a static description to the HM submodule type so that we don't need to
evaluate the submodules just to build the option manual. This makes
nixos-search able to index the home-manager flake.

Also clean up some TODOs.

* flake: add nmd and nmt

This avoids having to use `pkgs.fetchFromGitLab` in an IFD, which causes
issues when indexing packages with nixos-search because `pkgs` is
instantiated with every platform.
2022-06-07 20:45:06 +02:00
Robert Helgesson 684e85d01d
docs: set 22.11 as next version 2022-06-01 21:56:46 +02:00
Robert Helgesson ac2287df5a
docs: set 22.05 as stable version 2022-06-01 21:56:45 +02:00
Robert Helgesson acad715f78
docs: update copyright year 2022-06-01 21:42:55 +02:00
Robert Helgesson e66f0ff69a
docs: bump nmd 2022-05-23 23:09:24 +02:00
Farseen 8afee75d0d
dconf: note that system dconf must be enabled
Before enabling dconf in Home Manager, dconf must be enabled in system
config.

Otherwise it will fail like this:

```
$ home-manager switch
Starting Home Manager activation
Activating checkFilesChanged
Activating checkLinkTargets
Activating writeBoundary
Activating installPackages
replacing old 'home-manager-path'
installing 'home-manager-path'
Activating dconfSettings
error: GDBus.Error:org.freedesktop.systemd1.NoSuchUnit: Unit dconf.service not found.
```
2022-03-26 09:33:10 +01:00
Robert Helgesson ac94041153
docs: bump nmd
Fixes #2821
2022-03-24 00:41:16 +01:00
midchildan c7a13f76a7
launchd: initial support for LaunchAgents 2022-02-26 10:32:19 +01:00
Daniel Siepmann 5b208b42b2
docs: section how to update system 2022-02-17 22:57:52 +01:00
Caleb Chase 30082a623a
docs: fix standalone flake setup 2022-02-17 22:45:37 +01:00
Shamrock Lee 23a9f9127c
home-manager: add more pass-through options
Specifically, pass through --[extra-]experimental-features to Nix.
2022-02-15 22:45:59 +01:00
Shamrock Lee 03b7495183
docs: fix typo and clarify 2022-02-15 22:44:41 +01:00
Wout Mertens 7c2ae0bdd2
faq: explain how to let HM manage shell profiles 2022-02-13 00:02:53 +01:00
Shamrock Lee 85bbc6cc12
docs: move Nix Flakes documentation to manual
In the manual:
*   Add chapter Nix Flakes
*   Add links to sections of chapter "Using Home Manager"

In README.md:
*   Remove section "Nix Flakes"
*   Add manual reference at the buttom of section "Installation"
2022-02-10 22:15:03 +01:00
Thibault Lemaire fb939d1acf
docs: note how to get status of activation service
Add a note explaining how to get the output of the Home Manager
activation script when it's used as a NixOS module.
2022-01-28 23:01:26 +01:00
Robert Helgesson 1477eb1555
docs: add link to Matrix room
Fixes #2639
2022-01-16 18:48:01 +01:00
rcerc a5dd5d5f19
docs: clarify stand-alone installation instructions
Specifically,

- include system-wide Nixpkgs channel so `NIX_PATH` solution also
  works on multi-user installations;

- additionally link to Nix Discourse reply for more information on
  `NIX_PATH`; and

- remove note about relog on NixOS since all the channels in
  `~/.nix-defexpr/channels/` are included by default, so the Home
  Manager channel should be picked up automatically.
2022-01-14 00:49:04 +01:00
Robert Helgesson adaea605db
home-manager: document the --version command option
Fixes #2604
2022-01-02 08:33:32 +01:00
Robert Helgesson a3457d3f85
ci: verify that meta.maintainers evaluate
Fixes #2588
2021-12-29 10:16:19 +01:00
Robert Helgesson aef97988da
docs: add release note about translation support 2021-12-20 22:58:54 +01:00
polykernel c7592b747b
treewide: prefer XDG variables over dot directories
Currently, dot directories and XDG base directories are used
inconsistently in the Home Manager option declarations. This creates
ambiguity for the user as to where the location of the file should be
albeit this is rarely encountered in practice as it is sufficient to
read upstream documentation. The rationale is to make declarations
consistent and make a clear distinction between hardcoded and modular
specifications.

References to ~/.config in relevant nixpkgs modules were untouched as
the location is hardcoded upstream[1]. Furthermore, modules of
programs which do not follow XDG specifications were also untouched.

Generalization of tilde(~) expansions to $HOME were also considered,
however there isn't sufficient rationale despite the use of $HOME
being more universal. The expansion is standardized in POSIX[2] and is
essentially portable across all shells, thus there is no pragmatic
value to introducing the change.

[1] https://github.com/nixos/nixpkgs/blob/master/pkgs/top-level/impure.nix
[2] https://pubs.opengroup.org/onlinepubs/009695399/utilities/xcu_chap02.html#tag_02_06_01
2021-12-10 23:51:44 +01:00
Nicolas Berbiche 1aaa1a033b
docs: add note about Waybar modules 2021-12-03 18:57:59 +01:00
Nicolas Berbiche 290a188dad
docs: change stable from 21.05 to 21.11 2021-12-03 18:50:22 +01:00
Robert Helgesson 579f2e8beb
Switch to 22.05 as current development release 2021-11-25 22:29:49 +01:00
Robert Helgesson dc2a4e4146
Switch to 21.11 as stable release 2021-11-25 22:22:26 +01:00
oxalica df931a59a5
taskwarrior: change config file location and use relative theme paths (#2455)
After taskwarrior 2.6.0, its default config file now locates at
`$XDG_CONFIG_HOME/task/taskrc`, and builtin themes can be included
via relative paths.
2021-11-23 21:33:03 -05:00
Robert Helgesson 2452979efe
docs: bump nmd 2021-11-18 16:32:15 +01:00
Mmequignon d85bf67c48
pet: fix settings format issue
Before it was not possible to place setting values outside the
`General` section.
2021-11-17 23:42:21 +01:00
Robert Helgesson 2dcd9eb021
docs: minor rewording in usage documentation 2021-11-15 20:52:15 +01:00
Robert Helgesson c855cdde20
docs: make README refer to installation chapter
This gives a single source of truth of installation instructions and
we can also point to instructions for the NixOS and nix-darwin
modules.
2021-11-15 20:51:45 +01:00
Robert Helgesson e785e67977
docs: make text more specific about Nix 2.4 support 2021-11-15 19:58:09 +01:00
Robert Helgesson 0f5d93119c
docs: move usage section to chapter in manual
Also expand the chapter in various ways.
2021-11-14 00:13:54 +01:00
Nicolas Berbiche 2e1a5b53ec
xsession: don't reset the inherited keyboard options
If the keyboard configuration is an empty set, don't run the setxkbmap
service.

The default values for all keyboard options are null or empty so long
as the state version is set to 19.09 or higher (21.05 being the latest
version).
2021-11-01 22:42:47 +01:00
Robert Helgesson a77a01d1f6
docs: bump nmd
This revision support the new `literalExpression` documentation type.
2021-10-12 23:42:17 +02:00
Thiago Kenji Okada 32285d8fe6
rofi: remove options removed from upstream in v1.7.0 2021-10-09 00:45:20 +02:00
Kid 88f9b33384
docs: update session variables suggestion for Fish 2021-10-04 20:30:22 +02:00
Robert Helgesson eee807560b
dbus: improve recommended NixOS configuration
Specifically, instead of

    services.dbus.packages = with pkgs; [ gnome.dconf ];

we now recommend

    programs.dconf.enable = true;

which does the same and more.
2021-09-23 22:35:30 +02:00
Romanos Skiadas 2952168ed5
docs: update session-vars info about fish shell
The docs implied that fish was not really supported, but if fish is
managed by Home Manager, the generated config does use fenv to source
the session-vars file. Update the installation instructions and FAQ to
mention that fish does work, and mention fenv in the README.
2021-09-04 23:12:17 +02:00
Tanya Bouman f637e145d7
docs/manual: describes -> describe 2021-08-26 09:04:20 +02:00
c4605 1a6df903e3
home-manager: add command line argument --impure 2021-08-19 00:07:49 +02:00
Robert Helgesson 7ef3db3730
docs: rename "doc" directory to "docs"
Also remove `CONTRIBUTING.adoc` and `FAQ.adoc` from project root since
GitHub knows to pick them up from the docs directory.

Fixes #2273
2021-08-17 19:35:11 +02:00