{"action":"opened","issue":{"url":"https://api.github.com/repos/systemd/systemd/issues/295","labels_url":"https://api.github.com/repos/systemd/systemd/issues/295/labels{/name}","comments_url":"https://api.github.com/repos/systemd/systemd/issues/295/comments","events_url":"https://api.github.com/repos/systemd/systemd/issues/295/events","html_url":"https://github.com/systemd/systemd/issues/295","id":89446520,"number":295,"title":"localectl documentation should be more transparent","user":{"login":"archenemies","id":12960503,"avatar_url":"https://avatars.githubusercontent.com/u/12960503?v=3","gravatar_id":"","url":"https://api.github.com/users/archenemies","html_url":"https://github.com/archenemies","followers_url":"https://api.github.com/users/archenemies/followers","following_url":"https://api.github.com/users/archenemies/following{/other_user}","gists_url":"https://api.github.com/users/archenemies/gists{/gist_id}","starred_url":"https://api.github.com/users/archenemies/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/archenemies/subscriptions","organizations_url":"https://api.github.com/users/archenemies/orgs","repos_url":"https://api.github.com/users/archenemies/repos","events_url":"https://api.github.com/users/archenemies/events{/privacy}","received_events_url":"https://api.github.com/users/archenemies/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":0,"created_at":"2015-06-19T02:18:49Z","updated_at":"2015-06-19T02:18:49Z","closed_at":null,"body":"Hello! I just installed Arch and it's my first time using systemd. I had a couple of confused moments where I was wondering why /etc/vconsole.conf would periodically change. Also didn't understand how localectl was supposed to be working its magic - was there a daemon? After figuring things out I realized that neither localectl nor \"localectl --verbose\" (which doesn't exist) nor the localectl man page nor the /etc/vconsole.conf config file mentions that localectl parses and edits configuration files. The only one who plays nice is /etc/X11/xorg.conf.d/00-keyboard.conf: \"# Read and parsed by systemd-localed.\". Which is still a bit short of actually mentioning localectl, but at least gives you a lead to follow. I think it's a great system but wanted to share my experiences as a new user. I would suggest (a) updating the man page to tell people what's happening - which files are edited by which localectl commands, (b) adding comments to all configuration files which are automatically edited, saying who did it. This is recommended because there are two documented interfaces, localectl and emacs <config file>, and users should also be informed via documentation about how they relate.\r\n\r\nI got here from http://www.freedesktop.org/wiki/Software/systemd/ - \"File a New Bug Report\", I hope this is the right place to submit a feature request! Thanks!"}}