Difference between revisions of "Help talk:Reading"

From ArchWiki
Jump to: navigation, search
(update templates, see Help:Style)
(Mention tab completion?: re)
 
(56 intermediate revisions by 8 users not shown)
Line 6: Line 6:
 
Just like article:[[ABS]] is referred to in every page that involves compiling, this page could serve the same kind of utility.
 
Just like article:[[ABS]] is referred to in every page that involves compiling, this page could serve the same kind of utility.
  
==Revision criteria==
+
{{Unsigned|16:39, 12 November 2009 (UTC)|Manolo}}
sudo was removed because $ is already indicating that it should be ran as normal user, or ''should'' be indicating that in all articles. And it's not part of the core packages nor the intent of the article. [[User:Manolo|manolo]] 13:42, 12 November 2009 (EST)
+
  
:Sudo was added, to make it clear to the reader that sudo is something extra they need to install and configure in order to use it. If you search for sudo in the wiki you will see it is mentioned quite a bit. I'm fine whether it is included in this page or not. I did make it too verbose, maybe a short note should suffice. [[User:M l|M l]] 15:59, 12 November 2009 (EST)
+
== Meaning of comment: location in the article ==
  
----
+
The meaning of a code comment is mentioned in [[Help:Reading#Regular_user_or_root]], which is before [[Help:Reading#Append.2C_add.2C_create.2C_edit]] linked throughout the wiki (the [[Create]], [[Edit]] and similar redirects). -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 14:38, 5 July 2016 (UTC)
Section [[Help:Reading#Common shell files]] should be merged with [[Bash]] and [[Zsh]]. [[User:Manolo|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? [[User:M l|M l]] 16:42, 13 November 2009 (EST)
+
:And what is the problem? We can either avoid the forward reference ("''Append'' to {{ic|~/path/to/file}}) in [[Help:Reading#Regular_user_or_root]] or keep the root prompts in [[Help:Reading#Append.2C_add.2C_create.2C_edit]]. -- [[User:Lahwaacz|Lahwaacz]] ([[User talk:Lahwaacz|talk]]) 19:02, 5 July 2016 (UTC)
  
::Yes, but the common files section is specific to Bash and Zsh. Repetition would still be avoided, articles could be:
+
::The idea was that linking [[textedit]] doesn't mention comments or root prompts. By itself however, the structure of [[Help:Reading]] makes sense (if the concept of root prompt is known, demonstrating how to edit system files is easy). Perhaps we should simply generalize the redirects, pointing them to [[Help:Reading]] ? -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 14:08, 26 August 2016 (UTC)
  
:::Add to [[Bash#Configuration|Bash]] files:
+
== Mention tab completion? ==
      # This alias makes ls colorize the listing
+
      alias ls='ls --color=auto'
+
  
::Instead of what we have now:
+
Tab completion makes enabling services and other common commands far easier, also regarding the [[Installation]]. I've added a note to the Installation guide for now [https://wiki.archlinux.org/index.php?title=Installation_guide&diff=442022&oldid=441809], but I think it's better in the long term to mention it here instead. -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 14:23, 18 July 2016 (UTC)
  
:::Add the following using [[nano]], or [[vim]] to {{ic|~/.bashrc}} for personal settings, or {{ic|/etc/bash.bashrc}} for system-wide changes:
+
:Mentioned in [https://wiki.archlinux.org/index.php?title=Help:Reading&diff=442050&oldid=435992], but maybe we should point out that some configuration will be needed ([[Bash#Tab_completion]], [[Zsh#Installation]]/[[Zsh#Command completion]]). -- [[User:Lahwaacz|Lahwaacz]] ([[User talk:Lahwaacz|talk]]) 17:08, 18 July 2016 (UTC)
      # 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]].
+
::Another thing, what convention should we use when indicating a certain command can be tab-completed? E.g. [[Installation_guide#Connect_to_the_Internet]] uses {{ic|systemctl stop dhcpcd@'''<TAB>'''}}. -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 13:59, 11 September 2016 (UTC)
  
::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.
+
==<s> Creating directories </s>==
  
::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.
+
Since it's not a far stretch to go from "Create a file" to "Create a directory", should we add a reference to ''mkdir'' e.g. via [[Core utilities#mkdir]] ? -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 12:05, 4 September 2016 (UTC)
 +
 
 +
:The [[Help:Reading#Append, add, create, edit]] section heading doesn't specify "files", so a link to [[Core utilities#mkdir]] can fit in a new paragraph at the bottom. – [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 09:43, 5 September 2016 (UTC)
 +
 
 +
::I hope [https://wiki.archlinux.org/index.php?title=Help:Reading&diff=449496&oldid=448582] is acceptable -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 12:45, 5 September 2016 (UTC)
 +
 
 +
:::Sure is, thanks, I've taken the chance to do some more [https://wiki.archlinux.org/index.php?title=Help:Reading&diff=449641&oldid=449496 edits], closing. — [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 14:43, 6 September 2016 (UTC)

Latest revision as of 13:59, 11 September 2016

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 ~~~~!

Meaning of comment: location in the article

The meaning of a code comment is mentioned in Help:Reading#Regular_user_or_root, which is before Help:Reading#Append.2C_add.2C_create.2C_edit linked throughout the wiki (the Create, Edit and similar redirects). -- Alad (talk) 14:38, 5 July 2016 (UTC)

And what is the problem? We can either avoid the forward reference ("Append to ~/path/to/file) in Help:Reading#Regular_user_or_root or keep the root prompts in Help:Reading#Append.2C_add.2C_create.2C_edit. -- Lahwaacz (talk) 19:02, 5 July 2016 (UTC)
The idea was that linking textedit doesn't mention comments or root prompts. By itself however, the structure of Help:Reading makes sense (if the concept of root prompt is known, demonstrating how to edit system files is easy). Perhaps we should simply generalize the redirects, pointing them to Help:Reading ? -- Alad (talk) 14:08, 26 August 2016 (UTC)

Mention tab completion?

Tab completion makes enabling services and other common commands far easier, also regarding the Installation. I've added a note to the Installation guide for now [1], but I think it's better in the long term to mention it here instead. -- Alad (talk) 14:23, 18 July 2016 (UTC)

Mentioned in [2], but maybe we should point out that some configuration will be needed (Bash#Tab_completion, Zsh#Installation/Zsh#Command completion). -- Lahwaacz (talk) 17:08, 18 July 2016 (UTC)
Another thing, what convention should we use when indicating a certain command can be tab-completed? E.g. Installation_guide#Connect_to_the_Internet uses systemctl stop dhcpcd@<TAB>. -- Alad (talk) 13:59, 11 September 2016 (UTC)

Creating directories

Since it's not a far stretch to go from "Create a file" to "Create a directory", should we add a reference to mkdir e.g. via Core utilities#mkdir ? -- Alad (talk) 12:05, 4 September 2016 (UTC)

The Help:Reading#Append, add, create, edit section heading doesn't specify "files", so a link to Core utilities#mkdir can fit in a new paragraph at the bottom. – Kynikos (talk) 09:43, 5 September 2016 (UTC)
I hope [3] is acceptable -- Alad (talk) 12:45, 5 September 2016 (UTC)
Sure is, thanks, I've taken the chance to do some more edits, closing. — Kynikos (talk) 14:43, 6 September 2016 (UTC)