update code doc

Author: rjbou

src/client/opamArg.mli

@@ -114,7 +114,7 @@ val build_option_section: string
 (** Build options *)
 val build_options: build_options Term.t
 
-(** Instal and reinstall options *)
+(** Install and reinstall options *)
 val assume_built: bool Term.t
 
 (** Applly build options *)

src/format/opamFile.ml

@@ -186,9 +186,9 @@ end
 
 (** I - Raw text files (no parsing) *)
 
-(** Compiler and package description files
-    (<repo>/packages/.../descr, <repo>/compilers/.../<v>.descr):
-    one-line title and content *)
+(** Compiler and package description opam file fields: one-line title and
+    content. Formerly, (<repo>/packages/.../descr,
+    <repo>/compilers/.../<v>.descr) *)
 
 module DescrIO = struct
 
@@ -1849,7 +1849,8 @@ module Repo = struct
 end
 
 
-(** Package url files (<repo>/packages/.../url) *)
+(** Package url field in opam file. Formerly, file
+    (<repo>/packages/.../url) *)
 
 module URLSyntax = struct
 

src/state/opamSwitchState.mli

@@ -77,16 +77,16 @@ val opam: 'a switch_state -> package -> OpamFile.OPAM.t
     any *)
 val opam_opt: 'a switch_state -> package -> OpamFile.OPAM.t option
 
-(** Return the URL file for the given package *)
+(** Return the URL field for the given package *)
 val url: 'a switch_state -> package -> OpamFile.URL.t option
 
-(** Returns the primary URL from the URL file of the given package *)
+(** Returns the primary URL from the URL field of the given package *)
 val primary_url: 'a switch_state -> package -> url option
 
-(** Return the Descr file for the given package (or an empty descr if none) *)
+(** Return the descr field for the given package (or an empty descr if none) *)
 val descr: 'a switch_state -> package -> OpamFile.Descr.t
 
-(** Return the Descr file for the given package *)
+(** Return the descr field for the given package *)
 val descr_opt: 'a switch_state -> package -> OpamFile.Descr.t option
 
 (** Returns the full paths of overlay files under the files/ directory *)