elementary-dev-community team mailing list archive

[Fabian Thoma <fabian@xxxxxxxxxxxxxxxx>]

Hey David,

I personally like option 2 more as it more clearly indicates the comment in
each line and as a bonus, follows the same style as valadoc annotations.
I've been also doing comments like that for quite some time now if they are
multiline. I'm however not opposed to using the top style.
Am 13.06.2012 23:57 schrieb "David Gomes" <david@xxxxxxxxxxxxxxxx>:

> */***
>   Copyright (C) 2011-2012 Your Name <your_email@xxxxxxxx>
>   This program is free software: you can redistribute it and/or modify it
>  under the terms of the GNU Lesser General Public License version 3, as
> published
>   by the Free Software Foundation.
>
>   This program is distributed in the hope that it will be useful, but
>  WITHOUT ANY WARRANTY; without even the implied warranties of
>   MERCHANTABILITY, SATISFACTORY QUALITY, or FITNESS FOR A PARTICULAR
>  PURPOSE.  See the GNU General Public License for more details.
>
>  You should have received a copy of the GNU General Public License along
>   with this program.  If not, see <http://www.gnu.org/licenses/>
> ***/*
> *
> *
> *VS*
> *
> *
>
> /* Copyright 2011-2012 elementary
>  *
>  * This file is part of the elementary GTK theme.
>  *
>  * The elementary GTK theme is free software: you can redistribute it
>  * and/or modify it under the terms of the GNU General Public License as
>  * published by the Free Software Foundation, either version 3 of the
>  * License, or (at your option) any later version.
>  *
>  * The elementary GTK theme is distributed in the hope that it will be
>  * useful, but WITHOUT ANY WARRANTY; without even the implied warranty of
>  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General
>  * Public License for more details.
>  *
>  * You should have received a copy of the GNU General Public License along
>  * with the elementary GTK theme. If not, see http:*www.gnu.org/licenses/.
>  */
>
>
> Anybody prefers the first one over the second one? Please reply with personal opinion.
>
>
> Thank you!
>
>
> --
> Mailing list: https://launchpad.net/~elementary-dev-community
> Post to     : elementary-dev-community@xxxxxxxxxxxxxxxxxxx
> Unsubscribe : https://launchpad.net/~elementary-dev-community
> More help   : https://help.launchpad.net/ListHelp
>
>