Add hint to GNUPGHOME environment variable

[justusbunsi]

With #19732, the default location for the .gnupg folder has changed. To mitigate this breaking change, users can specify the home directory for gnupg via $GNUPGHOME environment variable to keep using their current location.

[justusbunsi]

Trimmed the explicit new line as suggested. I was not sure whether an explicit line break would help the readability.

[wxiaoguang]

Trimmed the explicit new line as suggested. I was not sure whether an explicit line break would help the readability.

No worry in my mind. There will be no line break after rendering. There is no line break for the old document too. (two line breaks mean paragraph break when rendering)

[justusbunsi]

CI failure seems unrelated.

[zeripath]

Agh! this is a problem.

We shouldn't have set the repository root as the HOME directory.

This is not an appropriate directory especially as usernames can start with .

[wxiaoguang]

Agh! this is a problem.

I do not think it's a problem.

We shouldn't have set the repository root as the HOME directory.

repository.ROOT is the only directory can be used without breaking.No other directory (created by Gitea) could be used for the Git HOME. (overthinking, see new comment)

If we do not use repository.ROOT as Git HOME, then many users have to set an config option manually (a big breaking) (overthinking, see new comment)

This is not an appropriate directory especially as usernames can start with .

It won't. See the IsUsableUsername. OK, AlphaDashDotPattern is not ideal, it should be fixed.

Directories starting with dot have special meaning, it's already a good practice across OS.

[wxiaoguang]

Update: I over-thought something about the Git HOME problem.

Since it's fine to use a newly created directory in Gitea's data directory, there will a PR for it

---

Update: the PR:

• Use git.HOME_PATH for Git HOME directory #20114

[justusbunsi]

I guess #20114 makes the hint to that environment variable unrelated to 1.17 but still good to know for administrators. So I'll update this PR once the mentioned PR is done.

[wxiaoguang]

Let's wait for

• Use git.HOME_PATH for Git HOME directory #20114

Then the {[repository].ROOT} will be replaced by {[git].HOME_PATH} accordingly.

(put a blocked label here to prevent from accident merge)

[codecov-commenter]

Codecov Report

❗ No coverage uploaded for pull request base (main@87c563b). Click here to learn what that means.
The diff coverage is n/a.

@@           Coverage Diff           @@
##             main   #20134   +/-   ##
=======================================
  Coverage        ?   46.92%           
=======================================
  Files           ?      975           
  Lines           ?   134992           
  Branches        ?        0           
=======================================
  Hits            ?    63341           
  Misses          ?    63889           
  Partials        ?     7762           

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 87c563b...38fb53f. Read the comment docs.

[lunny]

#20114 merged, please resolve the conflicts.

[justusbunsi]

Conflicts resolved.

[lunny]

make L-G-T-M work.