From owner-svn-doc-head@freebsd.org Sun Sep 27 22:49:58 2015 Return-Path: Delivered-To: svn-doc-head@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id 8999EA0B523; Sun, 27 Sep 2015 22:49:58 +0000 (UTC) (envelope-from bcr@FreeBSD.org) Received: from repo.freebsd.org (repo.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 78C13319; Sun, 27 Sep 2015 22:49:58 +0000 (UTC) (envelope-from bcr@FreeBSD.org) Received: from repo.freebsd.org ([127.0.1.70]) by repo.freebsd.org (8.15.2/8.15.2) with ESMTP id t8RMnwAx023607; Sun, 27 Sep 2015 22:49:58 GMT (envelope-from bcr@FreeBSD.org) Received: (from bcr@localhost) by repo.freebsd.org (8.15.2/8.15.2/Submit) id t8RMnwO7023606; Sun, 27 Sep 2015 22:49:58 GMT (envelope-from bcr@FreeBSD.org) Message-Id: <201509272249.t8RMnwO7023606@repo.freebsd.org> X-Authentication-Warning: repo.freebsd.org: bcr set sender to bcr@FreeBSD.org using -f From: Benedict Reuschling Date: Sun, 27 Sep 2015 22:49:58 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r47449 - head/en_US.ISO8859-1/htdocs/projects X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-head@freebsd.org X-Mailman-Version: 2.1.20 Precedence: list List-Id: SVN commit messages for the doc tree for head List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 27 Sep 2015 22:49:58 -0000 Author: bcr Date: Sun Sep 27 22:49:57 2015 New Revision: 47449 URL: https://svnweb.freebsd.org/changeset/doc/47449 Log: Whitespace fixes. Sponsored by: EuroBSDcon DevSummit Modified: head/en_US.ISO8859-1/htdocs/projects/newbies.xml Modified: head/en_US.ISO8859-1/htdocs/projects/newbies.xml ============================================================================== --- head/en_US.ISO8859-1/htdocs/projects/newbies.xml Sun Sep 27 22:37:24 2015 (r47448) +++ head/en_US.ISO8859-1/htdocs/projects/newbies.xml Sun Sep 27 22:49:57 2015 (r47449) @@ -15,16 +15,17 @@ -

The following resources are some of those which &os; - newbies have found most helpful when learning to use &os;. - Please send corrections and additions to - FreeBSD-doc@FreeBSD.org.

+

The following resources are some of those which &os; newbies + have found most helpful when learning to use &os;. Please send + corrections and additions to FreeBSD-doc@FreeBSD.org.

@@ -32,84 +33,93 @@

Using the &os; web site

-

This web site is the main source of up to date information about - &os;. Newbies have found the following pages particularly helpful:

- -
    -
  • Search the Handbook and FAQ, the - whole web site, or the &os; mailing list archives.

  • - -
  • The Documentation page has links to the - Handbook and FAQ, tutorials, information about contributing to the - Documentation Project, documents in languages other than English, - online manual pages, and much more.

  • - -
  • The Support page contains a wealth of - information about &os;, including mailing lists, user groups, web - and FTP sites, release information, and links to some sources of - &unix; information.

  • +

    This web site is the main source of up to date information + about &os;. Newbies have found the following pages particularly + helpful:

    + +
      +
    • Search the + Handbook and FAQ, the whole web site, or the &os; mailing list + archives.

    • + +
    • The Documentation page has + links to the Handbook and FAQ, tutorials, information about + contributing to the Documentation Project, documents in + languages other than English, online manual pages, and much + more.

    • + +
    • The Support page + contains a wealth of information about &os;, including mailing + lists, user groups, web and FTP sites, release information, + and links to some sources of &unix; information.

    Learning about &os;

      -
    • You should most probably look for the - latest mainstream release. - (See the Handbook for why you should not be tempted - by any of the other branches.) Before you begin, carefully read the - installation instructions, - as well as each one of the *.TXT files in the FTP directory - or on the installation CD. They are there because they contain information - that you will need. Also pick up the latest - errata file - from the web site, in case it has been updated.

    • - -
    • A number of short - articles and tutorials are available. The short tutorial, - For - People New to Both &os; and Unix, is popular with absolute - beginners. You do not have to know much about anything to enjoy - this one.

    • - -
    • There is a lot of documentation to help for setting up ppp. - You might start with the PPP and SLIP - chapter of the &os; Handbook and explore the - ppp page - for links to the other valuable information and the latest updates.

    • - -
    • The &os; Handbook and Frequently Asked Questions (FAQ) are the - main documents for &os;. Essential reading, they contain a lot of - material for newbies as well as some pretty advanced stuff. Do not - worry if you are unable to understand the advanced sections. The handbook - contains the installation instructions and also provides lists of - books and on-line resources, and the FAQ has a troubleshooting - section.

    • - -
    • Join the &os;-Questions mailing list to see the questions you - were too afraid to ask, and their answers. Subscribe by filling out - the following form: - http://lists.FreeBSD.org/mailman/listinfo/freebsd-questions. - You can look up old questions and - answers via the search - page.

    • +
    • You should most probably look for the latest mainstream release. (See + the Handbook for why you should not be + tempted by any of the other branches.) Before you begin, + carefully read the installation + instructions, as well as each one of the *.TXT files in + the FTP directory or on the installation CD. They are there + because they contain information that you will need. Also pick + up the latest errata + file from the web site, in case it has been + updated.

    • + +
    • A number of short articles and + tutorials are available. The short tutorial, For People New to + Both &os; and Unix, is popular with absolute beginners. + You do not have to know much about anything to enjoy this + one.

    • + +
    • There is a lot of documentation to help for setting up + ppp. You might start with the PPP and + SLIP chapter of the &os; Handbook and explore the ppp page for + links to the other valuable information and the latest + updates.

    • + +
    • The &os; + Handbook and Frequently Asked Questions + (FAQ) are the main documents for &os;. Essential reading, + they contain a lot of material for newbies as well as some + pretty advanced stuff. Do not worry if you are unable to + understand the advanced sections. The handbook contains the + installation instructions and also provides lists of books and + on-line resources, and the FAQ has a troubleshooting + section.

    • + +
    • Join the &os;-Questions mailing list to see the questions + you were too afraid to ask, and their answers. Subscribe by + filling out the following form: http://lists.FreeBSD.org/mailman/listinfo/freebsd-questions. + You can look up old questions and answers via the search + page.

    • The main newsgroup for &os; is comp.unix.bsd.freebsd.misc. - General UNIX questions are dealt with in the newsgroup comp.unix.questions and the - associated FAQ - from the RMIT FTP site. Newbies are likely to be most - interested in sections 1 and 2 initially.

    • - -
    • Manual pages are good - for reference but not always - the best introduction for a novice. The more you work with man pages - the more familiar they become. Some are very good for newbies, so - always check them out. The ppp man page, for example, is more like a - tutorial.

    • + href="news:comp.unix.bsd.freebsd.misc">comp.unix.bsd.freebsd.misc. + General UNIX questions are dealt with in the newsgroup comp.unix.questions and + the associated FAQ + from the RMIT FTP site. Newbies are likely to be most + interested in sections 1 and 2 initially.

      + +
    • Manual pages are good for + reference but not always the best introduction for a novice. + The more you work with man pages the more familiar they + become. Some are very good for newbies, so always check them + out. The ppp man page, for example, is more like a + tutorial.

    Learning about &os;-derived projects

    @@ -120,68 +130,69 @@
    • PC-BSD is a &os; - derivative with a graphical installer and impressive desktop - tools aimed at ease of use for the casual computer - user.

    • + derivative with a graphical installer and impressive desktop + tools aimed at ease of use for the casual computer + user.

    • Apple's Mac OS - X - is based - in part on &os; and includes a rich &unix; foundation in - addition to the proprietary Apple user interface.

    • + X is based + in part on &os; and includes a rich &unix; foundation in + addition to the proprietary Apple user interface.

    Learning about &unix;

    -

    Many of the problems we have as newbies come from being unfamiliar - with the UNIX commands, needed to fix our &os; problems. - Without a UNIX background you will be faced with two things to learn - at once. Fortunately a lot of resources are available to make this - easier.

    +

    Many of the problems we have as newbies come from being + unfamiliar with the UNIX commands, needed to fix our &os; + problems. Without a UNIX background you will be faced with two + things to learn at once. Fortunately a lot of resources are + available to make this easier.

    • The &unix; - Basics chapter of the &os; Handbook covers the basic - commands and functionality of &os; operating system. Most - of the information provided in this document is also relevant for - any other &unix;-like operating system.

    • - -
    • There are many easy books, such as the "Dummies" guides, in any - large book shop. If you want something really easy, take a look at - what is available and pick one that seems to speak your language. - Pretty soon you will want to move on to a book that gives more - coverage.

    • - -
    • Another popular book is UNIX Power Tools by Jerry Peek, - Tim O'Reilly and Mike Loukides, published by O'Reilly and - Associates. It is organized as a series of short articles each of - which solves a problem, and these articles are cross-referenced to - other articles with related material. Though not specifically aimed - at newbies, the design makes it ideal for a newbie with a burning - question or the odd few minutes to browse. More elementary material - is near the front of the book, but there are short easy articles - throughout.

    • - -
    • -

      A UNIX - Introductory Course from Ohio State University is - available online in HTML format.

      + Basics chapter of the &os; Handbook covers the basic + commands and functionality of &os; operating system. Most of + the information provided in this document is also relevant for + any other &unix;-like operating system.

    • + +
    • There are many easy books, such as the "Dummies" guides, + in any large book shop. If you want something really easy, + take a look at what is available and pick one that seems to + speak your language. Pretty soon you will want to move on to + a book that gives more coverage.

    • + +
    • Another popular book is UNIX Power Tools by + Jerry Peek, Tim O'Reilly and Mike Loukides, published by + O'Reilly and Associates. It is organized as a series of short + articles each of which solves a problem, and these articles + are cross-referenced to other articles with related material. + Though not specifically aimed at newbies, the design makes it + ideal for a newbie with a burning question or the odd few + minutes to browse. More elementary material is near the front + of the book, but there are short easy articles + throughout.

    • + +
    • A UNIX + Introductory Course from Ohio State University is + available online in HTML format.

    • -
    • -

      A UNIX - System Administration Course from Ohio State University - is available online in HTML format.

      +
    • A UNIX + System Administration Course from Ohio State University is + available online in HTML format.

    • UNIXhelp - for Users is another introductory guide which is available in - HTML at a mirror site near you, or can be installed on your own - system.

    • - -
    • Many other web sites hold lists of UNIX tutorials and reference - material. One of the best places to start looking is the - little known search engine is another introductory guide which is available + in HTML at a mirror site near you, or can be installed on your + own system.

    • + +
    • Many other web sites hold lists of UNIX tutorials and + reference material. One of the best places to start looking is + the little known search engine Google.

    @@ -189,48 +200,47 @@

    Learning about the X Window System

    The X Window System is used with a number of operating systems, - including &os;. The documentation for X can be found at the - X.Org Foundation - web site. - Beware, much of this documentation is reference material which is - more likely to be difficult for newcomers to digest.

    - -
      -
    • Before you can get X running exactly the way you like, you will need - to choose a window manager. - Visit the Window Managers for X - page and follow the link to the introduction to find out about window - managers, then return and read "The Basics". Then go back and compare - the different types that are available. (Bonus: there is another - beginners guide to UNIX there too.) - Most, if not all, of these window managers are available to - install from the &os; Ports Collection.

    • + including &os;. The documentation for X can be found at the X.Org Foundation web site. + Beware, much of this documentation is reference material which + is more likely to be difficult for newcomers to digest.

      + +
        +
      • Before you can get X running exactly the way you like, you + will need to choose a window manager. Visit the Window Managers for X page and + follow the link to the introduction to find out about window + managers, then return and read "The Basics". Then go back and + compare the different types that are available. (Bonus: there is + another beginners guide to UNIX there too.) Most, if not all, of + these window managers are available to install from the &os; + Ports Collection.

      Helping other people

      -

      Everyone has something to contribute to the &os; community, even - newbies! Some are busy working with the new advocacy group and some have - become involved with the - Documentation Project as reviewers. - Other &os; newbies might have particular skills and experiences to - share, either computer related or not, or just want to meet new - newbies and make them feel welcome. There are always people around - who help others simply because they like to.

      +

      Everyone has something to contribute to the &os; community, + even newbies! Some are busy working with the new advocacy group + and some have become involved with the Documentation Project as + reviewers. Other &os; newbies might have particular skills and + experiences to share, either computer related or not, or just + want to meet new newbies and make them feel welcome. There are + always people around who help others simply because they like + to.

      Friends who run &os; are a great resource. No book can replace chatting on the phone or across a pizza with someone who has the - same interests, enjoys similar accomplishments, and faces the same - challenges. If you do not have many friends who use &os;, + same interests, enjoys similar accomplishments, and faces the + same challenges. If you do not have many friends who use &os;, consider using your old &os; CDs to create some more.

      -

      User groups are - good places to meet other &os; users. If there is no one nearby, - you might consider starting one!

      +

      User groups are good + places to meet other &os; users. If there is no one nearby, you + might consider starting one!

      Before talking to real humans about your new skills, you might - want to check the Jargon File.

      - + want to check the Jargon + File.