4d91bdd40718dc18ddc9fae26758d113d72ff578
[obnox/wireshark/wip.git] / docbook / release-notes.xml
1 <?xml version="1.0"?>
2 <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
3 "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
4
5 <!-- $Id$ -->
6
7 <!--
8 DOCUMENT SECTION
9 -Use this section to encode all document information
10 -->
11
12 <!--
13 Wireshark Info
14 -->
15   <!ENTITY WiresharkCurrentVersion "1.7.0">
16
17 ]>
18
19 <article>
20   <title>Wireshark &WiresharkCurrentVersion; Release Notes</title>
21
22   <section id="WhatIs"><title>What is Wireshark?</title>
23     <para>
24       Wireshark is the world's most popular network protocol analyzer.  It
25       is used for troubleshooting, analysis, development and education.
26     </para>
27   </section>
28
29   <section id="WhatsNew"><title>What's New</title>
30     <section id="BugFixes"><title>Bug Fixes</title>
31
32     <para>
33
34     The following bugs have been fixed:
35
36 <!--
37       <itemizedlist>
38
39         <listitem><para>
40           Wireshark is unresponsive when capturing from named pipes on Windows.
41           (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=1759">Bug
42           1759</ulink>)
43         </para></listitem>
44
45         <listitem><para>
46           Ring buffers are no longer turned on by default when using multiple
47           capture files.
48         </para></listitem>
49
50       </itemizedlist>
51 -->
52
53     </para>
54
55     </section>
56
57     <section id="NewFeatures"><title>New and Updated Features</title>
58     <para>
59       The following features are new (or have been significantly updated)
60       since version 1.6:
61
62       <itemizedlist>
63
64         <listitem>
65           <para>
66             Wireshark supports capturing from multiple interfaces at once.
67           </para>
68         </listitem>
69
70         <listitem>
71           <para>
72             Wireshark, TShark, and their associated utilities now save files
73             using the pcap-ng file format by default. (Your copy of Wireshark
74             might still use the pcap file format if pcap-ng is disabled in
75             your preferences.)
76           </para>
77         </listitem>
78
79         <listitem>
80           <para>
81             Decryption key management for IEEE 802.11, IPsec, and ISAKMP
82             is now easier.
83           </para>
84         </listitem>
85
86         <listitem>
87           <para>
88             OID resolution is now supported on 64-bit Windows.
89           </para>
90         </listitem>
91
92       </itemizedlist>
93
94     </para>
95     </section>
96
97     <section id="NewProtocols"><title>New Protocol Support</title>
98     <para>
99
100 <!-- Sorted, one per line -->
101
102     </para>
103     </section>
104
105     <section id="UpdatedProtocols"><title>Updated Protocol Support</title> <para>
106
107     </para>
108     </section>
109
110     <section id="NewCapture"><title>New and Updated Capture File Support</title>
111     <para>
112
113 <!-- Sorted, one per line -->
114
115     </para>
116     </section>
117
118   </section>
119
120   <section id="GettingWireshark"><title>Getting Wireshark</title>
121     <para>
122       Wireshark source code and installation packages are available from
123       <ulink url="http://www.wireshark.org/download.html">http://www.wireshark.org/download.html</ulink>.
124     </para>
125
126     <section id="VendorPackages"><title>Vendor-supplied Packages</title>
127       <para>
128         Most Linux and Unix vendors supply their own Wireshark packages.
129         You can usually install or upgrade Wireshark using the package management
130         system specific to that platform.  A list of third-party packages
131         can be found on the
132         <ulink url="http://www.wireshark.org/download.html#thirdparty">download page</ulink>
133         on the Wireshark web site.
134       </para>
135     </section>
136
137   </section>
138
139   <!-- XXX needs to be written
140   <section id="RemovingWireshark"><title>Removing Wireshark</title>
141     <para>
142     </para>
143   </section>
144   -->
145
146   <section id="FileLocations"><title>File Locations</title>
147     <para>
148       Wireshark and TShark look in several different locations for
149       preference files, plugins, SNMP MIBS, and RADIUS dictionaries.
150       These locations vary from platform to platform.  You can use
151       About→Folders to find the default locations on your system.
152     </para>
153   </section>
154
155   <section id="KnownProblems"><title>Known Problems</title>
156
157     <para>
158       Wireshark might make your system disassociate from a wireless network
159       on OS X 10.4.
160       (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=1315">Bug
161       1315</ulink>)
162     </para>
163
164     <para>
165       Dumpcap might not quit if Wireshark or TShark crashes.
166       (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=1419">Bug
167       1419</ulink>)
168     </para>
169
170     <para>
171       The BER dissector might infinitely loop.
172       (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=1516">Bug
173       1516</ulink>)
174     </para>
175
176     <para>
177       Capture filters aren't applied when capturing from named pipes.
178       (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=1814">Bug
179       1814</ulink>)
180     </para>
181
182     <para>
183       Filtering tshark captures with display filters (-R) no longer works.
184       (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=2234">Bug
185       2234</ulink>)
186     </para>
187
188     <para>
189       The 64-bit Windows installer does not ship with libsmi.
190       (<ulink url="http://wiki.wireshark.org/Development/Win64">Win64
191       development page</ulink>)
192     </para>
193
194     <para>
195       Application crash when changing real-time option.
196       (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=4035">Bug
197       4035</ulink>)
198     </para>
199
200     <para>
201       Hex pane display issue after startup.
202       (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=4056">Bug
203       4056</ulink>)
204     </para>
205
206     <para>
207       Packet list rows are oversized.
208       (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=4357">Bug
209       4357</ulink>)
210     </para>
211
212     <para>
213       Summary pane selected frame highlighting not maintained.
214       (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=4445">Bug
215       4445</ulink>)
216     </para>
217
218     <para>
219       Wireshark and TShark will display incorrect delta times in some cases.
220       (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=5356">Bug
221       4985</ulink>
222       and
223       <ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=5356">bug
224       5580</ulink>)
225     </para>
226
227     <para>
228       Character echo pauses in Capture Filter field in Capture Options.
229       (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=5356">Bug
230       5356</ulink>)
231     </para>
232
233   </section>
234
235   <section id="GettingHelp"><title>Getting Help</title>
236     <para>
237     Community support is available on
238     <ulink url="http://ask.wireshark.org/">Wireshark's Q&amp;A site</ulink>
239     and on the wireshark-users mailing list.
240     Subscription information and archives for all of Wireshark's mailing
241     lists can be found on <ulink url="http://www.wireshark.org/lists/">the
242     web site</ulink>.
243     </para>
244     <para>
245     Training is available from
246     <ulink url="http://www.wiresharktraining.com/">Wireshark University</ulink>.
247     </para>
248   </section>
249
250   <section id="FAQ"><title>Frequently Asked Questions</title>
251     <para>
252     A complete FAQ is available on the
253     <ulink url="http://www.wireshark.org/faq.html">Wireshark web site</ulink>.
254     </para>
255   </section>
256
257 </article>