From: Richard Stallman <rms@gnu.org>
To: joakim@verona.se
Cc: emacs-devel@gnu.org
Subject: Re: SVG support(again) ?
Date: Sat, 18 Aug 2007 20:45:13 -0400 [thread overview]
Message-ID: <E1IMYun-0005Ct-R5@fencepost.gnu.org> (raw)
In-Reply-To: <m3r6m1cbie.fsf@kurono.home> (joakim@verona.se)
You're getting closer. There are enough comments now,
but they need to be formatted cleanly and consistently with the
rest of Emacs.
/* DEF_IMGLIB_FN() here in the future.
Do you mean
/* TO DO: use DEF_IMGLIB_FN here.
It is vital to use words like "TO DO:" and "use",
because following such patterns makes the meaning clear.
(In GNU we don't write `()' after a function name.)
Aside from that, it will be clean if you fill the comment lines
to 70 character width.
Also, please use two spaces at the end of a sentence,
and please put a period and two spaces at the end of every comment
that contents sentences.
/* Load SVG image IMG for use on frame F. Value is non-zero if
successful. this function wil go into the svg_type structure, and
the prototype thus needs to be compatible with that structure */
should be
/* Load SVG image IMG for use on frame F. Value is non-zero if
successful. This function will go into the svg_type structure, and
the prototype, so it needs to be compatible with that structure. */
contents = slurp_file (SDATA (file), &size); /* read the entire file into memory*/
That style makes lines wide and hard to read, so please put the comment
on a separate line. It should start with a capital letter, and end
with a period and two spaces.
/* Read the entire file into memory. */
contents = slurp_file (SDATA (file), &size);
/* helper function for svg_load, does the actual loading
given contents and size, apart from frame and image structures, passed from svg_load
Uses librsvg to do most of the image processing.
Returns non-zero when sucessful
*/
This should explain each of the arguments by name.
Please also start it with a capital letter, and end it with a period,
and avoid lines that are too long.
next prev parent reply other threads:[~2007-08-19 0:45 UTC|newest]
Thread overview: 106+ messages / expand[flat|nested] mbox.gz Atom feed top
2007-08-08 23:56 SVG support(again) ? joakim
2007-08-09 21:17 ` joakim
2007-08-09 21:36 ` David Kastrup
2007-08-09 21:45 ` Jason Rumney
2007-08-09 21:58 ` joakim
2007-08-09 21:48 ` joakim
2007-08-11 5:05 ` Richard Stallman
2007-08-14 11:57 ` joakim
2007-08-14 23:26 ` Richard Stallman
2007-08-15 7:11 ` Mathias Dahl
2007-08-16 9:03 ` joakim
2007-08-17 0:32 ` Richard Stallman
2007-08-18 11:44 ` joakim
2007-08-19 0:45 ` Richard Stallman [this message]
2007-08-19 12:35 ` joakim
2007-08-19 22:30 ` Richard Stallman
2007-08-20 9:31 ` joakim
2007-08-21 14:45 ` Richard Stallman
2007-08-21 14:59 ` joakim
2007-08-22 4:12 ` Glenn Morris
2007-08-22 7:23 ` joakim
2007-08-29 16:27 ` svn icons in the toolbar (was: SVG support(again) ?) Leo
2007-08-30 5:08 ` svn icons in the toolbar Jan Djärv
2007-08-30 20:44 ` Leo
2007-08-31 5:59 ` Jan Djärv
2007-08-31 7:07 ` Benjamin Hawkes-Lewis
2007-09-01 13:57 ` Leo
2007-08-30 20:50 ` Richard Stallman
2007-09-02 0:33 ` Leo
2007-09-03 3:04 ` Richard Stallman
2007-09-03 6:26 ` Jan Djärv
2007-09-04 0:56 ` Richard Stallman
2007-09-03 7:08 ` Benjamin Hawkes-Lewis
2007-09-03 7:53 ` joakim
2007-09-03 7:55 ` Leo
2007-09-03 17:38 ` David Reitter
2007-09-04 0:56 ` Richard Stallman
2007-09-04 4:01 ` tomas
2007-09-04 22:57 ` Richard Stallman
2007-09-05 3:31 ` tomas
2007-09-04 4:54 ` YAMAMOTO Mitsuharu
2007-09-04 6:06 ` David Kastrup
2007-09-04 22:57 ` Richard Stallman
2007-09-05 0:20 ` YAMAMOTO Mitsuharu
2007-09-05 20:02 ` Richard Stallman
2007-09-05 20:40 ` Chong Yidong
2007-09-05 22:54 ` Leo
2007-09-06 6:02 ` Jan Djärv
2007-09-06 6:00 ` Jan Djärv
2007-09-07 6:32 ` Richard Stallman
2007-09-07 7:04 ` Leo
2007-09-07 8:12 ` Jan Djärv
2007-09-07 10:22 ` Leo
2007-09-08 7:01 ` Richard Stallman
2007-09-07 7:10 ` Jan Djärv
2007-09-08 7:00 ` Richard Stallman
2007-09-03 7:54 ` Leo
2007-09-02 4:32 ` Leo
2007-09-02 8:07 ` Benjamin Hawkes-Lewis
2007-09-02 9:04 ` Jan Djärv
2007-09-02 8:23 ` Jan Djärv
2007-09-02 9:06 ` Leo
2007-09-02 13:29 ` Jan Djärv
2007-09-02 13:52 ` Leo
2007-09-02 14:04 ` Redundant icon in tool-bar (was: svn icons in the toolbar) Leo
2007-09-02 15:39 ` Redundant icon in tool-bar Jan Djärv
2007-09-02 16:00 ` Leo
2007-09-02 14:09 ` svn icons in the toolbar Leo
2007-09-02 15:43 ` Jan Djärv
2007-09-02 16:00 ` Leo
2007-09-02 17:28 ` Jan Djärv
2007-09-05 23:53 ` Leo
2007-09-26 20:11 ` gmm-tool-bar-style (was: svn icons in the toolbar) Reiner Steib
2007-09-02 17:46 ` svn icons in the toolbar Jan Djärv
2007-09-02 17:58 ` Leo
2007-09-21 10:24 ` Leo
2007-09-21 11:13 ` Jan Djärv
2007-09-21 11:17 ` Leo
2007-09-21 12:08 ` Jan Djärv
2007-09-21 12:45 ` Leo
2007-09-21 13:08 ` Jan Djärv
2007-09-21 14:18 ` Leo
2007-09-21 15:14 ` Jan Djärv
2007-09-21 16:03 ` Leo
2007-09-18 21:55 ` Stephen Berman
2007-09-19 6:26 ` Jan Djärv
2007-09-19 9:10 ` Stephen Berman
2007-09-19 9:20 ` Stephen Berman
2007-09-19 9:54 ` Leo
2007-09-19 10:08 ` Jan Djärv
2007-09-19 10:40 ` Stephen Berman
2007-09-19 10:02 ` Jan Djärv
2007-09-19 10:41 ` Stephen Berman
2007-09-20 16:35 ` Richard Stallman
2007-09-24 15:56 ` Stephen Berman
2007-09-25 10:44 ` Richard Stallman
2007-09-25 11:43 ` Frank Schmitt
2007-09-25 13:54 ` Stephen Berman
2007-09-26 6:17 ` Jan Djärv
2007-09-26 16:29 ` Richard Stallman
2007-09-26 16:43 ` Dan Nicolaescu
2007-09-19 21:22 ` Stephen Berman
2007-09-20 6:24 ` Jan Djärv
2007-09-24 15:56 ` Stephen Berman
2007-09-24 16:04 ` Jan Djärv
2007-11-04 13:24 ` Stephen Berman
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=E1IMYun-0005Ct-R5@fencepost.gnu.org \
--to=rms@gnu.org \
--cc=emacs-devel@gnu.org \
--cc=joakim@verona.se \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this external index
https://git.savannah.gnu.org/cgit/emacs.git
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.