Page 1 of 1

Users Manual 20160701

Posted: Sun Jul 03, 2016 10:01 am
by Jerry3904
The new version is up--remember to refresh your page to see it.

Changes
  • New sections on some MX Tools, Static DNS, few others
  • Many new and revised images
  • Bunch of corrections
  • PDF link below Titles
Gordon's PDF is up too, and he will post info for translators.

Use this thread for corrections and comments/suggestions, though nothing is going to be changed (except something critical) for a good long while for lack of time.

Re: Users Manual 20160701

Posted: Sun Jul 03, 2016 12:03 pm
by lucky9
Thank you all for this update.

Re: Users Manual 20160701

Posted: Mon Jul 04, 2016 12:06 am
by Gordon Cooper
Translation Update Information.

In opening this thread, Jerry has provided a summary of the changes in this July 2016 version of the MX15 Manual. Most of the text changes are in the early Manual Sections
and will require some updating of translations already completed. The revision of images - done principally to reduce file sizes - is spread through most Sections.

Like Jerry, I am going to be short on spare time - for July at least - so will not attempt to update all the translations that were previously published in this forum.
New machine translations for the languages that we know are being worked on, that is : French, German, Greek, Italian and Spanish will be available from links in this thread ASAP. Hope to provide a list of the updates too. Will be happy to add other languages if required. Just ask on this forum thread. Will be contacting Bicyclist56 about the Russian translation too.

Re: Users Manual 20160701

Posted: Tue Jul 05, 2016 12:23 am
by Gordon Cooper
The text changes/corrections in this July version of the manual are listed here:

https://www.dropbox.com/s/3gz3ts5zb90x9 ... a.pdf?dl=0

Re: Users Manual 20160701

Posted: Tue Jul 05, 2016 5:29 am
by Jerry3904
Thanks a lot, Gordon! Good work down there in the middle of winter...

Re: Users Manual 20160701

Posted: Tue Jul 05, 2016 5:00 pm
by Richard
Thanks Gordon. Looking forward to the new *.odt.
New machine translations for the languages that we know are being worked on, that is : French, German, Greek, Italian and Spanish will be available from links in this thread ASAP.
...to see the Translation Memory of OmegaT from previous Chap.1-3 translation offer suggestions for new and modified sections.

Re: Users Manual 20160701

Posted: Wed Jul 06, 2016 2:21 am
by tascoast
Jerry3904 wrote:The new version is up--remember to refresh your page to see it.
....
I always wonder about this one. In web design I often worked with source and a browser window adjacent, hitting refresh when I wanted to preview changes. I recall setting my browser to load page always as opposed to using a cached version at that time too. I can't seem to find a similar setting in more recent times.

Thanks to Gordon for all the work involved.

Re: Users Manual 20160701

Posted: Wed Jul 06, 2016 10:39 pm
by skidoo
@tascoast
Ctrl + F5
If that isn't working for you, and your browser is firefox:
https://addons.mozilla.org/en-US/firefo ... he-button/
https://addons.mozilla.org/en-US/firefo ... load-plus/

Re: Users Manual 20160701

Posted: Wed Jul 06, 2016 11:43 pm
by Gordon Cooper
Also have had refresh problems here. F5 usually works but not always, so these days I clear the cache when in doubt.

Jerry is the person to thank for all the work on the manual, I'm very definitely the sub-Ed on this job.

Hope to post the Google translations tomorrow.

Re: Users Manual 20160701

Posted: Thu Jul 07, 2016 6:10 am
by Spartak77
Congratulations for the great work.
I saw a point in the new version of manual where it seems there is an error, or rather a loss.
In Paragraph “3.3.2Graphic driver”, after the line “When it finishes, type: service lightdm start to start lightdm and xorg again.” and before of “Basic adjustment”
I think that should be the name of a paragraph, for example “3.3.3 Fonts” as it was in the previous version of the manual.

Re: Users Manual 20160701

Posted: Thu Jul 07, 2016 6:22 am
by Jerry3904
Thanks! We have found a small number of minor problems already, and will add this to the list.

Re: Users Manual 20160701

Posted: Thu Jul 07, 2016 10:18 am
by Spartak77
Hi Jerry,
another strange point in "4.8.3 List of installed program packages" near the end of paragraph, it is written this:

"To reinstall ALL those packages at once: make sure that all needed repositories are enabled, then issue these commands one at a time:
su
dpkg \SpecialChar nobreakdash\SpecialChar nobreakdashset-selections < apps_installed.txt"

Is correct "dpkg \SpecialChar nobreakdash\SpecialChar nobreakdashset-selections < apps_installed.txt" ?

The same problem appears in "6.5.2 A useful script", here: 8 # cp -a -i \SpecialChar nobreakdash\SpecialChar nobreakdash”reply=no /mnt/sda1/username /home

Re: Users Manual 20160701

Posted: Thu Jul 07, 2016 10:42 am
by Jerry3904
Thanks again. The use of an upgraded version of Lyx introduced a whole bunch of problems that we did not see at first, and we then compounded those with our faulty image references. Both Gordon and I have had limited time this round for checking.

I won't be able to get back to actually doing anything until the end of this month, but we would like to have any problems that people find posted in this thread in the meantime.

Re: Users Manual 20160701

Posted: Thu Jul 07, 2016 8:41 pm
by bicyclist56
July 6 I have translated into Russian the above in July16_Update_Data.pdf. Summer things do not leave a lot of time... The document with the translation can be found here - https://cloud.mail.ru/public/65xh/jRRtG7PwQ

Re: Users Manual 20160701

Posted: Thu Jul 07, 2016 8:59 pm
by Jerry3904
Thanks! I will get it tomorrow.

Re: Users Manual 20160701

Posted: Fri Jul 08, 2016 12:16 am
by Gordon Cooper
Links for Open Document Google translate (machine translations, uploaded on 8 July are:

French : https://www.dropbox.com/s/x0hhihjv90frn ... 1.odt?dl=0
German : https://www.dropbox.com/s/0umbqsh0qadf7 ... 1.odt?dl=0
Greek : https://www.dropbox.com/s/82hhycvnt2hyz ... 1.odt?dl=0
Italian : https://www.dropbox.com/s/ws88knguwg6oy ... 1.odt?dl=0
Spanish : https://www.dropbox.com/s/c187rl914lbi7 ... 1.odt?dl=0
US English : https://www.dropbox.com/s/ykrodfi8jgxu5 ... 1.odt?dl=0

NOTE: (1) These are listed as a guide for our translation team and for anyone else interested. There will be some corrections/additions in a few weeks - the corrected MX User Manual (MXUM) versions will be released in PDF format available through the tab on the first page of the Forum.
(2) These files are considerably smaller than previous versions (about 10MB smaller) because of many changed image formats.

Re: Users Manual 20160701

Posted: Sun Jul 10, 2016 12:38 am
by Gordon Cooper
Have found errors in the PDF version of the July MX15 user manual and in the List of changes/corrections that I posted a few days ago, These relate to Section 6.6 Advanced MX Tools, where the sub-heading 6.6.1 is missing in the PDF, and item 20 (the last in the list of changes) has related mistakes. Will correct the PDF now, but it may not appear on the Forum link immediately. Will fix the changes list asap. The html manual is correct.

Re: Users Manual 20160701

Posted: Sun Jul 10, 2016 4:39 am
by aus9
slightly anal proof reading comment for your consideration.

6.5.3 Pre-installed user scripts
smxi
Written by a programmer named “h2”
That is not his name, he may not object to that tag but his real name can be easily found such as by running

Code: Select all

less /usr/sbin/smxi
#### Copyright (C) Harald Hope, sidux team members 2007-2010
2) I wonder if people with a laptop/netbook might like to see a section just for them. I run MX mainly on a tower and my laptop is not something I boast about it but having just recently installed MX on the laptop I noticed only brief mentions of power management and a larger section on wireless

eg I use the onboard laptop keyboard but some may use a bluetooth etc and bluetooth is mentioned in the manual but not much detail.

Please note I am not trying to suggest that I am some kind of expert. I am hopefully pointing out some things for your consideration. And the thrust and main points of your manual are fine by me, not that you need my endorsement as I am still new to MX.

cheers

Re: Users Manual 20160701

Posted: Sat Jul 16, 2016 4:24 pm
by Spartak77
Hi Jerry
I think that most probably you have already noted what I'm going to report, but it does not cost me nothing to report, and it could be useful. The problem is already reported as a Lyx error. We encountered this problem in section 4.8.3 and 6.5.2. I have seen that it is present also in section 7.3, Here:
7.3 Permissions
CLI

The -l switch will cause …...
-rw-r\SpecialChar nobreakdash\SpecialChar nobreakdashr\SpecialChar nobreakdash\SpecialChar nobreakdash newbie users 277 Jan 7 14:42 .asoundrc
The “rw-r\SpecialChar nobreakdash\SpecialChar nobreakdashr\SpecialChar nobreakdash\SpecialChar nobreakdash ” bit right after the opening dash (indicating it is a regular file) contains read/write/execute permissions for owner, group and others: 9 characters total. Here it shows that the owner has read and write but not execute (rw-), but the group and others can only read (r\SpecialChar nobreakdash\SpecialChar nobreakdash). The owner in this case is specified to be “newbie” who belongs to the group “users”.


Another small signaling to the point 4.2.2 Video. You write:

Troubleshooting: occasionally Skype

In "Troubleshooting: occasionally Skype" it seems that something is missing, seems that we have lost the continuation of the sentence. For example it seems more complete to me something like this: " Troubleshooting: occasionally Skype has sound issues: see section 4.1.3 Chat → Video Chat"

