From nobody@FreeBSD.org  Tue Oct  9 02:25:56 2007
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id B8FCF16A419
	for <freebsd-gnats-submit@FreeBSD.org>; Tue,  9 Oct 2007 02:25:56 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (www.freebsd.org [IPv6:2001:4f8:fff6::21])
	by mx1.freebsd.org (Postfix) with ESMTP id 9F41B13C4A8
	for <freebsd-gnats-submit@FreeBSD.org>; Tue,  9 Oct 2007 02:25:56 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (localhost [127.0.0.1])
	by www.freebsd.org (8.14.1/8.14.1) with ESMTP id l992Pudc085228
	for <freebsd-gnats-submit@FreeBSD.org>; Tue, 9 Oct 2007 02:25:56 GMT
	(envelope-from nobody@www.freebsd.org)
Received: (from nobody@localhost)
	by www.freebsd.org (8.14.1/8.14.1/Submit) id l992Puw9085227;
	Tue, 9 Oct 2007 02:25:56 GMT
	(envelope-from nobody)
Message-Id: <200710090225.l992Puw9085227@www.freebsd.org>
Date: Tue, 9 Oct 2007 02:25:56 GMT
From: Chess Griffin <chess.griffin@gmail.com>
To: freebsd-gnats-submit@FreeBSD.org
Subject: [patch] to handbook for info on vidcontrol and console video modes
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         117035
>Category:       docs
>Synopsis:       [patch] to handbook for info on vidcontrol and console video modes
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Tue Oct 09 02:30:01 GMT 2007
>Closed-Date:    Sat Dec 08 19:47:10 UTC 2007
>Last-Modified:  Sat Dec  8 19:50:01 UTC 2007
>Originator:     Chess Griffin
>Release:        7.0-CURRENT
>Organization:
>Environment:
FreeBSD bsdbob.localdomain 7.0-CURRENT FreeBSD 7.0-CURRENT #0: Sat Oct  6 10:19:22 EDT 2007     root@bsdbob.localdomain:/usr/obj/usr/src/sys/CNG  i386

>Description:
The following patch adds some brief information to /home/chess/doc/en_US.ISO8859-1/books/handbook/basics/chapter.sgml concerning the default video console mode and how to change it.

If patch does not print cleanly in this form, I can resend as an attachment.



--- chapter.sgml.orig	2007-09-14 19:56:21.000000000 -0400
+++ chapter.sgml	2007-10-08 22:21:36.000000000 -0400
@@ -200,13 +200,13 @@
 
       <para>Special key combinations have been reserved by FreeBSD for
 	switching consoles<footnote>
-	  <para>A fairly technical and accurate description of all the details
-	    of the FreeBSD console and keyboard drivers can be found in the
-	    manual pages of &man.syscons.4;, &man.atkbd.4;, &man.vidcontrol.1;
-	    and &man.kbdcontrol.1;.  We will not expand on the details here,
-	    but the interested reader can always consult the manual pages for
-	    a more detailed and thorough explanation of how things
-	    work.</para>
+	  <para>A fairly technical and accurate description of all the
+	    details of the FreeBSD console and keyboard drivers can be
+	    found in the manual pages of &man.syscons.4;,
+	    &man.atkbd.4;, and &man.kbdcontrol.1;.  We will not expand
+	    on the details here, but the interested reader can always
+	    consult the manual pages for a more detailed and thorough
+	    explanation of how things work.</para>
 	</footnote>.  You can use
 	<keycombo><keycap>Alt</keycap><keycap>F1</keycap></keycombo>,
 	<keycombo><keycap>Alt</keycap><keycap>F2</keycap></keycombo>, through
@@ -290,6 +290,42 @@
 	  booting process and the programs involved.</para>
       </note>
     </sect2>
+
+    <sect2 id="consoles-vidcontrol">
+      <title>Changing Console Video Modes</title>
+
+      <para>The FreeBSD console default video mode may be adjusted to
+	1024x768, 1280x1024, or any other size supported by your
+	graphics chip and monitor.  To use a different video mode, you
+	first must recompile your kernel and include two additional 
+	options:</para>
+
+      <programlisting>OPTIONS VESA
+OPTIONS SC_PIXEL_MODE</programlisting>
+	
+      <para>Once the kernel has been recompiled with these two
+	options, you can then determine what video modes are supported
+	by your hardware by using the &man.vidcontrol.1; utility.  To
+	get a list of supported video modes, type the following in a
+	root console:</para>
+      
+      <screen>&prompt.root; <userinput>vidcontrol -i mode</userinput></screen>
+      
+      <para>The output of this command is a list of video modes that
+	are supported by your hardware.  You can then choose to use a
+	new video mode by passing it to vidcontrol in a root console,
+	as in this example:</para>
+      
+      <screen>&prompt.root; <userinput>vidcontrol MODE_279</userinput></screen>
+      
+      <para>If the new video mode is acceptable, it can be permanently
+	set on boot by including the following in your
+	<filename>/etc/rc.conf</filename> file, again using the above
+	example:</para>
+      
+      <programlisting>allscreens_flags="MODE_279"</programlisting>
+
+    </sect2>
   </sect1>
 
   <sect1 id="permissions">
>How-To-Repeat:

>Fix:


>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->closed 
State-Changed-By: remko 
State-Changed-When: Sat Dec 8 19:47:09 UTC 2007 
State-Changed-Why:  
I added the text to the basics chapter in the handbook, thanks for the 
submission! 

http://www.freebsd.org/cgi/query-pr.cgi?pr=117035 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/117035: commit references a PR
Date: Sat,  8 Dec 2007 19:46:20 +0000 (UTC)

 remko       2007-12-08 19:46:16 UTC
 
   FreeBSD doc repository
 
   Modified files:
     en_US.ISO8859-1/books/handbook/basics chapter.sgml 
   Log:
   Add information on how to change the console video modes.
   
   Translators: this is an addition to the current handbook, no other
   changes had been made in the chapter.
   
   PR:             docs/117035
   Submitted by:   Chess Griffin <chess dot griffin at gmail dot com>
   
   Revision  Changes    Path
   1.150     +35 -0     doc/en_US.ISO8859-1/books/handbook/basics/chapter.sgml
 _______________________________________________
 cvs-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/cvs-all
 To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org"
 
>Unformatted:
