docs: avoid creating symlink inside symlink to fonts

[robsonpeixoto]

A simple ln -s TARGET LINK_NAME will by default create a symlink with the name LINK_NAME if LINK_NAME is a file or will create a symlink inside LINK_NAME if LINK_NAME is a directory. For example:

$ ln -sv /home/linuxbrew/.linuxbrew/share/fonts ~/.local/share/fonts
'/home/my-user/.local/share/fonts' -> '/home/linuxbrew/.linuxbrew/share/fonts'

$ ln -sv /home/linuxbrew/.linuxbrew/share/fonts ~/.local/share/fonts
'/home/my-user/.local/share/fonts/fonts' -> '/home/linuxbrew/.linuxbrew/share/fonts'

$ ln -sv /home/linuxbrew/.linuxbrew/share/fonts ~/.local/share/fonts
ln: failed to create symbolic link '/home/my-user/.local/share/fonts/fonts': File exists

The parameter --no-dereference will tread the LINK_NAME as a file avoiding such problem:

$ ln --verbose --symbolic --no-dereference /home/linuxbrew/.linuxbrew/share/fonts ~/.local/share/fonts
'/home/my-user/.local/share/fonts' -> '/home/linuxbrew/.linuxbrew/share/fonts'

$ ln --verbose --symbolic --no-dereference /home/linuxbrew/.linuxbrew/share/fonts ~/.local/share/fonts
ln: failed to create symbolic link '/home/my-user/.local/share/fonts': File exists

[tani]

Thank you for revising our document. I would like to suggest the ln -s src -t dirname instead of your approach.

$ ln -s /home/linuxbrew/.linuxbrew/share/fonts -t ~/.local/share

I noticed that there still remains a problem in your approach.

$ mkdir ~/.local/share/fonts
$ ln --verbose --symbolic --no-dereference /home/linuxbrew/.linuxbrew/share/fonts ~/.local/share/fonts
'/home/tani/.local/share/fonts/fonts' -> '/home/linuxbrew/.linuxbrew/share/fonts'

Would you mind checking this behaviour? Best regards,

[robsonpeixoto]

I agree with you, @tani! Your solution is better.

[tani]

Anyway, thank you for your contribution!