Re: Users Manual 20160701

Posted: Sat Jul 16, 2016 6:02 pm
by Jerry3904
Thanks.

We will turn to revising this at the end of the month, when we both will have some time again.

Re: Users Manual 20160701

Posted: Mon Jul 18, 2016 8:05 pm
by aus9
Hi

I wonder if a member has misunderstood, well I too may be wrong, but may have been mislead by a CLI command of apt-get dist-upgrade.
http://forum.mepiscommunity.org/viewtop ... 29#p388922

so to refresh the manual at section 1.6 correctly says
Whenever possible, a migration path is provided with distribution upgrades (i.e., apt-get dist-upgrade) so that users can avoid reinstallation
but in section 5.5.3
apt-get dist-upgrade Intelligently handles changing dependencies with new versions of packages
to be fair, members need to remember they are reading 5.5.3 because they are in section 5.5.

What I am suggesting is maybe change that wording to a larger explanation that
apt-get dist-upgrade Intelligently handles changing dependencies in upgrading from an older MX version like MX-14

and then add a note outside the box
apt-get upgrade is the command to run for those who prefer CLI to upgrade their packages if they are on the most recent MX verssion

Re: Users Manual 20160701

Posted: Mon Jul 18, 2016 10:53 pm
by Gordon Cooper
Thanks aus9. Have added your CLI comments to the list of things to be looked at at end of the month.

Re: Users Manual 20160701

Posted: Mon Jul 18, 2016 11:30 pm
by kmathern
aus9 wrote:and then add a note outside the box
apt-get upgrade is the command to run for those who prefer CLI to upgrade their packages if they are on the most recent MX verssion
I don't agree with this, see my comments in the other thread here: http://forum.mepiscommunity.org/viewtop ... 95#p388995.

Re: Users Manual 20160701

Posted: Tue Jul 19, 2016 12:06 am
by Gordon Cooper
Thanks Kent. Jerry will be reviewing everything in this thread, hopefully in a couple of weeks.

Re: Users Manual 20160701

Posted: Tue Jul 19, 2016 12:26 am
by skidoo
regarding http://mepiscommunity.org/wiki/system/root-access

As described in this post http://forum.mepiscommunity.org/viewtop ... 07#p389007
the info in the wiki page may need to be updated

Re: Users Manual 20160701

Posted: Tue Jul 19, 2016 7:17 am
by Jerry3904
Thanks to all for the ongoing suggestions.

Re: Users Manual 20160701

Posted: Tue Jul 19, 2016 7:33 pm
by aus9
I admit I am wrong, won't be the last time either. ;)

Re: Users Manual 20160701

Posted: Wed Jul 20, 2016 2:45 am
by skidoo
user manual shipped within the MX15 iso, at section 3.2, shows correct screenshot
but the online html and pdf show an outdated screenshot for MX Tools.

Re: Users Manual 20160701

Posted: Wed Jul 20, 2016 4:00 am
by Gordon Cooper
Thanks for the comment skidoo. We do try to keep up with the never ending changes and improvements. Being always perfect is impossible, we do try to keep up, but
sometimes must take breaks to sleep and eat.

Re: Users Manual 20160701

Posted: Wed Jul 20, 2016 12:19 pm
by Spartak77
Hi Jerry and Gordon, another little reporting.
In point 4.3.5 Video meeting
You provide an example of software. This:

“TeamViewer. Cross-platform application for Remote Support and Online Meetings. Free for private use.”

Ok, TeamViewer is a good freeware software. It has a Linux version but it is not an open-source application.
Why don't you add also an open-source software example? For example Jitsi.
Jitsi features: voip,chat, sharing and remote desktop, file transfare, video meeting,possibility of traffic encryption.

Re: Users Manual 20160701

Posted: Wed Jul 20, 2016 7:07 pm
by Gordon Cooper
skidoo wrote:user manual shipped within the MX15 iso, at section 3.2, shows correct screenshot
but the online html and pdf show an outdated screenshot for MX Tools.
Have now checked this. Figure 3.3, the MX Tools Dashboard was updated (along with several other other images) at the end of June. The files available from the Manuals Tab here on the forum are correct.

Re: Users Manual 20160701

Posted: Wed Jul 20, 2016 11:14 pm
by skidoo
Gordon Cooper wrote:
skidoo wrote:user manual shipped within the MX15 iso, at section 3.2, shows correct screenshot
but the online html and pdf show an outdated screenshot for MX Tools.
Have now checked this. Figure 3.3, the MX Tools Dashboard was updated (along with several other other images) at the end of June. The files available from the Manuals Tab here on the forum are correct.
Headscratch. I cleared my browser cache and rechecked:
http://www.mepiscommunity.org/user_manu ... /mxum.html
http://www.mepiscommunity.org/user_manual_mx15/mxum.pdf
Still seeing old screencap (depicted dialog is white bg with a gray pane, one of the entries is "Find Shares") in both (in the PDF, it is shown on pg38)

Re: Users Manual 20160701

Posted: Wed Jul 20, 2016 11:32 pm
by skidoo
Spartak77 wrote:Ok, TeamViewer is a good freeware software. It has a Linux version but it is not an open-source application.
Why don't you add also an open-source software example? For example Jitsi.
Jitsi features: voip,chat, sharing and remote desktop, file transfare, video meeting,possibility of traffic encryption.
I agree. Debian repositories contain packages for several alternative RDP apps
remmina, vinagre, gnome-rdp, xrdp
(remmina supports RDP, VNC, NX, XDMCP and SSH protocols)
(vinagre supports RDP, VNC, and SSH protocols)

On a related note, I wish the docs would help raise awareness + promote the open alternatives to Skype:
qTox: A stable, cross platform, decentralised Skype replacement https://www.reddit.com/r/linux/comments ... sed_skype/
qTox vs uTox ( http://utox.org ) https://www.reddit.com/r/projecttox/com ... %C2%B5tox/
http://wiki.mumble.info/wiki/Main_Page

Re: Users Manual 20160701

Posted: Thu Jul 21, 2016 12:43 am
by aus9
skidoo writes for mx-tools
Still seeing old screencap
confirmed ....run MX-Tools has no mention of usb unmounter but doc and PDF mention it under Utilities. Maybe I don't have an update to the doc at
/usr/local/share/doc/mxum.html ?

Re: Users Manual 20160701

Posted: Thu Jul 21, 2016 1:12 am
by skidoo
{blush} facepalm.
Sorry, for the bad report.
I was seeing that because it was a freshly-made pendrive and I had not yet updated the mx-docs package, mx-tools package, etc.
Now I understand that the "white background with gray frame" is the GUI for the __newer__ version.

Re: Users Manual 20160701

Posted: Thu Jul 21, 2016 2:49 am
by Gordon Cooper
skidoo wrote:{blush} facepalm.
Sorry, for the bad report.
I was seeing that because it was a freshly-made pendrive and I had not yet updated the mx-docs package, mx-tools package, etc.
Now I understand that the "white background with gray frame" is the GUI for the __newer__ version.
Not to worry, all is forgiven. That can happen to anyone. All users need to remember that the Manual writes/talks about MX as it is presented by the developers. The documentation and translation team are always at least half a step behind the changes. :blindfold:

Re: Users Manual 20160701

Posted: Thu Jul 21, 2016 11:24 am
by Spartak77
Hi, another feedback.
In “4.7.5 Kill runaway programs” Use magic SysRq key (REISUB)

you wrote: "Hold down Ctrl and Alt keys (sometimes only the left Alt key will work) along with the Alt-SysRq or Alt-PrtScrn key with another hand"

Are you sure that it is correct, "along with the Alt-SysRq or Alt-PrtScrn key"?

Because reading wikipedia seems correct so:
along with the SysRq or PrtScrn key.

And Ctrl, you need? I tried the commands on 3 computers in my house and it was not essential Ctrl; Alt SysRq REISUB was enough to shut down and restart the computers

Re: Users Manual 20160701

Posted: Thu Jul 21, 2016 1:47 pm
by skidoo
Use magic SysRq key (REISUB)
^---- is this recognized only from the context of a console? The manual doesn't mention that detail.

Re: Users Manual 20160701

Posted: Thu Jul 21, 2016 3:55 pm
by Spartak77
Hi skidoo, you don't have to open a terminal to use the magic SysRq key and reisub, they are all keys on the keyboard. However, it is true that the first keys in the reisub sequence, in particular the key “r” close the server X and the last keys are typed with the black monitor.
It seems to me that it is sufficiently understandable in the manual that you should not use the terminal to use the magic SysRq key because the "Kill runaway programs" section is divided into three methods:
desktop
Terminal
If the above solutions do not work

But it is true that's not all is so easy to understand. I wanted to try the commands but I had to do some attempts before seeing that the system worked. For example I tried initially to simultaneously press all listed keys, but I need at least 3 hands to do it.
Also initially I thought it was enough press ctrl+alt and SysRq, then release the keys and press the sequence of keys r-e-i-s-u-b, but nothing happened because I have to keep pressing the Alt + SysRq key while typing the reisub sequence (in Italian translation I have preferred to specify it) . It is obvious that if I had to press all the keys indicated in the manual together with the sequence r-e-i-s-u-b it isn't enough for me to have 3 hands..

Re: Users Manual 20160701

Posted: Thu Jul 21, 2016 4:08 pm
by Jerry3904
We would be very happy to see anybody draft an alternative description for us to consider...

Re: Users Manual 20160701

Posted: Thu Jul 21, 2016 4:35 pm
by Spartak77
Ok Jerry, I was going to correct my post adding this:“But I want to underline that the manual is a great work, done very well, and it is obvious that something needs to be perfected gradually”
However I think I can say that I haven't forget to inform of things to tweak, and about a month ago I sent Gordon a file with several suggestions on how to further clarify some points
Perhaps it can be misunderstood, but I send the reports not to criticize but in the spirit of improving toghether this great work, but this does not mean that I would not serve 3 hands to press all those keys

Re: Users Manual 20160701

Posted: Thu Jul 21, 2016 5:09 pm
by skidoo
eek! {deleted} posted to wrong thread

Re: Users Manual 20160701

Posted: Thu Jul 21, 2016 6:30 pm
by Jerry3904
Spartak77 wrote:Ok Jerry, I was going to correct my post adding this:“But I want to underline that the manual is a great work, done very well, and it is obvious that something needs to be perfected gradually”
However I think I can say that I haven't forget to inform of things to tweak, and about a month ago I sent Gordon a file with several suggestions on how to further clarify some points
Perhaps it can be misunderstood, but I send the reports not to criticize but in the spirit of improving toghether this great work, but this does not mean that I would not serve 3 hands to press all those keys
Sorry that I gave the wrong impression! I just meant that we would be happy to have less work to do, and that people who have a better idea are invited to post the actual text they would like to see instead.

Re: Users Manual 20160701

Posted: Sat Jul 23, 2016 8:07 am
by Jerry3904
To make this more explicit:

I would really appreciate it if one of you would post a complete improved description of the REISUB procedure sometime during the next week.

Then all I would have to do is test it and edit the text, saving a lot of time. TIA.

Re: Users Manual 20160701

Posted: Tue Jul 26, 2016 5:48 am
by Spartak77
Ok Jerry, soon I will send you the text, with a few little changes that I think makes it easier to execute those commands. Your text is fine, it is enough for me to delete a couple of keys and specify one or two things. However I am not an expert and I could be wrong, so I would send a suggestion which then must be controlled. For example I would remove the Ctrl key because it seems not essential and there is a practical problem to simultaneously press several keys with two hands, but I don't know if in some computer Ctrl is essential. However I will make a search before sending the text (I had already searched something before I write you). In addition there is a problem because I cannot write properly in English. My English is a school English and Google-Translate English, so I can send a text that then must be controlled and improved grammar and syntax. However in this case you may not control a lot, because I think to change only a few words in your text.


Another feedback

In section 4.8 Backup
at the end, before 4.8.1 Data
you write: "See also Section 6.6.2 Save system to live ISO".
There is a little wrong in the link. It is correct so:
See also Section 6.6.3 Save system to live ISO

Re: Users Manual 20160701

Posted: Tue Jul 26, 2016 9:28 am
by Jerry3904
Grazie!

Re: Users Manual 20160701

Posted: Thu Jul 28, 2016 10:17 am
by Spartak77
Jerry3904 wrote:I would really appreciate it if one of you would post a complete improved description of the REISUB procedure sometime during the next week.
here is my suggestion for that point in “4.7.5 Kill runaway programs”:

Use magic SysRq key (REISUB). Hold down Alt key along with the SysRq (or PrtScrn) key with another hand, then slowly, without release Alt-SysRq, press the keys R-E-I-S-U-B one after the other. Hold pressed each key of REISUB sequence for about 1 or 2 second before moving on to the next key in the sequence; your system should shut down correctly and reboot. The purpose of this magic key is to go through several stages that nurse your system safely out of a failure of some sort.
Going to press E key, you should see the graphical display disappear, but if nothing happens becouse this combination of keys don't work, you can try so:
In your computer the Alt key in the left might not work, in this eventuality try using the contralateral Alt Gr key. Often the entire sequence Alt-SysRq + REISU works fine, but B key don't run the reboot, then you try to hold B key along with Alt Gr instead of Alt, that means type Alt Gr-SysRq + B. If it don't work again you try to replace O instead of B, the computer should shut down instead of reboot.
On laptops that use Fn key to differentiate SysRq from PrtScrn, it may not actually be necessary to use the Fn key (i.e., Alt-PrtSc+letter could work).
In some computer you may need to press Ctrl along with Alt. So for example, full key shortcut would be Ctrl-Alt-SysRq+R.


I haven't included this part:
often only the first 2 letters are sufficient. Example, Ctrl-Alt-SysRq + R, then E, then try what you were attempting to do before the failure, if the system is still unresponsive, continue with the I, try again and if you still have no joy, you may as well finish the sequence and the machine will usually reboot.
because by doing tests on two computers it isn't as simple to follow the steps.
In fact, typing Alt + SysRq + R then E, the graphical display disappear and then you will have some difficulty to appear again the display. You must log in, then give startx. Or give Ctrl Alt F1, then login and startx. But when the display environment appears it is not the same as you left it. It almost seems "safe mode" of windows.
Then with Alt + SysRq + I, I cannot appear the display, I can only continue the sequence.
Maybe you know an easy way to do it, I do not know.

As I said I am not able to write well in English so I think you will have to adjust and make the sentences more concise. I tried to give my contribution to what I can.

Another thing, these phrases:
On laptops that use Fn key to differentiate SysRq from PrtScrn, it may not actually be necessary to use the Fn key (i.e., Alt-PrtSc+letter could work).
You may need to press Ctrl along with Alt. So for example, full key shortcut would be Ctrl-Alt-SysRq+R.
I copied them from the Arch wiki: https://wiki.archlinux.org/index.php/Keyboard_shortcuts
I do not know if it's a good thing that they remain exactly that. Think you about it.

Ciao and thanks for your hard work.

Re: Users Manual 20160701

Posted: Thu Jul 28, 2016 10:25 am
by Jerry3904
That's a great help--thanks very much!

(I wish I could write in Italian as *poorly* as you do in English)

Re: Users Manual 20160701

Posted: Sat Aug 06, 2016 10:54 am
by Spartak77
Hi Jerry. Another small reporting and one or two things that I'm not clear.
In: 3.4 Network
you write:
Internet connections are handled by Network Manager; click the applet in the Notification Area to see status, connect and explore options.
Right-click the applet > Edit Connections to open up a Settings box with five tabs.


Following update, the Settings box no longer contains 5 tabs. My Network Manager applet (MX linux 15; network-manager version 0.9.10.0-7) contains 3 main types: Hardware, Virtual, VPN.
Perhaps the last sentence could be corrected with something like this:
Right-click the applet > Edit Connections to open up a Settings box with some type of connection; the main ones are: (or those which be needed a normal user are: ...or something similar)


In 3.4.2 Wireless access - Basic Wireless Steps
you write:

Code: Select all

2 The found network does not function after the completion of Step 1. 
Find out basic information by opening a terminal and entering one at a time:
 lspci 
 lsusb 
Become root in that open terminal and enter:
 iwconfig -a 
The output from the first commands (example below) will give you the exact name, model and version (if any) of your wireless chipset, as well as the associated driver and the mac address; from the second, the name of the access point (AP) you are linked to and other connection information. 
 Network
 Card-2: Intel Ultimate N WiFi Link 5300 driver: iwlwifi 
 IF: wlan0 state: up mac: 00:21:6a:81:8c:5a 
Use the information you have gathered in one of the following ways:
Do a web search using that information. Some examples using the above lspci output.
1) linux Intel Ultimate N WiFi Link 5300 (rev 03)
2) debian stable 00:21:6a:81:8c:5a 
Consult the Linux Wireless site below to find out which driver your chipset needs, what conflicts might exist, and whether it needs firmware installed separately. 
Post your information on the Forum and ask for help.
The first two commands: lspci and lsusb, presented like this, in my opinion are not comfortable.
They are more practical so:
$ lsusb | grep -i net
lspci | grep -i net


Ok, for a newbby it is more reassuring give the terminal a single word command (there is also less risk of errors writing command) but then the output that comes out is very uncomfortable and difficult to understand.

The third command:
iwconfig -a
returns me this output : -a No such device
instead
iwconfig
works.

You write:
The output from the first commands (example below) will give you the exact name, model and version (if any) of your wireless chipset, as well as the associated driver and the mac address; from the second, the name of the access point (AP) you are linked to and other connection information.
 Network
 Card-2: Intel Ultimate N WiFi Link 5300 driver: iwlwifi
 IF: wlan0 state: up mac: 00:21:6a:81:8c:5a
This type of output is not returned by the first two commands, but by:
inxi -n
Instead this is the type of output of lspci | grep -i net
03:00.0 Network controller: Qualcomm Atheros AR9462 Wireless Network Adapter (rev 01)

ok, it is not much different but it isn't correct to write that the output will give you “as well as the associated driver and the mac address” (in inxi -n yes, in lspci no)

When you write:
the first commands (example below) will give you the exact name, model and version (if any) of your wireless chipset
are you sure it is correct chipset rather than wireless card? I don't know, I'm no expert, it's just a question, it is probably correct as you have written, however the information that I have are that the exact name, model and version of wireless chipset, in my case they are defined as :
[168c:0034]
I can graphically see this through MX Broadcom Manager where, after the hardware scan, shows me this:
03:00.0 Network controller: Qualcomm Atheros AR9462 Wireless Network Adapter [168c:0034] (rev 01)

I can have the same output, via cli, typing this :
lspci | grep -i net
and then, using the output I got, I write this command:
lspci -n | grep xx:xx.x

example:
lspci | grep -i net
03:00.0 Network controller: Qualcomm Ather.................
lspci -n | grep 03:00.0
03:00.0 0280: 168c:0034 (rev 01)

then, to see which driver I need, I do a web search using something like this:

Linux 0x168c 0x0034
or debian stable 0x168c 0x0034



You write:
Do a web search using that information. Some examples using the above lspci output.
 2) debian stable 00:21:6a:81:8c:5a
Why should I do a web search using the access point mac?
Did you mean that you could try to do ping and traceroute to check if there is a problem in the intermediate routers a connection must pass through to get to its destination?

I do not know if something is wrong in this sub-paragraph or if I didn't understand something. Or may be that I didn't understand something and something is wrong. I hope not to be too annoying with my small details, in any case I hope that my questions and my doubts are useful to improve the manual.

Re: Users Manual 20160701

Posted: Sat Aug 06, 2016 11:03 am
by Jerry3904
Great detailed feedback, thanks a lot.

I just hope that I will not have to test all that myself, but that some Community members will step up and look at it.

Re: Users Manual 20160701

Posted: Sat Aug 06, 2016 11:38 am
by Spartak77
Thanks for your work Jerry. It is a great service to the community. I and Retrocomputing with our translation work have more opportunity than others to test and check the manual. In these days we have completed the translation in Italian of the whole manual. We are making a general check before giving the missing chapters at Gordon Cooper.
It is a big job (I can imagine how hard it was for you to compile it from scratch) but we are happy because it is a very value and useful document and I'm sure that translated will be read more easily and willingly by Italian users.

Re: Users Manual 20160701

Posted: Sat Aug 06, 2016 8:30 pm
by aus9
on the subject of REISUB text:

My 2 cents worth are....unless a member has good memory of that sequence or has it written down on paper IMHO its smarter to setup your bios to power off after long pressing the power button for 4 seconds. You only need to setup the bios setting once....it may already be the default and its fairly intuitive as its the known procedure for Android phone users to long press the power button to turn off a hanging OS.

Re: Users Manual 20160701

Posted: Sun Aug 07, 2016 6:39 pm
by Spartak77
aus9 wrote: its smarter to setup your bios to power off after long pressing the power button for 4 seconds
The magic SysRq key and REISUB sequence shut down the system going “through several stages that nurse your system safely out of a failure of some sort”. Normally, pressing the power button you get a brutal shut down where open programs may lose data.
You say that you can setup the bios to turning off the OS such as reisub.

I looked in the bios of 3 computers in my house and there is no reference to this. But my computers are old, what computers do you have? What refers your bios in the power setup?

Re: Users Manual 20160701

Posted: Sun Aug 07, 2016 6:58 pm
by skidoo
IMHO its smarter to setup your bios to power off after long pressing
as the saying goes, "IMHO is the operative term here".

aus9, dintya notice ~~ doG kills a kitten every time you do that !

Re: Users Manual 20160701

Posted: Sun Aug 07, 2016 7:07 pm
by Spartak77
on the subject of Basic Wireless Steps

I had the need to quickly modify the part of the manual concerning the Basic Wireless Steps. In one of my previous posts I was referring to my difficulty to understand some things a bit strange. I have not only changed the commands but I included additions to the text because it seemed to me that to give a complete picture of the wireless issues they were missing too much information.
I understand the need to avoid that the manual is swollen, but the network issues are among the top in the Linux world, and you can not think of giving an idea in 2 words. So I made some changes in the Italian version that I tried to translate into English. It is a temporary change until the new version manual comes out.
I copy here the text. The modified part of the paragraph are bold.
Obviously the English language must be corrected and the content must be controlled by those who have more skills. I am not a technician. My text is just a suggestion.

Basic Wireless Steps

Click Start menu > Settings > Network Connections (or just click on the Network Manager icon in the Notification Area), and then the Wireless tab. One of 3 situations will arise.
1. A wireless network has been found.
Click on the line that gives the name of the network.
Click Edit in the right panel, and enter your information.
When done, click OK.
2. The found network does not function after the completion of Step 1.
If wireless networks are seen but your computer cannot connect them, means that:
a) the wireless card is managed correctly by the module containing the right driver but you might have problems concerning the connection to your modem/router, firewall problems, problems with the provider, DNS problems, etc.
b) the wireless card is managed by a module that functions abnormally, because the driver is not the most appropriate for that card or there is problems of conflict with another driver.
In this case you should gather information on your wireless card to see if the card drivers may have problems and then try to test the network with a set of diagnostic tools.

Find out basic information by opening a terminal and entering one at a time:
 lsusb
 lspci | grep -i net
inxi -n

Become root in that open terminal and enter:
 iwconfig
The output from the first three commands will give you the name, model and version (if any) of your wireless card (example below), as well as the associated driver and the mac address of the wireless card; from the fourth command you get the name of the access point (AP) you are linked to and other connection information. Output example of the command inxi -n:
 Network
 Card-2: Qualcomm Atheros AR9462 Wireless Network Adapter driver: ath9k
 IF: wlan0 state: up mac: 00:21:6a:81:8c:5a
Open Tools MX (MX Tools) → Broadcom Manager
In the tab Introduction are identified the network cards recognized. The wireless card is symbolized by a small sphere. Its name is the same as we have already obtained with the above commands. Take note of the numbers in square brackets. Example:
Qualcomm Atheros AR9462 Wireless Network Adapter [168c:0034] (rev1)
The number in brackets is used to identify the type of chipset in your wireless card. The first of the two numbers identifying the manufacturer, and the second identifies the product. In this case 168c (or better 0x168c) identifies the manufacturer Atheros, while: 0x168c 0x0034 identifies accurately the product, allowing in some specific web sites to obtain the chipset id and therefore the appropriate driver.

Use the information you have gathered in one of the following ways:
Do a web search using that information. Some examples using the above commands output.
1) linux Qualcomm Atheros AR9462
2) linux 0x168c 0x0034
3) debian stable 0x168c 0x0034

Consult the Linux Wireless and the Linux Wireless LAN Support sites listed below to find out which driver your chipset needs, what conflicts might exist, and whether it needs firmware installed separately.
Try to test your router and your network. Turn off the firewall, if any, until the recognition takes place between the computer and router. Restart the router. Try to connect with a different router, for example, connect to a smartphone using its WiFi hotspot function. One less empirical way is to use Diagnostic Section in MX Broadcom Manager with which you can do the operation of ping to your router using the mac address obtained by the above commands. Then you can do ping to any website such as Google and to make the operation of traceroute. If with ping you can reach a site using its IP (you can find some of them with a web search, for example 172.217.21.36 is the ip of http://www.google.com), but you can not reach it with its domain name, then the problem may be in the configuration of the DNS. If you don't know how to use the Diagnostic Section of Broadcom Manager (called Broadcom but is valid for any card) read the wiki. If you don't know to interpret the results of ping and traceroute do a web search or post the results in the forums. Mx Broadcom Manager may also serve to replace a native driver for Linux with its Windows corresponding thanks to Ndiswrapper, or to put in blacklist a driver that interferes with the one that handles your card. About Ndiswrapper can see more details below.
Sometimes using the terminal application Ceni (in the repos) can reveal hidden access points and other difficult factors. NOTE: using Ceni to configure your network interface in MX Linux will interfere and/or disable management of that interface by the default Network Manager. Ceni stores its configuration info in /etc/network/interfaces. Any interface defined in /etc/network/interfaces will be ignored by Network Manager, as Network Manager assumes that if a definition exists, you want some other application managing the device. So Ceni could work well to connect but it must be said that shows a semi-graphical interface rather spartan. If you later want to use Network Manager, with which it is interfering, there could be problems.
Post your information on the Forum and ask for help.
3. No wireless interface is found.
Open a terminal and type the 4 commands seen above. Identify the card, chipset and driver you need by doing a web search and consulting the sites reported, according to the procedure described above.
If you have an external wifi device and no information on a network card is found, unplug the device, wait a few seconds then plug it back in. Open a terminal and enter:
 dmesg | tail
Examine the output for information about the device (such as the mac address) that you can use to pursue your issue on the web or the forum.
Probably the most common example of this situation arising is with the Broadcom wireless chipsets; see the Technical Documentation Wiki.


I added to the 3 link below even this: Linux Wireless LAN Support http://linux-wless.passys.nl/

As in the copy text into this place I lost text formatting, attaching my file. It can be more easily watched
WirelessSteps.odt

Re: Users Manual 20160701

Posted: Sun Aug 07, 2016 7:13 pm
by Spartak77
skidoo wrote:aus9, dintya notice ~~ doG kills a kitten every time you do that !
:happy: :happy:

Re: Users Manual 20160701

Posted: Sun Aug 07, 2016 7:41 pm
by Jerry3904
@spartak: thanks a lot for the great work you put into this! Those are good changes and suggestions, and I will consider them carefully when I turn back to the Manual.

Re: Users Manual 20160701

Posted: Mon Aug 08, 2016 1:00 pm
by Spartak77
I found a mistake in my text about the Wireless Steps.
I wrote
Spartak77 wrote: One less empirical way is to use Diagnostic Section in MX Broadcom Manager with which you can do the operation of ping to your router using the mac address obtained by the above commands.
it is correct so:
One less empirical way is to use Diagnostic Section in MX Broadcom Manager with which you can do the operation of ping to your router using the ip address written in its user manual.

Re: Users Manual 20160701

Posted: Tue Aug 23, 2016 11:10 am
by Jerry3904
Work is starting to be more reasonable for me, so I have copied the posts (one-at-a-GD-time) into a document and will start slowly revising the Manual for an early October upgrade.

Re: Users Manual 20160701

Posted: Tue Aug 23, 2016 3:29 pm
by Gordon Cooper
Thanks Jerry