File: h4cc.1.xml

package info (click to toggle)
libhdf4 4.3.1-2
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 30,384 kB
  • sloc: ansic: 128,700; sh: 15,015; fortran: 12,444; java: 5,863; xml: 1,205; makefile: 794; yacc: 678; pascal: 418; perl: 360; javascript: 203; lex: 163; csh: 41
file content (146 lines) | stat: -rw-r--r-- 3,898 bytes parent folder | download | duplicates (6)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
<refentry id='h4cc'>

  <refmeta>
    <refentrytitle>h4cc</refentrytitle>
    <manvolnum>1</manvolnum>
  </refmeta>

  <refnamediv>
    <refname>h4cc</refname>
    <refpurpose>compiles an HDF4 C program</refpurpose>
  </refnamediv>

  <refsynopsisdiv id='synopsis'>
    <cmdsynopsis>
      <command>h4cc</command>
      <arg choice='opt'><replaceable>OPTIONS</replaceable></arg>
      <arg choice='plain'>&lt;<replaceable>compile line</replaceable>&gt;</arg>
    </cmdsynopsis>
  </refsynopsisdiv>

  <refsect1 id='description'>
    <title>DESCRIPTION</title>
    <para>
      <command>h4cc</command> compiles an HDF4 C program.
    </para>
  </refsect1>

  <refsect1 id='options'>
    <title>OPTIONS</title>
    <variablelist>

      <varlistentry>
        <term><option>-help</option></term>
        <listitem>
          <para>
            Display usage information
          </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><option>-echo</option></term>
        <listitem>
          <para>
            Show all the shell commands executed
          </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><option>-prefix</option>=<replaceable>DIR</replaceable></term>
        <listitem>
          <para>
            Prefix directory to find HDF4
            <filename class='directory'>lib/</filename> and
            <filename class='directory'>include/</filename> subdirectories
            [default: /usr]
          </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><option>-show</option></term>
        <listitem>
          <para>
            Show the commands without executing them
          </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><option>-shlib</option></term>
        <listitem>
          <para>
            Compile with shared HDF4 libraries
            [default for hdf4 built without static libraries]
          </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><option>-noshlib</option></term>
        <listitem>
          <para>
            Compile with static HDF4 libraries
            [default for hdf4 built with static libraries]
          </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>&lt;<replaceable>compile line</replaceable>&gt;</term>
        <listitem>
          <para>
            the normal compile line options for your compiler.
            <command>h4cc</command> uses the same compiler you used to compile
            HDF4.
            Check with your compiler's man pages for more information on
            which options are needed.
          </para>
        </listitem>
      </varlistentry>

    </variablelist>
    <para>
      You can override the compiler, linker, and whether or not to use static
      or shared libraries to compile your program by setting the following
      environment variables accordingly:
      <variablelist>

        <varlistentry>
          <term>HDF4_CC</term>
          <listitem>
            <para>
              use a different C compiler
            </para>
          </listitem>
        </varlistentry>

        <varlistentry>
          <term>HDF4_CLINKER</term>
          <listitem>
            <para>
              use a different linker
            </para>
          </listitem>
        </varlistentry>

        <varlistentry>
          <term>HDF4_USE_SHLIB=[yes|no]</term>
          <listitem>
            <para>
              use shared or static version of the HDF4 library
              [default: no]
            </para>
          </listitem>
        </varlistentry>

      </variablelist>
    </para>

  </refsect1>

</refentry>