File: policy.html

package info (click to toggle)
java-common 0.14
links: PTS
area: main
in suites: woody
size: 256 kB
ctags: 12
sloc: xml: 348; makefile: 105
file content (284 lines) | stat: -rw-r--r-- 4,409 bytes
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML
><HEAD
><TITLE
>Policy</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
"><LINK
REL="HOME"
TITLE="PROPOSED Debian policy for Java"
HREF="index.html"><LINK
REL="PREVIOUS"
TITLE="Background"
HREF="background.html"><LINK
REL="NEXT"
TITLE="Java compilers"
HREF="policy-compiler.html"></HEAD
><BODY
CLASS="chapter"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>PROPOSED Debian policy for Java</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="background.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="policy-compiler.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="chapter"
><H1
><A
NAME="policy">Chapter 2. Policy</H1
><P
>&#13;      A package java-common is created, containing this policy and
      some basic tools.
    </P
><P
>&#13;      Virtual packages are created: <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>java-compiler</I
></SPAN
>, <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>java2-compiler</I
></SPAN
>,
      <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>java-virtual-machine</I
></SPAN
>, <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>java1-runtime</I
></SPAN
> and <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>java2-runtime</I
></SPAN
>.
    </P
><P
>&#13;      Packages written in Java are separated in two categories: programs
      and libraries. Programs are intended to be run by end-users. Libraries
      are intended to help programs to run and to be used by developers. 
      Both <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>must</I
></SPAN
> depend on <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>java-virtual-machine</I
></SPAN
>.
    </P
><P
>&#13;      Both are shipped as Java bytecode (<TT
CLASS="filename"
>*.class</TT
>
      files, packaged in a <TT
CLASS="filename"
>*.jar</TT
> archive) and with
      an "Architecture: all" since Java bytecode is supposed to be portable.
    </P
><P
>&#13;      This policy does not yet address the issue of documentation (for instance
      HTML pages made with javadoc).
    </P
><DIV
CLASS="sect1"
><H1
CLASS="sect1"
><A
NAME="policy-vm">2.1. Virtual machines</H1
><P
>&#13;	Java virtual machines <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>must</I
></SPAN
> provide <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>java-virtual-machine</I
></SPAN
> and
	depend on java-common. They can also provide the runtime environment
	that the package contains (<SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>java1-runtime</I
></SPAN
> and/or <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>java2-runtime</I
></SPAN
>). If it does not
	provide the files itself it <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>must</I
></SPAN
> depend on the needed runtime
	environment.
      </P
><P
>&#13;	I <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>should</I
></SPAN
> use <TT
CLASS="filename"
>/etc/alternatives</TT
>
	for the name 'java' if they are command-line compatible with the
	Sun's java program.
      </P
><P
>&#13;	They <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>should</I
></SPAN
> have a CLASSPATH predefined which include the needed
	runtime environment.
      </P
><P
>&#13;	If a given source (like the JDK does) brings both a compiler and a
	virtual machine, you <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>may</I
></SPAN
> name the compiler package xxxx-dev.
      </P
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="background.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
ACCESSKEY="H"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="policy-compiler.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>Background</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
>&nbsp;</TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>Java compilers</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>