VectorLinux

Getting you started => Docs => Topic started by: lagagnon on February 25, 2009, 10:02:00 am

Title: Call for doc suggestions for VL6.0
Post by: lagagnon on February 25, 2009, 10:02:00 am
I have just started the process of updating the VL documentation to reflect changes to VL 6.0 from VL 5.9. The biggest change will be the addition of a section on our new graphical installer.

If anyone else has comments, suggestions on what should be added, subtracted, edited regarding the old documentation efforts please PM me with your comments ASAP.

thanks....Larry
Title: Re: Call for doc suggestions for VL6.0
Post by: M0E-lnx on February 25, 2009, 10:07:28 am
I guess I could probabbly make a couple of suggestions... where is the documentation for 5.9 BTW?
Never bothered to read any of it. I may need to look at that and compare it to the new installation method.

EDIT
Never mind... Found it

[/EDIT]
Title: Re: Call for doc suggestions for VL6.0
Post by: rbistolfi on February 25, 2009, 10:25:14 am
Some of the new stuff in VL6.0

* Wicd has gained some importance as network configurator and maybe could have a section.

* Slapt-update-notifier

* Gdm instead kdm, best feature is the hability of chaging the locale from it. Now wm's .desktops go in /usr/share/xsessions

* Hal is now default and Vl-Hot can be set from vasm

* The cool vburn and its cli tburn are installed by default as an alternative to k3b
Title: Re: Call for doc suggestions for VL6.0
Post by: StrayBit on February 25, 2009, 11:17:55 am
But what is the replacement for pyNeighborhood or vlsmbmount?

Also, could there be something about connecting two VL machines via LAN?
Title: Re: Call for doc suggestions for VL6.0
Post by: M0E-lnx on February 25, 2009, 11:35:48 am
But what is the replacement for pyNeighborhood or vlsmbmount?

Also, could there be something about connecting two VL machines via LAN?

This has been an area of interest to me, and one that I think we should be worked on heavily on the VL Development.
I've managed to do this using something called "thunar shares", fuse, and fusesmb. The correct setup of these tools makes file sharing very easy on xfce. almost similar to the windows file sharing deal...where you right-click a file/dir and set the sharing properties.

The setup is somewhat complex and I have not had the time to try and automate something for easy installation on a standard VL install.
In the meantime, I'd suggest sticking to samba and pyNeighborhood.
Title: Re: Call for doc suggestions for VL6.0
Post by: StrayBit on February 25, 2009, 02:25:50 pm
Thanks, Moe.

Since fuse was mentioned in our early conversations, this sounds like what I'll find as a friend helps me get set up.
Title: Re: Call for doc suggestions for VL6.0
Post by: lm8 on February 25, 2009, 03:36:34 pm
Some suggestions for setting things up for alternate Window Managers would be nice.  For instance, there are some icons that show up in the default Window Manager if someone's using vl-hot and a device is plugged or unplugged.  Maybe add info on what commands to use to do this at command line or add to a menu in an alternate Window Manager like Fluxbox, Openbox (LXDE), etc.  Thought I read in the 5.9 documentation that you take out the flash drive and then unmount.  Shouldn't that be unmount and then take out the device?

See http://vectorlinux.osuosl.org/docs/vl59/manuals/vl5_external_storage_en.html
"for window managers other than xfce or KDE you should: 1) close down the file manager, 2) remove the device and then, 3) use the command "umount /mnt/vl-hot/sd?" as root, to correctly unmount the device. "

Also, should alternate desktop users be using umount of vlh-umount?  Are there any other useful utilities or documentation that are automatically set up in the menus or as icons for those using the default Window Manager that people choosing another Window Manager should know about or might want to set up?
Title: Re: Call for doc suggestions for VL6.0
Post by: lagagnon on February 25, 2009, 05:00:03 pm
Some suggestions for setting things up for alternate Window Managers would be nice. 

I certainly agree that docs on setting up the installed window managers is necessary but I draw the line at providing docs for alternates that are not provided as installed with the distro. If we do that we open ourselves to providing docs for a plethora of uninstalled applications for which there is already documentation elsewhere. I do not see that as being the mandate for VL Docs.   
Title: Re: Call for doc suggestions for VL6.0
Post by: caitlyn on February 25, 2009, 05:08:14 pm
I agree with Laganon's last post.  If we take VL Standard, Deluxe, Light, and SOHO into account we already have to cover the following window managers and desktop environments:

KDE 4 (kwm)  -  VL 6.0 Deluxe, maybe 6.0 SOHO
KDE 3.5.10 (kwm) - VL 5.9.1 SOHO, maybe 6.0 SOHO
Xfce 4.4.3 - VL 6.0 Standard/Deluxe
LXDE/Openbox - VL 6.0 Standard/Deluxe
IceWM - VL 6.0 Light
JWM - VL 6.0 Light
Enlightenment E17 - VL 6.0 Deluxe

That's seven already.  I think that's a bit much as it is.

Re:  VL-Hot -- it's capability within a lightweight WM doesn't come from the window manager but rather from the pcmanfm file manager.  That can be documented in a window manager neutral way.

Just my two agorot worth...
Cait
(An agora is 1/100 of an Israeli shekel, or about a quarter of a US penny)
Title: Re: Call for doc suggestions for VL6.0
Post by: GrannyGeek on February 25, 2009, 06:03:07 pm
Also, could there be something about connecting two VL machines via LAN?

If they're VL machines and you don't want to connect to Windows shares, nfs is super easy to install and use. See my how-to at http://forum.vectorlinux.com/index.php?topic=669.msg3845#msg3845 . It's much easier to do than to describe how to do it.
--GrannyGeek
Title: Re: Call for doc suggestions for VL6.0
Post by: radio_silence on February 25, 2009, 08:15:53 pm
Hi! I don't know much about the suggestions being batted around, but it 'cause I don't know much... ::)

Having just purchased 6.0 deluxe for a laptop to send to a perma-noob, I'm anxiously awaiting the pending user manual in pdf form.  After all, its supposed to be part of the package, I've really been looking forward to it.

Check my post concerning Dlx customer support  'I don't know -ask at forum'
Title: Re: Call for doc suggestions for VL6.0
Post by: StrayBit on February 25, 2009, 08:47:53 pm
Thanks for repeating that Granny.  I find that I had been missing the cli commands after gettting the other files set and had lost my notes.
Title: Re: Call for doc suggestions for VL6.0
Post by: lm8 on February 26, 2009, 05:03:05 am
Putting instructions for each individual alternate window manager would be too much work.  I was thinking more along the lines of, these are the commands at the command line to do a task.  Enter them into your particular window manager's menu or keyboard shortcuts or integrate however you usually would. 

Covering LXDE in more detail would be great for many of the openbox, fluxbox, blackbox users as techniques should be similar enough between these window managers, even if configuration files differ between them.

So, does this mean we're stuck using pcmanfm with vl-hot?  What about users who prefer a different file manager and still want some of vl-hot's capabilities?
Title: Re: Call for doc suggestions for VL6.0
Post by: kidd on February 26, 2009, 05:16:30 am
Once upon a time.......

We had a wiki, but it got hacked, or busted, or server died, or whatever.  To put little info on different topics, I think a wiki is the best solution, but we need a server to host it, and a good policy of who can edit it (to prevent spam), and how it should be organized.

I remember writing a couple of articles for it, but when it disappeared, we lost them all (yeah, no backups :( )

Title: Re: Call for doc suggestions for VL6.0
Post by: M0E-lnx on February 26, 2009, 05:35:07 am
Once upon a time.......

We had a wiki, but it got hacked, or busted, or server died, or whatever.  To put little info on different topics, I think a wiki is the best solution, but we need a server to host it, and a good policy of who can edit it (to prevent spam), and how it should be organized.

I remember writing a couple of articles for it, but when it disappeared, we lost them all (yeah, no backups :( )



I too remember this.... and agree that this is probabbly the best way to do this
Title: Re: Call for doc suggestions for VL6.0
Post by: bigpaws on February 26, 2009, 06:08:12 am
Isn't this the same thing you are looking for?

Quote
https://vector.ecosq.com/ic/HowTos

Except that is already setup.

Bigpaws
Title: Re: Call for doc suggestions for VL6.0
Post by: caitlyn on February 26, 2009, 11:52:54 am
So, does this mean we're stuck using pcmanfm with vl-hot?  What about users who prefer a different file manager and still want some of vl-hot's capabilities?

VL-hot works with KDE, GNOME, and Xfce without pcmanfm.  Lightweight window managers lack the necessary functionality.  For them pcmanfm is required.  pcmanfm is also integral to LXDE.  So... the answer to your question is that it depends on the DE you are using.
Title: Re: Call for doc suggestions for VL6.0
Post by: stretchedthin on February 26, 2009, 02:11:19 pm
Some suggestions for setting things up for alternate Window Managers would be nice. 

I certainly agree that docs on setting up the installed window managers is necessary but I draw the line at providing docs for alternates that are not provided as installed with the distro. If we do that we open ourselves to providing docs for a plethora of uninstalled applications for which there is already documentation elsewhere. I do not see that as being the mandate for VL Docs.   

Agreed.  We probably should mention something on how to install the Gnome Slack Build that is included in the repositories with VL6.0.  We should probably also include some documentation that will instruct people not to download from that repository when they don't want knom.  Maybe even suggest to remove it from the repositories as a rule and just pull it in when needed.
Ken
Title: Re: Call for doc suggestions for VL6.0
Post by: sledgehammer on February 26, 2009, 04:51:31 pm
Lagagnon,

I think you are right to concentrate on the gui installer.  As soon as that part is done, I hope you link it to the help button at the gparted portion of the gui install.  I can now install 6.0 final gui without never_stop_learning's help, but its not pretty.

As to other differences, I think the gslapt changes are important, as is the lack of wifi-radar (and other changes in the wireless setup procedures).

John 
Title: Re: Call for doc suggestions for VL6.0
Post by: Windozer on February 26, 2009, 05:20:57 pm

We had a wiki, [...] but we need a server to host it


Kidd, M0E, Larry, and all:

I have no idea how you all have the backend stuff set up, but if there's enough bandwidth to host the how-to videos discussed over in another thread, why couldn't the wiki go on the forum's server?  I can't imagine a wiki making that much of a load.

Quote
and a good policy of who can edit it (to prevent spam), and how it should be organized.

I'd suggest a simple procedure:

1. Qualified Wiki Participant:

2. Moderators:

Perhaps the approval could be by simple majority vote - always tending toward permissiveness. It would be rare to disapprove, and rarer still to eject someone, but at least there'd be a formal mechanism to do so.

Quote
I remember writing a couple of articles for it, but when it disappeared, we lost them all (yeah, no backups :( )

Could we use google docs to start the rebuilding of the wiki? ... I'm all for this, and would help out.

What do you think?

- Howard
Title: Re: Call for doc suggestions for VL6.0
Post by: caitlyn on February 26, 2009, 05:31:38 pm
The old wiki we did have was very good.  Whatever was done then could be done now once we figure out where to put it.
Title: Re: Call for doc suggestions for VL6.0
Post by: Joe1962 on February 27, 2009, 10:03:36 am
So, does this mean we're stuck using pcmanfm with vl-hot?  What about users who prefer a different file manager and still want some of vl-hot's capabilities?

VL-hot works with KDE, GNOME, and Xfce without pcmanfm.  Lightweight window managers lack the necessary functionality.  For them pcmanfm is required.  pcmanfm is also integral to LXDE.  So... the answer to your question is that it depends on the DE you are using.

Actually, vl-hot will work even with no X running.  It will mount things regardless, you would just need to unmount manually. What you really need KDE, Gnome, XFCE and PCManFM for is to get the advantage of the desktop icons.
Title: Re: Call for doc suggestions for VL6.0
Post by: lm8 on February 27, 2009, 11:51:34 am
Actually, vl-hot will work even with no X running.  It will mount things regardless, you would just need to unmount manually. What you really need KDE, Gnome, XFCE and PCManFM for is to get the advantage of the desktop icons.

I'm happy running it without the desktop icons.  I have to say again, I really like vl-hot.  It is great for older systems.  As caitlyn mentioned in her article, I am surprised other distributions aren't using it.  (By the way, nice article, caitlyn.) 

A little more official documentation on it (such as mentioning the info Joe1962 just posted above) would be great too.
Title: Re: Call for doc suggestions for VL6.0
Post by: Joe1962 on February 27, 2009, 12:15:58 pm
Oops, and I forgot this piece of info when posting my comment over at Caitlyn's article... :-[
Title: Re: Call for doc suggestions for VL6.0
Post by: zeeshan on December 27, 2012, 10:52:46 pm
thanks for sharing. :)