Help talk:Reading

From ArchWiki
Revision as of 09:47, 20 October 2015 by NonerKao (talk | contribs) (discussion about Help:Reading#Bash)
Jump to navigation Jump to search

Purpose

Besides covering basic differentiations, this article could serve to improve the quality of the Wiki by avoiding repetition. How many articles say: "edit in ~/.bashrc, or zhrc (if you're using zsh) -- alternatively, edit /etc/profile.bash for system-wide changes" or something to that effect? And even though it sounds counterintuitive, expanding this article makes the Wiki better for advanced users as well, since they won't be presented with the same old information they're accustomed to skip.

We could have a basic run down of common file locations and what they mean, instead of explaining them in every article. Editors can just say "add the following to the shell's configuration" and readers would then decide whether they want it system-wide or not, etc.

Just like article:ABS is referred to in every page that involves compiling, this page could serve the same kind of utility.

—This unsigned comment is by Manolo (talk) 16:39, 12 November 2009 (UTC). Please sign your posts with ~~~~!

Merge Common Shell files

Section Help:Reading#Common shell files should be merged with Bash and Zsh. manolo 14:53, 13 November 2009 (EST)

I think that 'Common shell files' should be in their respected pages. And remove any mention of common files. Is it not the purpose of this page to make the wiki in general easier to read and remove repetition? M l 16:42, 13 November 2009 (EST)
Yes, but the common files section is specific to Bash and Zsh. Repetition would still be avoided, articles could be:
Add to Bash files:
      # This alias makes ls colorize the listing
      alias ls='ls --color=auto'
Instead of what we have now:
Add the following using nano, or vim to ~/.bashrc for personal settings, or /etc/bash.bashrc for system-wide changes:
      # This alias makes ls colorize the listing
      alias ls='ls --color=auto'
Don't forget to source the file in order to blahblah:
      $ source /etc/bash.bashrc
Tip: 'source' can be abbreviated with '.' (a dot).
Strictly speaking, $ and # differentiation is also specific to Bash, but for the sake of consistency every article should be using Bash-style denotation instead of "run as root" or "if using zsh, the root prompt will look different" etc. etc., so that excerpt belongs here. The same reasons apply with editing and sourcing. Although I do see why somebody else would argue that it also belongs in Bash.
And the last section leads to other repetitive tasks that should not be repeated in every article. This is temporary, and once all editors conform to not including pacman and rc.conf tutorials in their docs, it'll be removed.
I.e., this article is about interpreting the wiki (but will not include sections that belong in other articles). The new to GNU/Linux introduction part is a bit misleading.
—This unsigned comment is by Manolo (talk) 22:05, 13 November 2009‎ (UTC). Please sign your posts with ~~~~!

About Help:Reading#Bash

First of all, it's very confusing that such detailed description appears in such generic topic. Why wouldn't just mention the two configutration files like:

/etc/bash.bashrc: A system-wide setting for bash;
~/.bashrc: A personal shell setting for bas.

And then give some reference to Bash at the end of this topic? It would also be more compatible to the section title "System-wide versus user-specific configuration", instead of distinguishing login/interactive shells.

I have one more question about this paragraph, though it seems corresponds to Bash more than this article. According to this stackoverflow thread, a bash environment spawn by terminal simulator like gnome-terminal will shouldn't be a login shell, since it has nothing to do with "login" in to this system. However, after some experiments, I found that a new page of gnome-terminal sources both configuration files. That is to say, either the paragraph

/etc/bash.bashrc: System-wide settings; sourced only by a login shell
~/.bashrc: Personal shell settings; sourced only by an interactive shell

or the stackoverflow thread is wrong. Which is the correct one?

Thanks for any response.

BTW, I am new to contribute to ArchWiki. If I do anything wrong or not good, please let me know. Many thanks!

--NonerKao (talk) 09:47, 20 October 2015 (UTC)