junior-doc-1.16.1/0000755000000000000000000000000007637406436010556 5ustar junior-doc-1.16.1/doc-base/0000755000000000000000000000000007407673240012225 5ustar junior-doc-1.16.1/doc-base/junior-quickguide0000644000000000000000000000075207407673212015611 0ustar Document: junior-quickguide Title: Debian Junior Quick Guide Author: Derek Neighbors Abstract: This document provides a quick guide to installing and getting started with Debian Jr. Section: Debian Format: HTML Index: /usr/share/doc/junior-doc/quickguide/index.html Files: /usr/share/doc/junior-doc/quickguide/*.html Format: text Files: /usr/share/doc/junior-doc/quickguide/junior-quickguide.txt.gz Format: PostScript Files: /usr/share/doc/junior-doc/quickguide/junior-quickguide.ps.gz junior-doc-1.16.1/debian/0000755000000000000000000000000011353631245011764 5ustar junior-doc-1.16.1/debian/control0000644000000000000000000000123211353630617013367 0ustar Source: junior-doc Section: doc Priority: extra Maintainer: Ben Armstrong Standards-Version: 3.5.9 Build-Depends-Indep: debiandoc-sgml, texlive-latex-recommended, texlive-latex-extra, texlive-fonts-recommended Package: junior-doc Architecture: all Suggests: www-browser, postscript-viewer Description: Debian Jr. Documentation Includes, for the moment, just the "Quick Guide" which helps a new user of Debian Jr. get started. The intention of the Debian Jr. working group is to provide a variety of additional documents to help children and sys admins alike with the installation, configuration, and use of a Debian Jr. system. junior-doc-1.16.1/debian/changelog0000644000000000000000000001165311353631245013644 0ustar junior-doc (1.16.1) unstable; urgency=low [Jari Aalto] * Non-maintainer upload. * debian/control - (Build-Depends): update obsolete tetex-bin and tetex-extra to texlive-latex-recommended, texlive-latex-extra, texlive-fonts-recommended. Patch thanks to Ilya Barygin . (FTBFS RC bug; Closes: #562324). -- Jari Aalto Sun, 28 Mar 2010 13:42:45 +0300 junior-doc (1.16) unstable; urgency=low * Lowered priority to extra. * Removed obsolete doc symlink/unlink from prerm, postinst. * Updated to match developments since pre-woody release. * Renamed list-junior to list-junior.sh, removed executable bit, requiring invocation as "sh list-junior.sh" as there should be no executables in a doc dir. -- Ben Armstrong Sun, 23 Mar 2003 15:09:47 -0400 junior-doc (1.15) unstable; urgency=low * Typo corrected (#136523). -- Ben Armstrong Sun, 3 Mar 2002 08:26:39 -0400 junior-doc (1.14) unstable; urgency=low * Related documents section renamed "Suggested reading". * Typos and other cosmetic little fixups. * Provide example script list-junior to make an HTML table of what Debian Jr. components are currently installed. * Mention list-junior in doc. -- Ben Armstrong Mon, 25 Feb 2002 17:26:07 -0400 junior-doc (1.13) unstable; urgency=low * Make note about processor not so x86-centric. * Lots more stuff: apt-get vs. dselect, more prominent Social Contract, etc. with a view to providing more detail to those who may be completely new to Debian. -- Ben Armstrong Mon, 25 Feb 2002 14:09:13 -0400 junior-doc (1.12) unstable; urgency=low * Touch up Gnome/KDE instructions. * Include reference to dselect beginner doc. * Separate user/developer appeal to contribute into different chapters, with the latter now in "Can you help?" * Don't just mention how to file bugs, explain why and invite participation. -- Ben Armstrong Mon, 25 Feb 2002 11:53:28 -0400 junior-doc (1.11) unstable; urgency=low * Use typeface styles consistently. * Improve flow, structure of installation steps, dividing into sections and enumerated lists. -- Ben Armstrong Mon, 25 Feb 2002 10:09:24 -0400 junior-doc (1.10) unstable; urgency=low * Fixed some typos. Expanded "about" section some more. -- Ben Armstrong Fri, 22 Feb 2002 11:24:50 -0400 junior-doc (1.9) unstable; urgency=low * Introduce the term "guide". * Make the distinction between guide and sys admin. * Restructure document a bit to improve flow and focus. * Consider the case where not all components are to be installed. * Expand a bit on "getting started". -- Ben Armstrong Fri, 22 Feb 2002 11:03:22 -0400 junior-doc (1.8) unstable; urgency=low * Blow our own horn a bit in the introduction. -- Ben Armstrong Thu, 21 Feb 2002 11:26:34 -0400 junior-doc (1.7) unstable; urgency=low * Fixed copyright. We now attribute copyright to the authors, as we never formally went through the FSF attribution process. * Major edit, restructuring and cutting out cruft to make the quickguide easier to digest. * Hard drive space prerequisite added, and all prereqs grouped together in new chapter. -- Ben Armstrong Mon, 18 Feb 2002 12:13:17 -0400 junior-doc (1.6) unstable; urgency=low * Quickguide expanded with "What Now?" and "Problems" section, citing bug #114721 in the latter. * "Getting Started" section expanded, noting that for a fresh system install, the "X Window System" task is needed, along with either a desktop environment task or a window manager. -- Ben Armstrong Sun, 17 Feb 2002 20:13:53 -0400 junior-doc (1.5) unstable; urgency=low * Fixed doc dir. * Fixed build deps to be -Indep. -- Ben Armstrong Tue, 18 Dec 2001 12:14:30 -0400 junior-doc (1.4) unstable; urgency=low * Install now uses tasksel. -- Ben Armstrong Thu, 13 Dec 2001 07:46:08 -0400 junior-doc (1.3) unstable; urgency=low * Fixed long description. (Closes: #97238) -- Ben Armstrong Sat, 12 May 2001 21:39:51 -0300 junior-doc (1.2) unstable; urgency=low * Fixed copyright. -- Ben Armstrong Wed, 9 May 2001 08:39:23 -0300 junior-doc (1.1) unstable; urgency=low * Expanded "getting started" section. * Added "reporting bugs". * Misc other revs, including adding myself as co-author. -- Ben Armstrong Sat, 28 Apr 2001 13:04:04 -0300 junior-doc (1.0) unstable; urgency=low * Initial release. -- Ben Armstrong Wed, 18 Apr 2001 11:33:52 -0300 junior-doc-1.16.1/debian/postinst0000755000000000000000000000017207637403321013577 0ustar #!/bin/sh -e if command -v install-docs >/dev/null 2>&1; then install-docs -i /usr/share/doc-base/junior-quickguide fi junior-doc-1.16.1/debian/rules0000755000000000000000000000413307637406234013055 0ustar #!/usr/bin/make -f # derived from sample debian/rules file for GNU hello by Ian Jackson. tmp = $(shell pwd)/debian/tmp docdir = $(tmp)/usr/share/doc/junior-doc examplesdir = $(docdir)/examples scriptsdir = $(examplesdir)/scripts build: stamp-build stamp-build: test -d quickguide -a -f debian/rules cd quickguide && $(MAKE) html txt ps cd quickguide && gzip -9 junior-quickguide.txt junior-quickguide.ps touch $@ clean: test -d quickguide -a -f debian/rules test "`id -u`" -eq 0 cd quickguide && $(MAKE) clean rm -rf $(tmp) rm -f quickguide/*.gz stamp-build debian/files `find . -name "*~"` binary: binary-indep binary-arch binary-arch: binary-indep: build test -d quickguide -a -f debian/rules test "`id -u`" -eq 0 rm -rf $(tmp) install -m 755 -d $(tmp)/DEBIAN $(docdir) $(docdir)/quickguide \ $(examplesdir) $(scriptsdir) $(tmp)/usr/share/doc-base cd quickguide && install -m 644 junior-quickguide.txt.gz \ junior-quickguide.ps.gz \ junior-quickguide.html/* $(docdir)/quickguide install -m 755 debian/prerm debian/postinst $(tmp)/DEBIAN install -m 644 doc-base/* $(tmp)/usr/share/doc-base install -m 644 debian/copyright $(docdir) install -m 644 scripts/list-junior.sh $(scriptsdir) gzip -c9 debian/changelog > $(docdir)/changelog.gz chown -R root.root $(tmp) && chmod -R go=rX $(tmp) dpkg-gencontrol -isp dpkg --build $(tmp) .. # If we were including the quickguide in ftp/doc, we would do the # following, similar to doc-debian. But while the project is still # immature, we will not upload these materials. Instead, we will # just distribute them from the Debian Jr. website. If this is ever # enabled, it needs to be OK'd by ftpmaster@d.o # # The extra-package files: # cd quickguide/junior-quickguide.html && GZIP=-9 tar czf ../../../junior-quickguide.html.tar.gz * # cp quickguide/junior-quickguide.txt.gz quickguide/junior-quickguide.ps.gz ../ # dpkg-distaddfile junior-quickguide.html.tar.gz byhand - # dpkg-distaddfile junior-quickguide.txt.gz byhand - # dpkg-distaddfile junior-quickguide.ps.gz byhand - .PHONY: build clean binary binary-arch binary-indep junior-doc-1.16.1/debian/prerm0000755000000000000000000000014607637403274013051 0ustar #!/bin/sh -e if command -v install-docs >/dev/null 2>&1; then install-docs -r junior-quickguide fi junior-doc-1.16.1/debian/copyright0000644000000000000000000000070607434224116013722 0ustar This is the Debian GNU/Linux `junior-doc' package of the Debian Jr. documentation set. This package was authored by Ben Armstrong . The copyright for the Debian Jr. Quick Guide: Copyright (C) 2001, 2002 by Derek Neighbors and Ben Armstrong. And license for all documentation in this package: On Debian systems, the complete text of the GNU General Public License is available in `/usr/share/common-licenses/GPL' file. junior-doc-1.16.1/quickguide/0000755000000000000000000000000007637406436012710 5ustar junior-doc-1.16.1/quickguide/Makefile0000644000000000000000000000264407267544116014353 0ustar # # Makefile for the Debian Jr. Quick Guide # SRCS = junior-quickguide.sgml # this can and will be overriden by a higher level makefile PUBLISHDIR := ../../../public_html/junior-doc.html all: html txt ps publish: junior-quickguide.html/index.html test -d $(PUBLISHDIR)/junior-quickguide || install -d -m 755 $(PUBLISHDIR)/junior-quickguide rm -f $(PUBLISHDIR)/junior-quickguide/*.html install -p -m 644 junior-quickguide.html/*.html $(PUBLISHDIR)/junior-quickguide/ faqdynamic.ent: echo "" > faqdynamic.ent if [ -f ../debian/changelog ]; then \ echo "" >> faqdynamic.ent; \ else \ echo "" >> faqdynamic.ent; \ fi validate: nsgmls -ges -wall junior-quickguide.sgml html junior-quickguide.html/index.html: $(SRCS) debiandoc2html $< txt junior-quickguide.txt: $(SRCS) debiandoc2text $< ps junior-quickguide.ps: $(SRCS) debiandoc2latexps $< dvi junior-quickguide.dvi: $(SRCS) debiandoc2latexdvi $< pdf junior-quickguide.pdf: $(SRCS) debiandoc2latexpdf $< info junior-quickguide.info: $(SRCS) debiandoc2info $< clean distclean: rm -rf junior-quickguide.html rm -f junior-quickguide.{txt,ps,dvi,pdf,info*,aux,log,man,tex,toc,sasp*} rm -f *~ .*~ core tsa* .PHONY: all publish clean distclean validate junior-doc-1.16.1/quickguide/junior-quickguide.out0000644000000000000000000000224507637405435017100 0ustar \BOOKMARK [0][-]{chapter.1}{About this document}{} \BOOKMARK [1][-]{section.1.1}{Terminology}{chapter.1} \BOOKMARK [1][-]{section.1.2}{Audience}{chapter.1} \BOOKMARK [1][-]{section.1.3}{Suggested reading}{chapter.1} \BOOKMARK [0][-]{chapter.2}{Introduction}{} \BOOKMARK [0][-]{chapter.3}{Getting started}{} \BOOKMARK [0][-]{chapter.4}{Prerequisites}{} \BOOKMARK [0][-]{chapter.5}{Installation}{} \BOOKMARK [1][-]{section.5.1}{Choosing the installation method}{chapter.5} \BOOKMARK [1][-]{section.5.2}{Installing with the Task Installer}{chapter.5} \BOOKMARK [1][-]{section.5.3}{Installing components individually}{chapter.5} \BOOKMARK [2][-]{subsection.5.3.1}{Choosing a package installer}{section.5.3} \BOOKMARK [2][-]{subsection.5.3.2}{Using dselect}{section.5.3} \BOOKMARK [2][-]{subsection.5.3.3}{Using aptitude}{section.5.3} \BOOKMARK [2][-]{subsection.5.3.4}{Using apt-get}{section.5.3} \BOOKMARK [2][-]{subsection.5.3.5}{Using list-junior}{section.5.3} \BOOKMARK [0][-]{chapter.6}{What now?}{} \BOOKMARK [0][-]{chapter.7}{Can you help?}{} \BOOKMARK [0][-]{chapter.8}{Problems}{} \BOOKMARK [1][-]{section.8.1}{Tasksel issues}{chapter.8} \BOOKMARK [0][-]{chapter.9}{Reporting bugs}{} junior-doc-1.16.1/quickguide/junior-quickguide.sgml0000644000000000000000000004203007637406266017232 0ustar Debian Jr. Quick Guide Derek Neighbors derek@gnu.org Ben Armstrong synrg@debian.org Copyright © 2001 - 2003 Derek Neighbors and Ben Armstrong

This manual is free software; you may redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2, or (at your option) any later version.

This is distributed in the hope that it will be useful, but without any warranty; without even the implied warranty of merchantability or fitness for a particular purpose. See the GNU General Public License for more details.

A copy of the GNU General Public License is available as /usr/share/common-licenses/GPL in the Debian GNU/Linux distribution or on the World Wide Web at . You can also obtain it by writing to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.

About this document Terminology

In writing this document it took some effort to come up with a term that adequately describes those people who help the children use their Debian Jr. systems, who may be a more experienced (usually older) sibling or friend, a parent, a relative, or a teacher. This person may be highly proficient with Debian, or a novice, discovering as much about their system as the children are, and merely staying one step ahead to help bring them forward. After considering a number of alternatives, we settled on "guide". Thus, throughout this document we use this term (in lowercase, as distinct from "the Quick Guide") to refer to this role. Where we need to refer specifically to the children's systems administrator, we use "sys admin" instead, although ideally the sys admin is a guide too.

Audience

The intended audience for this document, then, is those who would like to guide children using Debian Jr., particularly those who are new to it and are planning to install it. You are encouraged to read this document with the sys admin (if that is not also your role), as many parts of it are of particular interest to the sys admin.

Suggested reading

If you are installing Debian for the first time, this document should be read as a companion to Debian's . This covers basic Debian installation concepts, such as running tasksel, which are key to a successful Debian Jr. install.

We try to give as detailed instructions and examples as we can without straying from being a "Quick Guide", assuming very little about the user's familiarity with performing a Debian installation. So we hope that this document, paired with the Installation Manual, can be used together to carry off a successful install. But for those who seek more detailed help, a number of other supporting documents are referenced throughout the rest of this text.

Finally, the is key to understanding why we have embarked on this project at all. We hope that you will catch the spirit of this document, become excited by it, and by using Debian Jr. will not only benefit from what it has to offer as a system, but will also realize the benefits of entering into the global free software community which we serve.

Introduction

Debian Jr. () is an internal project to make Debian an OS that children of all ages will want to use. Our initial focus will be on producing something for children up to age 8. Once we have accomplished this, our next target age range is 7 to 12. By the time children reach their teens, they should be comfortable with using Debian without any special modifications.

Debian Jr. provides a collection of packages for children and their guides. Beyond merely providing entertainment, the packages we have selected cover a broad range of areas, from those which help the child visualize what is inside their operating system (lavaps, xcruise) to music, art, writing and programming (xmms, gimp, abiword and python) as well as some games and desktop toys. We hope that child and guides alike will have fun, learn together, and make creative use of this excellent free software.

Ultimately, we owe the free software authors and maintainers the thanks for what they have given the world. Our work is to gather their work together into the Debian distribution, making it readily available to children and their guides. Once we select a package, we care for its quality, listening to the users, sending wishlists, bug reports, and fixes to Debian and upstream maintainers. It is this constant dialog between users and developers that ensures that the free software and our users continue to be our priorities, as we have promised in our .

Getting started

Now that you know what Debian Jr. is all about, you are probably dying to get it installed and play around. (For the kids of course.) Review the following sections with your sys admin and then go ahead and install it.

Prerequisites

Debian Jr. was first released in Debian 3.0 "Woody". Therefore, to run it, you must at least have a Debian Woody system.

Debian Jr. will add approximately 320M to a base Woody install. In addition to this, some space is required for X, a window manager, and some other programs of your choosing, as well as space for home directories and system overhead. The recommended minimum hard drive size is therefore 700M, with 1G being preferred. Of course, smaller installations are possible if you choose fewer components to install.

Installation Choosing the installation method

You need to choose whether to use the Debian Jr. Task Installer, which installs the majority of Debian Jr. components in one step, or whether to select and install individual components. If you use the Task Installer, review the installed components afterwards to see if there are others you would like to add to the ones installed by default.

Installing with the Task Installer

To start the install, use the Task Installer (tasksel). If you are installing Debian Jr. as part of a fresh Debian install, then this is the step after you have booted your new Debian system for the first time. Otherwise, as root, run tasksel from the command-line. Select "Debian Jr." from the "End User" section. (If you don't see this entry in the list of available tasks, you may have the problem addressed by .) Next, select the "X Window System" task. You may want to select a desktop environment task (Gnome or KDE). However, these each take up a fair amount of disk space and tend to be more resource intensive. For example, if you have a 486 with 32M of memory or less, you would probably be better off running a lightweight window manager instead. When you exit tasksel, the Debian Jr. task will be installed, along with any other task selections you made. Unless you use the KDE or Gnome tasks, which include a window manager, you will need to install a window manager after tasksel is done. For example, Window Maker can be installed with this command: apt-get install wmaker Please note that optional Jr. packages need to be installed separately, as described in the following section.

Installing components individually Choosing a package installer

Debian Jr. components have names starting with "junior-". These packages may be installed individually with dselect, aptitude or apt-get. Which one you use is rather a matter of taste.

If installing Debian Jr. as part of a fresh Debian install, dselect is run for you if you choose the method after your first boot. Otherwise, as root, you can run dselect from the command line. The principal merit of this method is that it is the officially sanctioned one in the Installation Manual.

The new aptitude package installer is an increasingly popular alternative to dselect. Although the author does not use this installer, it appears to have a better user interface than dselect and provides similar functionality. This method is not an option during the Debian installation process, and is not installed on your system by default. So if you want to use it, you need to install it first with apt-get install aptitude.

The author's bias is to use apt-get, due to the elegance of managing the package installation process via simple commands. So if you prefer a command-line interface, you may find this is your best choice. It is not as self-explanatory as dselect and aptitude are supposed to be, but the will give you a good start with it.

Using dselect

If you are using dselect, simply locate all packages with names beginning 'junior-', select the desired components, and install them. (For beginner help, see included in the Debian installation documentation.)

Using aptitude

Aptitude groups packages that are in tasks under the "Tasks" heading. However, if you wish to install the extra 'junior-' packages not included in the task, you will find these by pressing '/' and then typing 'junior-'. After finding the first match, press '\' to find the next. (In this respect, finding a package is similar to dselect which uses the same keys for searching.)

Using apt-get

If you are using apt-get, list all the installed components, check this list against the available components, and then select and install each one in this way: dpkg -l 'junior-*' apt-cache pkgnames junior- apt-get install junior-gnome junior-kde

In the example above, first dpkg is used to show the status of all junior- package. Then apt-cache is used to show all available components. Finally, apt-get install is used to install junior-gnome and junior-kde. These are extra components not present in the core Junior task.

Using list-junior

This is not really an installation option in and of itself. We have provided an example script in junior-doc to generate a list of installed and available Debian Jr. components as an HTML page. This list can then be viewed with your preferred web browser to help explore Debian Jr. and decide which components you wish to install, using one of the above methods. The list contains links to packages.debian.org so you can browse the latest versions and see what they contain.

The list-junior.sh script needs two packages to be installed before it can be run, so first apt-get install grep-dctrl wdiff. Then, in a directory where you want the HTML page to be generated, type: sh /usr/share/doc/junior-doc/examples/list-junior.sh

When the script completes, with any luck there will be a list-junior.html page in the current directory which you can browse with your favourite web browser.

Caveat user: This script is really a quick-and-dirty kludge and needs to be redone more robustly, so if it doesn't work for you, please be patient, we will make it into a proper program, complete with arguments, switches, man page and all those niceties in a future release.

What now?

So you have a successfully installed Debian Jr. system. What now? The sys admin will want to create children's accounts with adduser, and ensure that the window manager you have selected for them starts on their accounts by default.

Now, take a little tour of it yourself. Have a look at the window manager's menus. From here, you will be able to find virtually every program installed with Debian Jr. Try them out. Tailor the configurations to suit the children's needs. Once you are satisfied with the initial state of their accounts, have the children log in and start being their guide.

This is where our work leaves off and yours begins. There are many ways that Debian Jr. could be improved. There is a lot of grunt work in getting a system ready for any set of users with specific needs. Perhaps you will put some effort into this and would like to see your hard work benefit other Debian Jr. users. Please drop us a note on our mailing list, where users and developers discuss these issues together. Comments from your experience using Debian Jr. are valuable to us.

Can you help?

If you feel you have something to contribute to the Debian Jr. project, please visit our web site at to find out more about us, including how to contact us and join the development effort.

Problems Tasksel issues

If you are not able to see Debian Jr. in tasksel, it is probably because of a tasksel bug (). Run dselect and choose [U]pdate option to update dselect's package list. When it is finished, exit and run tasksel. All tasks should now appear, including Debian Jr.

Reporting bugs

Please see for instructions on reporting bugs. Filing well written bug reports is an important means of communication between users and developers. Your bug reports help to ensure the highest quality in our packages.

junior-doc-1.16.1/scripts/0000755000000000000000000000000007637405327012243 5ustar junior-doc-1.16.1/scripts/list-junior.sh0000755000000000000000000000336407637406327015070 0ustar # !/bin/sh # copyright- # Copyright (C) 2002 by Ben Armstrong # license- # This is software is licensed under the GNU Public License. # purpose- # Create a list of Debian Jr. packages, and their install status. # usage- # sh list-junior.sh # output- # ./list-junior.html # notes- # - This is an example script only. # - list-junior depends on: grep-dctrl, wdiff # - these are not declared as dependencies of junior-doc # because we wish to keep junior-doc architecture-independant # - TODO: look at making this a proper script with switches, # arguments, etc. set -e output_html=list-junior.html # No need to let people muck with our temporaries umask 077 dctrl_status=`mktemp /tmp/junior-doc-status.XXXXXX` dctrl_available=`mktemp /tmp/junior-doc-available.XXXXXX` dctrl_merged=`mktemp /tmp/junior-doc-merged.XXXXXX` umask 002 grep-status junior- >$dctrl_status; grep-available junior- >$dctrl_available; # Unspeakably ugly. see http://bugs.debian.org/136097 wdiff $dctrl_status $dctrl_available \ |sed -e's/\[-//; s/-\]//; s/{+//; s/+}//' \ |grep-dctrl -sPackage,Version,Status,Description 'junior-' >$dctrl_merged # Make a pretty web page. awk ' \ BEGIN { \ print "\n\nDebian Jr. Packages\n\n" \ "\nDebian Jr. Packages

\n" \ "\n
PackageVersionStatusDescription" \ } \ /^Package/ {print "
" $2 ""; next} \ /^(Status)/ {print "" $4; next} \ /^(Version|Description)/ {$1=""; print "" $0; next} \ END {print "

"} \ ' $dctrl_merged >$output_html # Be good and clean up our mess. rm $dctrl_available $dctrl_status $dctrl_merged