Documentation Wishlist

From openSUSE

This is the documentation requests list. Anything that is not covered in existing documents, and you would like to have explained please put here.

Before you fill in request please consider that this is not a help desk for troubleshooting individual problems and your request can be classified as such and removed from this list. Please accept decision of experienced openSUSE users and use options on Communicate page to ask for help.

Example request entry:

Topic: KDE
Question: How to setup a mouse?
Your wiki ID: xyz

Example request answer:

Assigned to: mouseman
Answer: Please look in KDE Help.
Status: Already exists.
Date: 12/12/2006


Index: Numbers A B C D E F G H I J K L M O P Q R S T U V W X Y Z


Numbers

Request:

Topic: NFS
Question: A HOWTO on setting up NFS would be peachy.
Your wiki ID: sgharp

Answer:

Assigned to:
Answer:
Status:
Date:


A

Request:

Topic:
Question:
Your wiki ID:

Answer:

Assigned to:
Answer:
Status:
Date:


B

Request:

Topic: btnx
Question: a HOWTO for btnx would be wicked. preferably fully-fledged, but basics would be good too. This would help migrate the user from being expected to edit xorg.conf to using a GUI-only utility to setup their mouse configurations.
Your wiki ID: BloodyIron? (im new to this)

Answer:

Assigned to:
Answer:
Status:
Date:


C

Request:

Topic:
Question:
Your wiki ID:

Answer:

Assigned to:
Answer:
Status:
Date:


D

Request:

Topic:
Question:
Your wiki ID:

Answer:

Assigned to:
Answer:
Status:
Date:

E

Request:

Topic:
Question:
Your wiki ID:

Answer:

Assigned to:
Answer:
Status:
Date:


F

Request:

Topic:
Question:
Your wiki ID:

Answer:

Assigned to:
Answer:
Status:
Date:


G

Request:

Topic:
Question:
Your wiki ID:

Answer:

Assigned to:
Answer:
Status:
Date:


H

Request:

Topic:
Question:
Your wiki ID:

Answer:

Assigned to:
Answer:
Status:
Date:


I

Request:

Topic:
Question:
Your wiki ID:

Answer:

Assigned to:
Answer:
Status:
Date:


J

Request:

Topic:
Question:
Your wiki ID:

Answer:

Assigned to:
Answer:
Status:
Date:


K

Request:

Topic:
Question:
Your wiki ID:

Answer:

Assigned to:
Answer:
Status:
Date:


L

Request:

Topic:
Question:
Your wiki ID:

Answer:

Assigned to:
Answer:
Status:
Date:


M

Request:

Topic:
Question:
Your wiki ID:

Answer:

Assigned to:
Answer:
Status:
Date:


N

Request:

Topic:
Question:
Your wiki ID:

Answer:

Assigned to:
Answer:
Status:
Date:


O

Request:

Topic:
Question:
Your wiki ID:

Answer:

Assigned to:
Answer:
Status:
Date:


P

Request:

Topic:
Question:
Your wiki ID:

Answer:

Assigned to:
Answer:
Status:
Date:


Q

Request:

Topic:
Question:
Your wiki ID:

Answer:

Assigned to:
Answer:
Status:
Date:


R

Request:

Topic:
Question:
Your wiki ID:

Answer:

Assigned to:
Answer:
Status:
Date:


S

Request:

Topic:
Question:
Your wiki ID:

Answer:

Assigned to:
Answer:
Status:
Date:


T

Request:

Topic:
Question:
Your wiki ID:

Answer:

Assigned to:
Answer:
Status:
Date:


U

Request:

Topic:
Question:
Your wiki ID:

Answer:

Assigned to:
Answer:
Status:
Date:


V

Request:

Topic:
Question:
Your wiki ID:

Answer:

Assigned to:
Answer:
Status:
Date:


W

Request:

Topic:
Question:
Your wiki ID:

Answer:

Assigned to:
Answer:
Status:
Date:


X

Request:

Topic: X-Window
Question:

The reference manual says in the chapter "X-Window-System / Manually Configuring the X Window System": "Those who try to develop their own monitor descriptions should be very familiar with the documentation in /usr/share/X11/doc." (http://www.novell.com/documentation/opensuse103/opensuse103_reference/data/book_opensuse_reference.html)

But in /usr/share/X11/doc there are only DocBook 4.2 SGML-files. I assume that this documentation is useful for other topics too. I didn't find any hint how to use these files. DocBook 4.2-files cannot be opened in openSUSE 10.3.

On the DocBook website there is a very general description how to convert DocBook 4.2 files into DocBook 5.0 (http://www.docbook.org/docs/howto/#convert4to5). Because I am not familiar with DocBook I cannot use this description.

In the chapter there is also the subchapter "For More Information". This recommends to install xorg-x11-doc and howtoenh. But there is no hint how to access this documentation. Yelp does not display any entry for X-Window.

Questions:

1) How to access the documentation of /usr/share/X11/doc, xorg-x11-doc and howtoenh?

2) How to convert DocBook 4.2 files to DocBook 5.0 files?

3) Because of what reasons DocBook 4.2 files are provided with X-Window? 5.0 files would be easier!

4) How to integrate DocBook 5.0 files into the Yelp menu?

Your wiki ID: 43530

Answer:

Assigned to:
Answer:

to 1) After installing the package xorg-x11-doc you have html, pdf or postscript files below /usr/share/X11/doc. Just use those. All manuals in the package howtoenh should be available from the KDE- or GNOME Helpcenter. If you want to know where those html files are located, just type rpm -ql howtoenh after installing this package.

see https://bugzilla.novell.com/show_bug.cgi?id=335450

Status:
Date:


Y

Request:

Topic:
Question:
Your wiki ID:

Answer:

Assigned to:
Answer:
Status:
Date:


Z

Request:

Topic:
Question:
Your wiki ID:

Answer:

Assigned to:
Answer:
Status:
Date: