create new tag
, view all tags
This is a first draft. I may refer some others to it for comments and/or let it sit for a while.

Discussion and an attempt to (legally) use a GFDL (GNU Free Documentation License) licensed document on WikiLearn (for modification, not just publication), and working out all the things that need to be done to do that.

The rub is that there is at least a list of items a thru o to be complied with, and maybe others covered in other parts of the GFDL.

In order to work this through, I'm going to work with the title page of a specific document (the Linux Sound HOWTO) by posting it on this page, then posting the list of items to be complied with, and then (gradually) modifying that title page until I've fully complied with the requirements.



The Linux Sound HOWTO "Title Page"

I'm treating this as the Title Page as it is what appears when you click on the copy on the tldp site.

I'll add italicized notes in the quoted section below as I address each item.

The Wikified Linux Sound HOWTO

Special Note: The document posted here (on WikiLearn) was initially "The Linux Sound HOWTO" by Jeff Tranter, v1.22, dated 16 July 2001. Subsequent modifications have been made by contributors to WikiLearn whose names are recorded in a "Contributors" section on each page (and in the revision record for each page).

This document is licensed under the terms of the GFDL version 1.2.

Here (pasted in, and in &ltpre> tags, is the "official" copyright notice required by the GFDL:

I want to drop the "or any later version" just because I don't like such open endedness.

_Hmm, what should I use for "YOUR NAME" — "WikiLearn", "WikiLearn Contributors", my name, ???

      Copyright (c)  YEAR  YOUR NAME.
      Permission is granted to copy, distribute and/or modify this document
      under the terms of the GNU Free Documentation License, Version 1.2
      or any later version published by the Free Software Foundation;
      with no Invariant Sections, no Front-Cover Texts, and no Back-Cover
         Texts.  A copy of the license is included in the section entitled "GNU
      Free Documentation License".

 If you have Invariant Sections, Front-Cover Texts and Back-Cover Texts, replace the "with...Texts." line with this: 

    with the Invariant Sections being LIST THEIR TITLES, with the
    Front-Cover Texts being LIST, and with the Back-Cover Texts being LIST.

original Linux Sound HOWTO by Jeff Tranter


v1.22, 16 July 2001

Revision History

On (or about) August xx <later>, 2004 the "Linux Sound HOWTO" was published on WikiLearn as the "Wikified Linux Sound HOWTO". Subsequent revisions to each page are captured in the revision record of each page (click "diffs" at the bottom of any page). Contributor's names are recorded in a "Contributors" section on each page.

Revision 1.22 2001-07-16 Revised by: jjt

Relicensed under the GFDL.

Revision 1.21 2001-05-11 Revised by: jjt

This document describes sound support for Linux. It lists the supported sound hardware, describes how to configure the kernel drivers, and answers frequently asked questions. The intent is to bring new users up to speed more quickly and reduce the amount of traffic in the Usenet news groups and mailing lists.

Table of Contents
<to be converted to links>
1. Introduction
1.1. Acknowledgments
1.2. New versions of this document
1.3. Feedback
1.4. Distribution Policy
2. Sound Card Technology
3. Supported Hardware
3.1. Platform Notes
3.2. Sound Card Types
3.3. Sound Cards
3.4. Alternate Sound Drivers
4. Installation
4.1. Installing the Sound Card
4.2. Configuring ISA Plug and Play
4.3. Configuring the Kernel
4.4. Creating the Device Files
4.5. Booting Linux and Testing the Installation
4.6. Troubleshooting
5. Applications Supporting Sound
6. Answers To Frequently Asked Questions
6.1. What are the various sound device files?
6.2. How can I play a sound sample?
6.3. How can I record a sample?
6.4. Can I have more than one sound card?
6.5. Error: No such file or directory for sound devices
6.6. Error: No such device for sound devices
6.7. Error: No space left on device for sound devices
6.8. Error: Device busy for sound devices
6.9. I still get device busy errors!
6.10. Partial playback of digitized sound file
6.11. There are pauses when playing MOD files
6.12. Compile errors when compiling sound applications
6.13. SEGV when running sound binaries that worked previously
6.14. What known bugs or limitations are there in the sound driver?
6.15. Where are the sound driver ioctls() etc. documented?
6.16. What CPU resources are needed to play or record without pauses?
6.17. Problems with a PAS16 and an Adaptec 1542 SCSI host adaptor
6.18. Is it possible to read and write samples simultaneously?
6.19. My SB16 is set to IRQ 2, but configure does not allow this value.
6.20. If I run Linux, then boot DOS, I get errors and/or sound applications do not work properly.
6.21. Problems running DOOM under Linux
6.22. How can I reduce noise picked up by my sound card?
6.23. I can play sounds, but not record.
6.24. My "compatible" sound card only works if I first initialize under MS-DOS.
6.25. My 16-bit SoundBlaster "compatible" sound card only works in 8-bit mode under Linux.
6.26. Where can I find sound applications for Linux?
6.27. Can the sound drivers be compiled as a loadable module?
6.28. Can I use a sound card to replace the system console beep?
6.29. What is VoxWare?
6.30. Sox/Play/Vplay reports "invalid block size 1024"
6.31. The mixer settings are reset whenever I load the sound driver module
6.32. Only user root can record sound
6.33. Is the sound hardware on the IBM ThinkPad supported?
6.34. Applications fail because my sound card has no mixer
6.35. Problems with a SB16 CT4170
6.36. How to connect a MIDI keyboard to a soundcard
6.37. Problems with IRQ 15 and Ensoniq PCI 128
6.38. Where can I get freely available MIDI patches to run SoftOSS?
7. References

Section 4.0 of the GFDL (version 1.2)

I'll add italicized notes in the quoted section below as I address each item.


You may copy and distribute a Modified Version of the Document under the conditions of sections 2 and 3 above, provided that you release the Modified Version under precisely this License, with the Modified Version filling the role of the Document, thus licensing distribution and modification of the Modified Version to whoever possesses a copy of it. In addition, you must do these things in the Modified Version:

A. Use in the Title Page (and on the covers, if any) a title distinct from that of the Document, and from those of previous versions (which should, if there were any, be listed in the History section of the Document). You may use the same title as a previous version if the original publisher of that version gives permission. Tentatively I've changed the title to "The Wikified Sound HOWTO", I'm also considering "The WikiLearn Sound HOWTO", but, in any case, at some point I'll write to Jeff Tranter and seek his input.

B. List on the Title Page, as authors, one or more persons or entities responsible for authorship of the modifications in the Modified Version, together with at least five of the principal authors of the Document (all of its principal authors, if it has fewer than five), unless they release you from this requirement. I'm going to try to do this referring to something like "The WikiLearn Community" with a reference to a list of (new) contributors on each page. Or maybe start with Jeff Tranter in the contributor section, and let (request) that others add their names as they contribute. Two notes: It should be recognized that contributions to WikiLearn can be anonymous (TWikiGuest, for example, or intentionally misattributed). I don't know whether anonymous contributions per se will cause a problem. 2nd: If it is necessary to cite "one or more persons or entities responsible for authorship of the modifications in the Modified Version" on the title page, maybe that entity can be "The WikiLearn Community"?

Thus the first entry in the Contributors section on each page will be something like:

  • Jeff Tranter (or Main.JeffTranter if Jeff is willing to register (or be registered) at WikiLearn) - 16 July 2001 - original document thru revision 1.22

Oops, may need a better phrase than "original document thru revision 1.22" to avoid the potential confusion when a page reaches revision 1.22.

C. State on the Title page the name of the publisher of the Modified Version, as the publisher. This is not a printed copy, I'm not sure that a publisher is appropriate / required. If it is, would it be me, WikiLearn, SourceForge, or who?

D. Preserve all the copyright notices of the Document. OK, I haven't removed any.

E. Add an appropriate copyright notice for your modifications adjacent to the other copyright notices. Each page has the "standard" TWiki note: "Copyright 1999-2004 by the contributing authors. All material on this collaboration platform is the property of the contributing authors." with the ending date updated each year. Although this sounds sufficient, oops, wait, since the document must be relicensed under the same GFDL license, maybe I need something more, referencing the GFDL, saying at least that each author who contributes to the document is offering his contribution under the GFDL, or perhaps even assigning his copyright to some one or some thing? Requires some more thought, but I'm about to take a break.

<taking a break>


Maybe the note at the bottom of each page should be expanded to something like this:

"Copyright 1999-2004 by the contributing authors. All material on this collaboration platform is the property of the contributing authors. Some documents on WikiLearn are licensed under the GFDL. A note on each page will identify those pages. For those documents, contributors agree that their revisions are also licensed under the GFDL."

F. Include, immediately after the copyright notices, a license notice giving the public permission to use the Modified Version under the terms of this License, in the form shown in the Addendum below.

G. Preserve in that license notice the full lists of Invariant Sections and required Cover Texts given in the Document's license notice. I don't think I see any Invariant Sections, Cover Texts, or lists thereof, so, for the present, it seems to be a mute point. Also, I should note that his (Jeff Tranter's) license statement (not on what I first considered the title page, but instead in section 1.4) says there are no invariant sections, cover texts, etc.

H. Include an unaltered copy of this License. Well, it wasn't really done at the tldp (at least, not within this HOWTO), instead it was linked. I'd plan to do the same.

I. Preserve the section Entitled "History", Preserve its Title, and add to it an item stating at least the title, year, new authors, and publisher of the Modified Version as given on the Title Page. If there is no section Entitled "History" in the Document, create one stating the title, year, authors, and publisher of the Document as given on its Title Page, then add an item describing the Modified Version as stated in the previous sentence. See the history section — I think I have it covered.

J. Preserve the network location, if any, given in the Document for public access to a Transparent copy of the Document, and likewise the network locations given in the Document for previous versions it was based on. These may be placed in the "History" section. You may omit a network location for a work that was published at least four years before the Document itself, or if the original publisher of the version it refers to gives permission. WikiLearn is the place, and the transparent copy can be viewed, copied (copy and paste), or modified by clicking "Edit" on any page.

K. For any section Entitled "Acknowledgements" or "Dedications", Preserve the Title of the section, and preserve in the section all the substance and tone of each of the contributor acknowledgements and/or dedications given therein. Don't see any, mute for now.

L. Preserve all the Invariant Sections of the Document, unaltered in their text and in their titles. Section numbers or the equivalent are not considered part of the section titles. Don't see any, mute for now.

M. Delete any section Entitled "Endorsements". Such a section may not be included in the Modified Version. Don't see any, mute for now.

N. Do not retitle any existing section to be Entitled "Endorsements" or to conflict in title with any Invariant Section. Don't see any, mute for now.

O. Preserve any Warranty Disclaimers. Don't see any, mute for now.

If the Modified Version includes new front-matter sections or appendices that qualify as Secondary Sections and contain no material copied from the Document, you may at your option designate some or all of these sections as invariant. To do this, add their titles to the list of Invariant Sections in the Modified Version's license notice. These titles must be distinct from any other section titles.

You may add a section Entitled "Endorsements", provided it contains nothing but endorsements of your Modified Version by various parties--for example, statements of peer review or that the text has been approved by an organization as the authoritative definition of a standard.

You may add a passage of up to five words as a Front-Cover Text, and a passage of up to 25 words as a Back-Cover Text, to the end of the list of Cover Texts in the Modified Version. Only one passage of Front-Cover Text and one of Back-Cover Text may be added by (or through arrangements made by) any one entity. If the Document already includes a cover text for the same cover, previously added by you or by arrangement made by the same entity you are acting on behalf of, you may not add another; but you may replace the old one, on explicit permission from the previous publisher that added the old one.

The author(s) and publisher(s) of the Document do not by this License give permission to use their names for publicity for or to assert or imply endorsement of any Modified Version.


  • () RandyKramer - 15 Aug 2004
  • If you edit this page: add your name here; move this to the next line; and if you've used a comment marker (your initials in parenthesis), include it before your WikiName.

Revision Comment

  • %DATE% —

Page Ratings

Edit | Attach | Watch | Print version | History: r4 < r3 < r2 < r1 | Backlinks | Raw View | Raw edit | More topic actions
Topic revision: r4 - 2004-08-16 - RandyKramer
  • Learn about TWiki  
  • Download TWiki
This site is powered by the TWiki collaboration platform Powered by PerlCopyright 1999-2017 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding WikiLearn? WebBottomBar">Send feedback
See TWiki's New Look