Bug 94867

Summary:	Remove outdated KDM instructions from the FreeBSD handbook
Product:	Documentation	Reporter:	Michael Nottebrock <lofi>
Component:	Books & Articles	Assignee:	Christian Brueffer <brueffer>
Status:	Closed FIXED
Severity:	Affects Only Me
Priority:	Normal
Version:	Latest
Hardware:	Any
OS:	Any

Description Michael Nottebrock freebsd_committer

2006-03-23 17:30:21 UTC

The information about KDM in chapter 5.7.3.1 is so 
outdated that it became dangerously wrong - if someone actually attempted to do what is suggested there with a recent version of KDE/KDM, they'd completely 
break their setup.

Setting up KDM these days is very trivial - from the FAQ on http://freebsd.kde.org:

Q11: How do I get kdm to work?
A11.1 Replace the ttyv8 line in /etc/ttys with: 

ttyv8 "/usr/local/bin/kdm -nodaemon" xterm on secure

Since I don't think this alone is worth keeping the KDM section of the handbook, I propose to completely delete chapter 5.7.3.1 and 5.6.5.

Furthermore, the description of KDE in chapter 5.7.2.1 is inaccurate, specifically: "KDE has an office application suite based on KDE's 
&#8220;KParts&#8221; technology consisting of a spread-sheet, a presentation application, 
an organizer, a news client and more." This sentence should be removed as well.

Finally, section 5.7.3.2 has outdated information, too - these days, there is 
no more 'Preferences' submenu in the K-Menu. Also, antialiased fonts have 
been enabled by default in new KDE installations for some time and the QT_XFT 
environment variable is no longer needed either - again, the whole chapter is 
a candidate for removal.

Comment 1 Alex Dupre freebsd_committer

2006-03-24 07:09:58 UTC

Michael Nottebrock wrote:
>> Number:         94867
>> Category:       docs
>> Synopsis:       Remove outdated KDM instructions from the FreeBSD handbook

After the detailed changes you gave to us, why do you propone to remove
the KDE sections completely? I'd prefer to keep them short with basic
description and installation instruction, so they'll have much
probability to remain up to date, but leaving them in the handbook.

--
Alex Dupre

Comment 2 Michael Nottebrock freebsd_committer

2006-03-28 01:22:18 UTC

I didn't give any changes, I pointed out specific sections in the the
chapter which are entirely obsolete.

If you like, you can copy the Q&A from the FKO Faq on KDM and make it
the new KDM section, but I'd much prefer to have all the mentioned
sections removed. Wrong documentation is worse than no documentation and
http://freebsd.kde.org is a much more convenient way for us (the KDE
maintainers) to provide documentation on FreeBSD-specific KDE matters.

Comment 3 Christian Brueffer freebsd_committer

2006-03-31 21:26:03 UTC

Responsible Changed
From-To: freebsd-doc->brueffer

My precious!

Comment 4 Christian Brueffer freebsd_committer

2006-03-31 21:51:59 UTC

State Changed
From-To: open->closed

Information updated, case closed.  Thanks!