From 21c557b6fe64d0755f7b3603e7e4a22135d51ab6 Mon Sep 17 00:00:00 2001 From: Martin Fick Date: Mon, 31 Aug 2015 16:03:24 -0600 Subject: [PATCH] Move 'User Refs' docs to the intro-user doc. Since there are more uses than just the named queries for the user refs in All-Users, move the docs describing the refs to its own section where it can be referenced by other sections. Reference it from the 2 feature sections which currently make use of it. Change-Id: Ia95d25ca61df1c7df91dfd6bfede32acdcf65b20 --- Documentation/intro-user.txt | 12 ++++++++++++ Documentation/user-named-queries.txt | 14 +++++--------- 2 files changed, 17 insertions(+), 9 deletions(-) diff --git a/Documentation/intro-user.txt b/Documentation/intro-user.txt index 458484158c..b9bdad0999 100644 --- a/Documentation/intro-user.txt +++ b/Documentation/intro-user.txt @@ -563,11 +563,23 @@ The project owner may enable link:user-upload.html#auto_merge[ auto-merge on push] to benefit from the automatic merge/rebase on server side while pushing directly into the repository. +[[user-refs]] +== User Refs + +User configuration data such as link:#preferences[preferences] is +stored in the `All-Users` project under a per-user ref. The user's +ref is based on the user's account id which is an integer. The user +refs are sharded by the last two digits (`+nn+`) in the refname, +leading to refs of the format `+refs/users/nn/accountid+`. + [[preferences]] == Preferences There are several options to control the rendering in the Gerrit web UI. Users can configure their preferences under `Settings` > `Preferences`. +The user's preferences are stored in a `git config` style file named +`preferences.config` under the link:#user-refs[user's ref] in the +`All-Users` project. The following preferences can be configured: diff --git a/Documentation/user-named-queries.txt b/Documentation/user-named-queries.txt index 0ddbbeffb1..e79b3da246 100644 --- a/Documentation/user-named-queries.txt +++ b/Documentation/user-named-queries.txt @@ -3,15 +3,11 @@ [[user-named-queries]] == User Named Queries It is possible to define named queries on a user level. To do -this, define the named queries in the `queries` file of -the user's account ref in the `All-Users` project. The user's -account ref is based on the user's account id which is an -integer. The account refs are sharded by the last two digits -(`+nn+`) in the refname, leading to refs of the format -`+refs/users/nn/accountid+`. The user's queries file is a -2 column tab delimited file. The left column represents the -name of the query, and the right column represents the query -expression represented by the name. +this, define the named queries in the `queries` file under the +link:intro-user.html#user-refs[user's ref] in the `All-Users` project. The +user's queries file is a 2 column tab delimited file. The left +column represents the name of the query, and the right column +represents the query expression represented by the name. Example queries file: