]> diplodocus.org Git - nmh/blobdiff - h/addrsbr.h
Use pref_encoding() to select the default encoding for all headers.
[nmh] / h / addrsbr.h
index a753e6239fbd6049cefa340a4e4e8cbc67614609..fbb4cd055872ed380c435c5bf44b1f803756816e 100644 (file)
@@ -32,6 +32,10 @@ struct mailname {
     char *m_note;              /* Note (post-address comment) */
 };
 
     char *m_note;              /* Note (post-address comment) */
 };
 
+/*
+ * See notes for auxformat() below.
+ */
+
 #define        adrformat(m) auxformat ((m), 1)
 
 /*
 #define        adrformat(m) auxformat ((m), 1)
 
 /*
@@ -57,8 +61,24 @@ int ismymbox(struct mailname *);
  */
 
 char *getname(const char *header);
  */
 
 char *getname(const char *header);
-char *getlocaladdr(void);
-char *auxformat(struct mailname *, int);
+
+/*
+ * Format an email address given a struct mailname.
+ *
+ * This function takes a pointer to a struct mailname and returns a pointer
+ * to a static buffer holding the resulting email address.
+ *
+ * It is worth noting that group names are NOT handled, so if you want to
+ * do something with groups you need to handle it externally to this function.
+ *
+ * Arguments include:
+ *
+ * mp          - Pointer to mailname structure
+ * extras      - If true, include the personal name and/or note in the
+ *               address.  Otherwise, omit it.
+ */
+
+char *auxformat(struct mailname *mp, int extras);
 
 /*
  * Parse an email address into it's components.
 
 /*
  * Parse an email address into it's components.